Partilhar via


Get-EligibleDistributionGroupForMigration

Esse cmdlet é funcional apenas no serviço baseado em nuvem.

Use o cmdlet Get-EligibleDistributionGroupForMigration para identificar grupos de distribuição que podem ser atualizados para Grupos do Microsoft 365. Você não pode atualizar grupos de segurança habilitados para email para Grupos do Microsoft 365.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-EligibleDistributionGroupForMigration -ResultSize unlimited

Este exemplo retorna uma lista de resumo de todos os grupos de distribuição que podem ser atualizados para Grupos do Microsoft 365.

Parâmetros

-Identity

O parâmetro Identity filtra os resultados pelo endereço de email do grupo de distribuição especificado. Se nenhum resultado for retornado para o endereço de email especificado, o grupo não poderá ser atualizado para um grupo Microsoft 365.

Você não pode usar esse parâmetro com o parâmetro 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

O parâmetro ManagedBy filtra os resultados pelo gerente do grupo de distribuição (a propriedade ManagedBy). Você pode usar qualquer valor que identifique exclusivamente o gerenciador do grupo de distribuição. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Nome do banco de dados

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

O parâmetro OrganizationalUnit filtra os resultados com base na localização do objeto no Active Directory. Somente objetos que existem na localização especificada são retornados. A entrada válida para esse parâmetro é uma OU (unidade organizacional) ou domínio retornado pelo cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

  • Nome
  • Nome
  • Nome diferenciado (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

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 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