Get-MailboxStatistics

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Get-MailboxStatistics para retornar informações sobre uma caixa de correio, como o tamanho da caixa de correio, o número de mensagens que ela contém e a última vez que ela foi acessada. Além disso, você pode obter o histórico ou um relatório de movimentação de uma solicitação de movimentação concluída.

Observação: em Exchange Online PowerShell, recomendamos que você use o cmdlet Get-EXOMailboxStatistics em vez desse cmdlet. Para saber mais, confira Conectar-se ao Exchange Online usando o PowerShell Remoto.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-MailboxStatistics
   -Database <DatabaseIdParameter>
   [[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-IncludeSoftDeletedRecipients]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   -Server <ServerIdParameter>
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludePassive]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]

Description

Apenas em servidores de Caixa de Correio, é possível usar o cmdlet Get-MailboxStatistics sem parâmetros. Nesse caso, o cmdlet retorna as estatísticas para todas as caixas de correio em todos os bancos de dados do servidor local.

O cmdlet Get-MailboxStatistics requer pelo menos um dos seguintes parâmetros para ser concluído com êxito: Servidor, Banco de Dados ou Identidade.

O cmdlet Get-MailboxStatistics pode ser usado para retornar o histórico detalhado e um relatório de movimentação para solicitações de movimentação concluídas para solucionar problemas de uma solicitação de movimentação. Para exibir o histórico de movimentação, este cmdlet deve ser passado como um objeto. Os históricos de movimentação são mantidos no banco de dados da caixa de correio e são numerados incrementalmente e a última solicitação de movimentação executada é sempre numerada 0. Para obter mais informações, consulte "Exemplo 7," "Exemplo 8" e "Exemplo 9" neste tópico.

Apenas relatórios e o histórico de movimentação para solicitações de movimentação concluídas podem ser exibidos.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-MailboxStatistics -Identity AylaKol

Este exemplo recupera as estatísticas da caixa de correio da usuária Ayla Kol, usando o alias associado AylaKol.

Exemplo 2

Get-MailboxStatistics -Server MailboxServer01

Este exemplo recupera as estatísticas de caixa de correio de todas as caixas de correio no servidor MailboxServer01.

Exemplo 3

Get-MailboxStatistics -Identity contoso\chris

Este exemplo recupera as estatísticas de caixa de correio para a caixa de correio especificada.

Exemplo 4

Get-MailboxStatistics -Database "Mailbox Database"

Este exemplo recupera as estatísticas de caixa de correio de todas as caixas de correio no banco de dados de caixa de correio especificado.

Exemplo 5

Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'

Este exemplo recupera as estatísticas de caixa de correio para as caixas de correio desconectadas para todos os bancos de dados de caixas de correio na organização. O operador -ne significa diferente de.

Exemplo 6

Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742d

Este exemplo recupera as estatísticas de caixa de correio de uma única caixa de correio desconectada. O valor do parâmetro StoreMailboxIdentity é o GUID da caixa de correio desconectada. Você também pode usar LegacyDN.

Exemplo 7

Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List

Este exemplo retorna o histórico de movimentação do resumo para a solicitação de movimentação concluída da caixa de correio de Ayla Kol. Se a saída não for canalizada para o cmdlet Format-List, o histórico de movimentação não será exibido.

Exemplo 8

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory

$temp.MoveHistory[0]

Este exemplo retorna o histórico de movimentação detalhado para a solicitação de movimentação concluída da caixa de correio de Ayla Kol. Este exemplo usa uma variável temporária para armazenar o objeto de estatísticas de caixa de correio. Se a caixa de correio tiver sido movida várias vezes, haverá vários relatórios de movimentação. O último relatório de movimentação é sempre MoveReport[0].

Exemplo 9

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport

$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv

Este exemplo retorna o histórico e um relatório de movimentação detalhados da caixa de correio de Ayla Kol. Este exemplo usa uma variável temporária para armazenar o objeto de estatísticas de caixa de correio e produz a saída do relatório de movimentação para um arquivo CSV.

Parâmetros

-Archive

A opção Arquivo especifica se deve retornar estatísticas de caixa de correio para a caixa de correio de arquivo associada à caixa de correio. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-CopyOnServer

Este parâmetro está disponível somente no Exchange local.

O parâmetro CopyOnServer é usado para recuperar estatísticas de uma cópia de banco de dados específica no servidor especificado.

É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • FQDN
  • DN (nome diferenciado)
  • DN Herdado do Exchange

DN Herdado do Exchange

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Database

Este parâmetro está disponível somente no Exchange local.

