.png)
Get-DynamicDistributionGroup
Aplica-se a: Exchange Server 2013, Exchange Online
Tópico modificado em: 2012-07-11
Use o cmdlet Get-DynamicDistributionGroup para recuperar as configurações em um grupo dinâmico de distribuição existente.
Para obter informações sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Sintaxe.
Get-DynamicDistributionGroup [-ManagedBy <GeneralRecipientIdParameter>] <COMMON PARAMETERS>
Get-DynamicDistributionGroup [-Anr <String>] <COMMON PARAMETERS>
Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AccountPartition <AccountPartitionIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
O exemplo recupera o grupo dinâmico de distribuição Marketing e canaliza o objeto para o comando Format-List para mostrar as informações sobre o grupo dinâmico de distribuição.
Get-DynamicDistributionGroup -Identity "Marketing" | Format-List
Este exemplo recupera todos os grupos de distribuição dinâmicos cujos nomes contenham a cadeia de caracteres "research" e canaliza o objeto para o comando Format-Table, para mostrar nomes de grupo de distribuição dinâmicos e por quem são gerenciados.
Get-DynamicDistributionGroup -Anr *research* | Format-Table Name, ManagedBy
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 emails 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 Active Directory.
Para executar esse cmdlet, você precisa ter permissões. Embora todos os parâmetros para este cmdlet estejam listados neste tópico, talvez você não tenha acesso a alguns parâmetros, caso eles não estejam incluídos nas permissões atribuídas a você. Para ver de que permissões você precisa, consulte o Entrada "Grupos dinâmicos de distribuição" no tópico Permissões de Destinatários.
| Parâmetro | Necessário(s) | Tipo | Descrição | ||
|---|---|---|---|---|---|
| AccountPartition | Opcional | Microsoft.Exchange.Configuration.Tasks.AccountPartitionIdParameter | Esse parâmetro está reservado para uso interno da Microsoft. | ||
| Anr | Opcional | System.String | O parâmetro Anr especifica uma cadeia de caracteres na qual executar uma pesquisa ANR (resolução de nomes ambíguos). Você pode especificar uma cadeia de caracteres parcial para objetos com um atributo correspondente a esta cadeia de caracteres. Os atributos padrão pesquisados são:
| ||
| Credential | Opcional | System.Management.Automation.PSCredential | O parâmetro Credential especifica o nome de usuário e a senha a serem usados para acessar o Active Directory. Esse parâmetro exige a criação e a passagem de um objeto de credencial. Esse objeto de credencial é criado com o cmdlet Get-Credential. Para mais informações, consulte Get-Credential. | ||
| DomainController | Opcional | Microsoft.Exchange.Data.Fqdn | O parâmetro DomainController especifica o FQDN do controlador de domínio que recupera dados do Active Directory. | ||
| Filter | Opcional | System.String | O parâmetro Filter indica o filtro OPath usado para filtrar destinatários. Para mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis para o parâmetro de filtro. | ||
| Identity | Opcional | Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter | O parâmetro Identity especifica o grupo dinâmico de distribuição. Esse parâmetro aceita os seguintes valores:
| ||
| IgnoreDefaultScope | Opcional | System.Management.Automation.SwitchParameter | O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração de escopo do destinatário padrão do Shell de Gerenciamento do Exchange e usar toda a floresta como escopo. Isso permite que o comando acesse objetos do Active Directory que não estejam no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:
| ||
| ManagedBy | Opcional | Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter | O parâmetro ManagedBy especifica o nome do usuário da caixa de correio, o grupo habilitado para email ou o contato habilitado para email que aparece na guia Gerenciado por do objeto do Active Directory. Esse parâmetro aceita os seguintes valores:
| ||
| Organization | Opcional | Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter | O parâmetro Organization está reservado para uso interno da Microsoft. | ||
| 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 esse parâmetro, será possível que as informações do usuário sejam lidas 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.
| ||
| ResultSize | Opcional | Microsoft.Exchange.Data.Unlimited | O parâmetro ResultSize especifica o número máximo de objetos de destinatário retornados. | ||
| SortBy | Opcional | System.String | O parâmetro SortBy é usado para classificar os resultados. |
Observação: Para ver os tipos de entrada que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlets. Se o campo Tipo de Entrada de um cmdlet estiver em branco, é porque o cmdlet não aceita dados de entrada.
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlets. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.
