Get-Mailbox
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:
|
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:
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:
|
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:
|
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:
|
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:
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