O parâmetro Banco de Dados retorna estatísticas para todas as caixas de correio no banco de dados especificado. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Esse parâmetro aceita a entrada de pipeline do cmdlet Get-MailboxDatabase.

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

Este parâmetro está disponível somente no Exchange local.

O parâmetro Filter usa a sintaxe OPATH para filtrar os resultados pelas propriedades e valores especificados. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'".

  • Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $falseou $null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtrada.
  • ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para iguais e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.
  • Valor é o valor da propriedade a ser pesquisado. Inclua valores e variáveis de texto em aspas individuais ('Value' ou '$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $falseou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando os operadores lógicos -and e -or. Por exemplo: "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Para obter informações detalhadas sobre filtros OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.

Por exemplo, para exibir todas as caixas de correio desconectadas em um banco de dados de caixa de correio específico, use a seguinte sintaxe: 'DisconnectDate -ne $null'.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica a caixa de correio para a qual você deseja retornar estatísticas. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeMoveHistory

A opção IncludeMoveHistory especifica se devem ser retornadas informações adicionais sobre a caixa de correio que inclui o histórico de uma solicitação de movimentação concluída, como status, sinalizadores, banco de dados de destino, itens incorretos, horas de início e de término, duração de tempo das solicitações de movimentação em vários estágios e códigos de falha. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeMoveReport

A opção IncludeMoveReport especifica se deve ser retornado um relatório de movimentação detalhado para uma solicitação de movimentação concluída, como conexões de servidor e estágios de movimentação. Não é preciso especificar um valor com essa opção.

Como a saída deste comando é detalhada, a saída deve ser enviada para um arquivo .CSV para facilitar a análise.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludePassive

Este parâmetro está disponível somente no Exchange local.

A opção IncludePassive especifica se deve retornar estatísticas de todas as cópias de banco de dados ativo e passivo. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, o comando recuperará apenas estatísticas de cópias de banco de dados ativo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeQuarantineDetails

Este parâmetro está disponível somente no Exchange local.

A opção IncludeQuarantineDetails especifica se deverão ser retornados detalhes de quarentena adicionais sobre a caixa de correio que não seriam de outro modo incluídos nos resultados. Você pode usar esses detalhes para determinar quando e por que uma caixa de correio foi colocada em quarentena. Não é preciso especificar um valor com essa opção.

Especificamente, esta opção retorna os valores das propriedades QuarantineDescription, QuarantineLastCrash e QuarantineEnd da caixa de correio. Para ver esses valores, você precisa usar um cmdlet de formatação. Por exemplo, Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeSoftDeletedRecipients

Esse parâmetro só está disponível no serviço baseado em nuvem.

A opção IncludeSoftDeletedRecipients especifica se deve incluir caixas de correio excluídas suaves nos resultados. Não é preciso especificar um valor com essa opção.

Caixas de correio excluídas de forma flexível são caixas de correio excluídas e que ainda podem ser recuperadas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-NoADLookup

Este parâmetro está disponível somente no Exchange local.

O comutador NoADLookup especifica que as informações são recuperadas do banco de dados da caixa de correio e não do Active Directory. Não é preciso especificar um valor com essa opção.

Essa opção ajuda a melhorar o desempenho do cmdlet ao consultar um banco de dados de caixa de correio que contém um grande número de caixas de correio.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Este parâmetro está disponível somente no Exchange local.

O parâmetro Server especifica o servidor do qual você deseja obter estatísticas de caixa de correio. Utilize um dos seguintes valores:

  • Nome de domínio totalmente qualificado (FQDN)
  • Nome NetBIOS

Quando um valor para o parâmetro Server é especificado, o comando retorna estatísticas para todas as caixas de correio em todos os bancos de dados, incluindo os bancos de dados de recuperação, no servidor especificado. Se esse parâmetro não for especificado, o comando retorna as estatísticas de logon do servidor local.

Type:ServerIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-StoreMailboxIdentity

Este parâmetro está disponível somente no Exchange local.

O parâmetro StoreMailboxIdentity especifica a identidade da caixa de correio quando usado com o parâmetro Database para retornar estatísticas com uma única caixa de correio no banco de dados especificado. Você pode usar um dos seguintes valores:

  • MailboxGuid
  • LegacyDN

Use essa sintaxe para recuperar informações sobre caixas de correio desconectadas, que não têm um objeto Active Directory correspondente ou que tenha um objeto Active Directory correspondente que não aponte para a caixa de correio desconectada no banco de dados da caixa de correio.

Type:StoreMailboxIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.