Compartilhar via

Get-Group (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

Use o cmdlet Get-Group para fazer consultas sobre grupos existentes.

Sintaxe

Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Group [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Group [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Descrição detalhada

O cmdlet Get-Group retorna todos os grupos existentes no Microsoft Windows que correspondem aos parâmetros de filtragem especificados.

Para executar o cmdlet Get-Group, 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 Microsoft 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 especifica a conta a ser usada para ler o serviço de diretório Active Directory. Esse parâmetro é útil principalmente quando o catálogo global é especificado. A senha deve ser solicitada de maneira segura.

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 especifica o filtro a ser 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.GroupIdParameter

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

  • GUID

  • DN (nome distinto)

  • Nome UPN

  • LegacyExchangeDN

  • Domínio\Nome da conta

  • Alias

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.

RecipientTypeDetails

Opcional

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

O parâmetro RecipientTypeDetails especifica o tipo de destinatários que são retornados. Os tipos de destinatários no Microsoft Exchange Server 2007 são divididos em tipos e subtipos de destinatários. Cada tipo de destinatário contém todas as propriedades comuns para todos os subtipos. Por exemplo, o tipo UserMailbox representa uma conta de usuário no Active Directory com uma caixa de correio associada. Como há vários tipos de caixas de correio, cada tipo é identificado pelo parâmetro RecipientTypeDetails. Por exemplo, uma caixa de correio de sala de conferência tem RecipientTypeDetails definido como ConferenceRoomMailbox, enquanto uma caixa de correio de usuário tem RecipientTypeDetails definido como UserMailbox.

Para este comando, os detalhes de tipo de destinatário disponíveis são:

  • MailEnabledContact

  • MailEnabledForestContact

  • NonUniversalGroup

  • UniversalDistributionGroup

  • UniversalSecurityGroup

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ResultSize especifica o número máximo de membros 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

O código a seguir é um exemplo do comando Get-Group. Neste exemplo, o comando Get-Group é usado sem parâmetros para retornar todos os grupos contidos no Active Directory.

Get-Group