Get-MailUser

  • 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-MailUser para recuperar os atributos relacionados a email do usuário especificado do serviço de diretório do Active Directory.

Sintaxe

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

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

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

Descrição detalhada

O cmdlet Get-MailUser recupera todos os atributos relacionados a email do usuário especificado.

Para executar o cmdlet Get-MailUser, você deve usar uma conta à qual esteja delegado o seguinte:

  • 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.

Dica

Nem todos os atributos de usuário são recuperados pelo cmdlet Get-MailUser. Você pode obter atributos de usuário adicionais com o cmdlet Get-User.

Parâmetros

Parâmetro Necessário Tipo Descrição

ANR

Opcional

System.String

O parâmetro Anr especifica uma cadeia de caracteres para executar uma pesquisa de 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:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

Credential

Opcional

System.Management.Automation.PSCredential

O parâmetro Credential especifica a conta a ser usada para obter acesso ao Active Directory.

Se o parâmetro Credential for usado, o comando solicitará a senha da conta antes de continuar.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando.

Filter

Opcional

System.String

O parâmetro Filter é usado para filtrar a lista de destinatários retornados. Você pode especificar os atributos para filtrar.

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

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

O parâmetro Identity identifica o usuário. Você pode incluir ADObjectID do usuário, DN (nome distinto), LegacyExchangeDN, GUID, Domain\SamAccountName, nome UPN, endereço de email ou 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 especifica um contêiner no qual limitar os resultados. Você pode especificar uma UO (unidade organizacional) ou um domínio. O nome canônico deve ser especificado. Por exemplo:

  • UO: westcoast.contoso.com/users

  • Domínio: westcoast.contoso.com

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 especifica o número máximo de objetos do destinatário a serem retornados. Se não for especificado, o parâmetro retornará todos os resultados que correspondem ao filtro.

SortBy

Opcional

System.String

O parâmetro SortBy especifica o atributo pelo qual os resultados são classificados. A classificação é realizada em um atributo de cada vez e é sempre executada na ordem crescente.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

No primeiro exemplo, o comando Get-MailUser é usado sem parâmetros para recuperar uma lista completa de usuários habilitados para email da organização inteira do Exchange.

No segundo exemplo, as configurações de email para o usuário Ted são recuperadas e canalizadas para o cmdlet Format-List para exibição.

Get-MailUser
Get-MailUser -Identity Ted | Format-List