Get-EligibleDistributionGroupForMigration

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

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

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

语法

Get-EligibleDistributionGroupForMigration
   [[-Identity] <DistributionGroupIdParameter>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
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

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

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

Type:DistributionGroupIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ManagedBy

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

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

数据库名称

Type:GeneralRecipientIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OrganizationalUnit

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

  • 名称
  • 名称
  • 可分辨名称 (DN)
  • GUID
Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResultSize

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

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection