Upgrade-DistributionGroup
此 cmdlet 仅在基于云的服务中可用。
使用 Upgrade-DistributionGroup cmdlet 将通讯组升级到 Microsoft 365 组。 此 cmdlet 仅适用于通讯组,不适用于已启用邮件的安全组。
注意:使用此 cmdlet 之前,请验证没有使用 IncludeUnifiedGroupRecipients 参数创建的电子邮件地址策略;否则,命令将失败。 将通讯组升级到 Microsoft 365 组 后,删除并重新创建电子邮件地址策略。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Upgrade-DistributionGroup
[-DlIdentities] <MultiValuedProperty>
[-ActionType <String>]
[-ExecutingUser <RecipientIdParameter>]
[-Organization <OrganizationIdParameter>]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Upgrade-DistributionGroup -DlIdentities hr@contoso.com,finance@contoso.com
此示例将指定的通讯组升级到Microsoft 365 组。
参数
-ActionType
适用:Exchange Online、Exchange Online Protection
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DlIdentities
适用:Exchange Online
DlIdentities 参数指定要升级到 Microsoft 365 组的通讯组的电子邮件地址。
可以指定用逗号分隔的多个值。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-ExecutingUser
适用:Exchange Online、Exchange Online Protection
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | RecipientIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Organization
适用:Exchange Online、Exchange Online Protection
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | OrganizationIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。