Get-DynamicDistributionGroup

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2010-04-27

Use o cmdlet Get-DynamicDistributionGroup para recuperar as configurações em um grupo dinâmico de distribuição existente.

Sintaxe

Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DynamicDistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DynamicDistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Descrição detalhada

Você pode usar grupos de distribuição para criar listas de distribuição de email e grupos de segurança para atribuir permissões a recursos compartilhados. Os grupos de distribuição podem ser usados apenas com aplicativos de email (como o Microsoft Exchange) para enviar mensagens de email a coleções de usuários. Você pode usar cmdlet Get-DynamicDistributionGroup para recuperar as configurações em um grupo dinâmico de distribuição existente no diretório de serviço do Active Directory.

Para executar o cmdlet Get-DynamicDistributionGroup, você deve usar a conta à qual esteja delegada a seguinte função:

  • Função Administrador Somente para Exibição do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Anr

Opcional

System.String

O parâmetro Anr indica que o argumento será resolvido com uma resolução de nomes ambíguos (ANR).

Credential

Opcional

System.Management.Automation.PSCredential

O parâmetro Credential indica o domínio e o nome de usuário da conta usada para ler o Active Directory.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do Active Directory, inclua o parâmetro DomainController no comando.

Filter

Opcional

System.String

O parâmetro Filter indica o filtro OPath usado para filtrar destinatários.

Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -Filter.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter

O parâmetro Identity do grupo de distribuição aceita um dos seguintes formatos:

  • GUID

  • Nome distinto (DN)

  • Nome UPN

  • LegacyExchangeDN

  • Domínio\Nome da conta

  • Alias

  • Endereço SMTP principal

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

  • Você não pode usar os parâmetros OrganizationalUnit e Identity juntos.

  • Você não pode usar o parâmetro Credential.

ManagedBy

Opcional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

O parâmetro ManagedBy indica o nome distinto (DN) do usuário ou contato que gerencia o grupo.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

O parâmetro OrganizationalUnit limita os resultados a um contêiner de UO (unidade organizacional) específico.

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ReadFromDomainController especifica se as informações do usuário são lidas a partir de um controlador de domínio no domínio do usuário. Se você definir o escopo do destinatário para incluir todos os destinatários da floresta e não usar este parâmetro, talvez as informações do usuário sejam lidas a partir de um catálogo global com informações desatualizadas. Se você usar este parâmetro, várias leituras poderão ser necessárias para obter as informações.

Dica

Por padrão, o escopo do destinatário é definido como o domínio que hospeda seus servidores Exchange.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ResultSize indica o número máximo de objetos de destinatários que serão retornados.

SortBy

Opcional

System.String

O atributo SortBy é usado para classificar os resultados.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

Exemplo

A seguir, está um exemplo do comando Get-DynamicDistributionGroup. Nesse exemplo, o comando Get-DynamicDistributionGroup recupera o grupo de distribuição dinâmico Marketing e canaliza o objeto para o comando Format-List para exibir as informações sobre o grupo dinâmico de distribuição.

Get-DynamicDistributionGroup -Identity "Marketing" | Format-List