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