Get-EligibleDistributionGroupForMigration

Módulo:
Exchange PowerShell

Esse cmdlet funciona somente no serviço baseado em nuvem.

Use o cmdlet Get-EligibleDistributionGroupForMigration para identificar os grupos de distribuição que podem ser atualizados para o Grupos do Microsoft 365. Não é possível 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.

Sintaxe

Identity 

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

ManagedBy 

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

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 resumida de todos os grupos de distribuição que podem ser atualizados para os Grupos do Microsoft 365.

Parâmetros

-Identity

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais

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 do Microsoft 365.

Não é possível usar esse parâmetro com o parâmetro ManagedBy.

Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.

Propriedades do parâmetro

Tipo:DistributionGroupIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ManagedBy

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais

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

Propriedades do parâmetro

Tipo:GeneralRecipientIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ManagedBy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OrganizationalUnit

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais

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 UO (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

Propriedades do parâmetro

Tipo:OrganizationalUnitIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResultSize

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais

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.

Propriedades do parâmetro

Tipo:Unlimited
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.