Get-CASMailbox

  • Artigo

 

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

Tópico modificado em: 2011-01-21

O cmdlet Get-CASMailbox retorna uma lista dos atributos de uma caixa de correio do Microsoft Exchange Server 2007 em um computador no qual a função de servidor Acesso para Cliente está instalada.

Sintaxe

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

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

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

Parâmetros

Parâmetro Necessário Tipo Descrição

Anr

Opcional

System.String

Esse parâmetro aceita um conjunto de caracteres para executar uma pesquisa ambígua de resolução de nomes. Os atributos pesquisados incluem:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Opcional

System.Management.Automation.PSCredential

Esse parâmetro especifica a conta a ser usada para ler a partir do serviço de diretório do Active Directory.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Esse parâmetro especifica o controlador de domínio ao qual se conectar para validação do Active Directory.

Filter

Opcional

System.String

Esse parâmetro especifica um conjunto de atributos usados para construir uma consulta a fim de recuperar um conjunto de caixas de correio. Esse parâmetro não pode ser usado junto com o parâmetro Database.

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

Esse parâmetro pode ser o ADObjectID ou uma cadeia de caracteres que representa a GUID, o nome distinto, o domínio\conta, o nome upn, o nome distinto do Exchange herdado, o endereço SMTP ou o alias.

IgnoreDefaultScope

Opcional

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 é usado para limitar a pesquisa a um contêiner específico.

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 servidor de 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.

Observação  Por padrão, o escopo do destinatário é definido como o domínio que hospeda seus servidores Exchange.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Esse parâmetro especifica o número máximo de resultados a serem retornados. O valor padrão é 1000.

SortBy

Opcional

System.String

Esse parâmetro especifica o atributo usado para classificar os resultados. Os resultados são classificados na ordem crescente.

Descrição detalhada

O cmdlet Get-CASMailbox retorna uma lista completa dos atributos de uma caixa de correio em um servidor de Acesso para Cliente do Exchange 2007. São retornados vários atributos de CASMailbox. Os tipos de atributos retornados incluem Outlook Web Access, ActiveSync, POP3 e IMAP4.

Por padrão, todos os atributos são retornados para todas as caixas de correio na organização do Exchange. Esses resultados podem ser filtrados usando a funcionalidade no Shell de Gerenciamento do Exchange.

O cmdlet Get-CASMailbox pode ser executado apenas em um computador Exchange 2007 que tenha a função de servidor Caixa de Correio instalada. Para executar o cmdlet Get-CASMailbox, você deve usar uma conta à qual esteja delegada a 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 2007, consulte Considerações sobre permissão. 

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir retorna todos os detalhes de caixa de correio do servidor de Acesso para Cliente para o usuário Jeff Hay no domínio Contoso.

Get-CASMailbox -identity jeffhay@contoso.com