Get-User

Artigo
09/30/2014

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-User para recuperar todos os usuários da floresta, correspondentes às condições especificadas.

Sintaxe

get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Descrição detalhada

Nenhum parâmetro é necessário. No entanto, apenas um dos seguintes parâmetros pode ser usado em um comando Get-User: Identity, Filter ou Anr.

Para executar o cmdlet Get-User, 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 especifica a conta usada para a leitura do serviço de diretório do 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 especifica um conjunto de atributos que restringe os destinatários retornados pela consulta. Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -Filter.
Identity	Opcional	Microsoft.Exchange.Configuration.Tasks.UserIdParameter	O parâmetro Identity adota um dos seguintes valores: GUID Nome diferenciado (DN) Domínio\Conta Nome UPN DN Herdado do Exchange Endereço SMTP Alias
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.
OrganizationalUnit	Opcional	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	O parâmetro OrganizationalUnit retorna objetos apenas da UO (unidade organizacional) especificada.
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 os 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ário no Microsoft Exchange Server 2007 são divididos em tipos e subtipos de destinatário. 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. Os detalhes de tipos de destinatário disponíveis para este parâmetro são: ConferenceRoomMailbox DisabledUser EquipmentMailbox LegacyMailbox LinkedMailbox UserMailbox MailUser User
ResultSize	Opcional	Microsoft.Exchange.Data.Unlimited	O parâmetro ResultSize define o número máximo de resultados a serem retornados.
Sortby	Opcional	System.String	O parâmetro SortBy classifica por um único atributo em ordem crescente.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

O primeiro exemplo recupera informações sobre seus usuários na UO de Marketing.

O segundo exemplo usa o parâmetro Filter para recuperar informações sobre todos os usuários cujo cargo contém a palavra "Gerente".

Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}

É possível usar qualquer atributo de usuário do Active Directory para construir uma cadeia de caracteres de filtro para o parâmetro Filter no cmdlet Get-User. Para saber mais sobre os operadores de comparação que podem ser usados na cadeia de caracteres de filtro, consulte Operadores de comparação.

Compartilhar via