Share via

Get-UMMailbox

  • Artigo

 

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

Tópico modificado em: 2007-07-20

O cmdlet Get-UMMailbox exibe as propriedades de UM (Unificação de Mensagens) de um destinatário que esteja habilitado para UM.

Sintaxe

Get-UMMailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Descrição detalhada

O cmdlet Get-UMMailbox recupera as propriedades de UM para uma única caixa de correio de UM. Ele pode também retornar uma lista de caixas de correio habilitadas para UM.

Para executar o cmdlet Get-UMMailbox, você deve usar uma conta à qual esteja delegada a função Administrador de Destinatários 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(s) Tipo Descrição

Anr

Opcional

System.String

Esse parâmetro especifica uma cadeia de caracteres para executar uma pesquisa de resolução de nomes ambíguos (ANR). Você pode especificar uma cadeia de caracteres parcial para objetos com um atributo correspondente a esta cadeia de caracteres. Os atributos padrão pesquisáveis são os seguintes:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Opcional

System.Management.Automation.PSCredential

Este parâmetro especifica o nome do usuário e a senha a ser usada para acessar o serviço de diretório do Active Directory.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Este parâmetro especifica o nome de domínio totalmente qualificado do controlador de domínio que grava essa alteração de configuração no Active Directory.

Filter

Opcional

System.String

Este parâmetro permite que você filtre os resultados retornados pelo cmdlet.

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

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Este parâmetro especifica o usuário a ser habilitado para Unificação de Mensagens. As variáveis desse parâmetro incluem:

  • ADObjectID

  • GUID

  • DN

  • Domain\Account

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Este parâmetro será necessário se o parâmetro Instance não for usado.

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro instrui o comando a ignorar a configuração padrão de escopo de destinatário 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 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

Esse parâmetro especifica uma UO (unidade organizacional) e é usado para limitar os resultados. Se você usar esse parâmetro, recuperará somente caixas de correio do contêiner especificado. Você pode usar a UO ou o nome de domínio. Se você usar a UO, deverá especificar o nome canônico da UO.

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro especifica se as informações do usuário serão lidas a partir de um controlador de domínio do domínio do usuário. Se você tiver definido o escopo do destinatário para incluir todos os destinatários da floresta e não usar esse parâmetro, as informações do usuário poderão ser lidas a partir de um catálogo global cujas informações estão desatualizadas. Se você não usar esse parâmetro, várias leituras poderão ser necessárias para obter as informações. Por padrão, o escopo do destinatário é definido como o domínio que hospeda seus servidores Exchange.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Este parâmetro permite especificar um número máximo de resultados a ser retornado. Caso um número máximo não seja especificado, o cmdlet retornará todos os resultados.

SortBy

Opcional

System.String

Este parâmetro especifica o atributo pelo qual classificar os resultados. Você pode classificar por apenas um atributo de cada vez. Você pode classificar pelos seguintes atributos:

  • Alias

  • DisplayName

  • Name

Os resultados serão classificados na ordem crescente.

Tipos de entrada

Tipo Descrição

 

 

Tipos de retorno

Tipo Descrição

 

 

Erros

Erro Descrição

 

 

Exemplo

O primeiro exemplo de código exibe uma lista de todas as caixas de correio habilitadas para UM na floresta do Active Directory em uma lista formatada.

O segundo exemplo de código exibe as propriedades de caixa de correio de UM para yanli@contoso.com.

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com