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 ambiente ou de outro.
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 em que 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: no Exchange Online PowerShell, recomendamos que você use o cmdlet Get-EXOMailboxStatistics em vez deste 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.
Sintaxe
Database
Get-MailboxStatistics
[[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>]
Identity
Get-MailboxStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-IncludeSoftDeletedRecipients]
[-NoADLookup]
[-UseCustomRouting]
[<CommonParameters>]
Server
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 retidos no banco de dados da caixa de correio e são numerados incrementalmente e a última solicitação de movimentação executada é sempre numerada como 0. Para obter mais informações, consulte o "Exemplo 7", "Exemplo 8" e "Exemplo 9" neste artigo.
Apenas relatórios e o histórico de movimentação para solicitações de movimentação concluídas podem ser exibidos.
Observação: estamos substituindo a propriedade LastUserActionTime no Exchange Online PowerShell. Não use o valor dessa propriedade como o último horário ativo para uma caixa de correio.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 for 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção Arquivo especifica se as estatísticas de caixa de correio devem ser retornadas para a caixa de correio de arquivo morto associada à caixa de correio. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CopyOnServer
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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
Propriedades do parâmetro
| Tipo: | ServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Database
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Database
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro Database 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.
Propriedades do parâmetro
| Tipo: | DatabaseIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Database
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Filter
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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. O critério de pesquisa usa a sintaxe "Property -ComparisonOperator 'Value'".
- Coloque todo o filtro OPATH entre aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo,
$true,$false, ou$null), use aspas simples " '. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também poderá usar chaves { }, mas somente se o filtro não contiver variáveis. - A propriedade é uma propriedade filtrável.
- ComparisonOperator é um operador de comparação OPATH (por exemplo,
-eqpara igual e-likepara 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. Coloque os valores de texto e variáveis entre aspas simples (
'Value'ou'$Variable'). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de'$User', use'$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, use500,$true,$false, ou$nullem vez disso).
Você pode encadear vários critérios de pesquisa usando os operadores -and lógicos 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'
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Database
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Server
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | GeneralMailboxOrMailUserIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeMoveHistory
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludeMoveReport
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludePassive
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
A opção IncludePassive especifica se as estatísticas devem ser retornadas de todas as cópias de banco de dados ativas e passivas. Não é preciso especificar um valor com essa opção.
Se você não usar essa opção, o comando recuperará estatísticas apenas de cópias de banco de dados ativas.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Server
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludeQuarantineDetails
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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*.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludeSoftDeletedRecipients
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
A opção IncludeSoftDeletedRecipients especifica se as caixas de correio excluídas temporariamente devem ser incluídas 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-NoADLookup
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
A opção 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Server
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | ServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Server
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-StoreMailboxIdentity
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 do Active Directory correspondente ou que têm um objeto do Active Directory correspondente que não aponta para a caixa de correio desconectada no banco de dados da caixa de correio.
Propriedades do parâmetro
| Tipo: | StoreMailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Database
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-UseCustomRouting
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Preencher descrição do UseCustomRouting }}
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.