Compartilhar via

Get-Mailbox

  • 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-Mailbox para exibir os objetos e atributos da caixa de correio, para preencher as páginas de propriedades ou para fornecer informações sobre a caixa de correio para outras tarefas.

Sintaxe

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

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

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

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

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

Descrição detalhada

O cmdlet Get-Mailbox recupera os atributos e objetos de uma caixa de correio. Nenhum parâmetro é necessário. Se o cmdlet for usado sem um parâmetro, todas as caixas de correio da organização serão listadas.

Para executar o cmdlet Get-Mailbox, 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.

Dica

Para avaliar com precisão o status da cota de armazenamento atual usando o cmdlet Get-Mailbox, é necessário examinar a propriedade UseDatabaseQuotaDefaults além das propriedades ProhibitSendQuota, ProhibitSendReceiveQuota e IssueWarningQuota. Um valor True para a propriedade UseDatabaseQuotaDefaults significa que as configurações por caixa de correio serão ignoradas e os limites do banco de dados de caixa de correio serão usados. Se essa propriedade for definida como True e as propriedades ProhibitSendQuota, ProhibitSendReceiveQuota e IssueWarningQuota estiverem definidas como ilimitadas, a caixa de correio não terá tamanho ilimitado. Em vez disso, você deve consultar os limites de armazenamento do banco de dados de caixa de correio para verificar quais são os limites da caixa de correio. Um valor False para a propriedade UseDatabaseQuotaDefaults significa que serão usadas as configurações por caixa de correio.

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 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 pesquisáveis são:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Opcional

System.Management.Automation.PSCredential

O parâmetro Credential especifica o nome do usuário e a senha a serem usados para acessar o serviço de diretório do Active Directory

Database

Opcional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

O parâmetro Database especifica o banco de dados do qual obter a caixa de correio. É possível usar os seguintes valores:

  • GUID do banco de dados

  • Nome do banco de dados

  • Nome do servidor\nome do banco de dados

  • Nome do servidor\grupo de armazenamento\nome do banco de dados

Se você não especificar o nome do servidor, o cmdlet procurará o banco de dados no servidor local. Se você tiver vários bancos de dados com o mesmo nome no mesmo servidor, deverá especificar o grupo de armazenamento.

Este parâmetro não pode ser usado juntamente com o parâmetro Filter.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro DomainController especifica o controlador de domínio a ser usado para acessar o Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado.

Filter

Opcional

System.String

O parâmetro Filter especifica um ou mais atributos que são usados para restringir as caixas de correio retornadas pela consulta.

Este parâmetro não pode ser usado juntamente com o parâmetro Database.

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

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Identity identifica a caixa de correio. Você pode usar um dos seguintes valores:

  • GUID

  • DN (nome distinto)

  • Domínio\Conta

  • Nome UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

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

O parâmetro OrganizationalUnit especifica uma UO (unidade organizacional) e é usado para limitar os resultados. Se você usar esse parâmetro, obterá somente caixas de correio do destinatário 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

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 RoomMailbox, 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:

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • SharedMailbox

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Se desejar retornar todas as caixas de correio que correspondem à consulta, use "unlimited" para o valor deste parâmetro. O valor padrão é 1000.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica um servidor individual e é usado para limitar os resultados. Se você usar esse parâmetro, obterá somente caixas de correio que residem no servidor especificado. Use o nome comum do servidor que você deseja especificar.

SortBy

Opcional

System.String

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

  • Alias

  • Nome para exibição

  • Name

Os resultados serão classificados na ordem crescente.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

O primeiro exemplo mostra como obter uma lista de todas as caixas de correio em sua organização.

O segundo exemplo mostra como obter uma lista de todas as caixas de correio em sua organização no contêiner Usuários do domínio Contoso.com.

O terceiro exemplo mostra como obter todas as caixas de correio que resolvem a partir da pesquisa de resolução de nomes ambíguos da cadeia de caracteres "Chr" que estão no domínio de DC01. Isso retornará caixas de correio para usuários como Chris Ashton, Christian Cletus e Christa Geller.

Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01