Get-EligibleDistributionGroupForMigration

此 cmdlet 仅在基于云的服务中有效。

使用 Get-EligibleDistributionGroupForMigration cmdlet 标识可升级到Microsoft 365 组的通讯组。 无法将启用邮件的安全组升级到Microsoft 365 组。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Identity

Get-EligibleDistributionGroupForMigration
    [[-Identity] <DistributionGroupIdParameter>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

ManagedBy

Get-EligibleDistributionGroupForMigration
    [-ManagedBy <GeneralRecipientIdParameter>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-EligibleDistributionGroupForMigration -ResultSize unlimited

此示例返回可升级到Microsoft 365 组的所有通讯组的摘要列表。

参数

-Identity

适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、Exchange Online Protection

Identity 参数按指定通讯组的电子邮件地址筛选结果。 如果未返回指定电子邮件地址的结果,则无法将组升级到 Microsoft 365 组。

不能将此参数与 ManagedBy 参数一起使用。

参数属性

类型:DistributionGroupIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

Identity
Position:1
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ManagedBy

适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、Exchange Online Protection

ManagedBy 参数按通讯组的管理员筛选结果, (ManagedBy 属性) 。 可以使用唯一标识通讯组管理器的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

数据库名称

参数属性

类型:GeneralRecipientIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

ManagedBy
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OrganizationalUnit

适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、Exchange Online Protection

OrganizationUnit 参数根据对象在 Active Directory 中的位置筛选结果。 只返回存在于指定位置的对象。 此参数的有效输入是由 Get-OrganizationalUnit cmdlet 返回的组织单位 (OU) 或域。 可以使用任何能够唯一标识此 OU 或域的值。 例如:

  • 名称
  • 名称
  • 可分辨名称 (DN)
  • GUID

参数属性

类型:OrganizationalUnitIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResultSize

适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、Exchange Online Protection

ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 1000。

参数属性

类型:Unlimited
默认值: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