Get-MailboxStatistics
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Utilize o cmdlet Get-MailboxStatistics para devolver informações sobre uma caixa de correio, como o tamanho da caixa de correio, o número de mensagens que contém e a última vez que foi acedida. 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.
Nota: no Exchange Online PowerShell, recomendamos que utilize 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, Base 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 na base de dados da caixa de correio e numerados incrementalmente e o último pedido de movimentação executado é sempre numerado 0. Para obter mais informações, veja "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.
Nota: estamos a preterir a propriedade LastUserActionTime no Exchange Online PowerShell. Não utilize o valor dessa propriedade como a última hora ativa para uma caixa de correio.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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, existem 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
O Arquivo parâmetro especifica se pretende devolver as estatísticas da caixa de correio de arquivo 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 é utilizado para obter estatísticas de uma cópia de base 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 Base de Dados devolve estatísticas para todas as caixas de correio na base de dados especificada. É 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 utiliza a sintaxe OPATH para filtrar os resultados pelas propriedades e valores especificados. Os critérios de pesquisa utilizam a sintaxe "Property -ComparisonOperator 'Value'".
- Coloque todo o filtro OPATH entre aspas " ". Se o filtro contiver valores de sistema (por exemplo,
$true,$falseou$null), utilize aspas únicas ' ' em vez disso. Embora este parâmetro seja uma cadeia (não um bloco de sistema), também pode utilizar chavetas { }, mas apenas se o filtro não contiver variáveis. - A propriedade é uma propriedade filtráveis.
- ComparisonOperator é um operador de comparação OPATH (por exemplo
-eq, para igual e-likepara comparação de cadeias). Para obter mais informações sobre operadores de comparação, veja about_Comparison_Operators. - Valor é o valor da propriedade a procurar. Coloque os valores de texto e as variáveis entre plicas (
'Value'ou'$Variable'). Se um valor de variável contiver aspas únicas, terá de identificar (escape) as aspas únicas para expandir a variável corretamente. Por exemplo, em vez de'$User', utilize'$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, utilize500,$true,$falseou$nullem alternativa).
Pode encadear múltiplos critérios de pesquisa em conjunto com 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, veja Informações adicionais sobre sintaxe OPATH.
Por exemplo, para apresentar todas as caixas de correio desligadas numa base de dados de caixa de correio específica, utilize 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 Identidade especifica a caixa de correio para a qual pretende devolver 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 Utilizador
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas 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.
O comutador IncludePassive especifica se pretende devolver estatísticas de todas as cópias de bases de dados ativas e passivas. Não é preciso especificar um valor com essa opção.
Se não utilizar este comutador, o comando obtém apenas estatísticas de cópias de bases 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.
O comutador IncludeSoftDeletedRecipients especifica se pretende incluir caixas de correio eliminadas de forma recuperável 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.
O comutador NoADLookup especifica que as informações são obtidas da base de dados da caixa de correio e não do Active Directory. Não é preciso especificar um valor com essa opção.
Este comutador ajuda a melhorar o desempenho do cmdlet ao consultar uma base 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
Utilize esta sintaxe para obter informações sobre caixas de correio desligadas, que não têm um objeto do Active Directory correspondente ou que tenham um objeto do Active Directory correspondente que não aponte para a caixa de correio desligada na base 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.
{{ Fill UseCustomRouting Description }}
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 suporta os 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.