Get-StoreUsageStatistics

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Get-StoreUsageStatistics para auxiliar no diagnóstico de problemas de desempenho em seus servidores ou bancos de dados.

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

Syntax

Get-StoreUsageStatistics
   -Database <DatabaseIdParameter>
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [<CommonParameters>]
Get-StoreUsageStatistics
   [-Identity] <GeneralMailboxIdParameter>
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [<CommonParameters>]
Get-StoreUsageStatistics
   -Server <ServerIdParameter>
   [-IncludePassive]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [<CommonParameters>]

Description

O Microsoft Exchange Information Store coleta informações por usuário sobre latência, E/S (entrada/saída), contagens de página, uso do processador e TimeInServer. A métrica TimeInServer representa o tempo total que as solicitações síncronas e assíncronas gastam na Microsoft Exchange Information Store para a caixa de correio de um usuário. Você pode recuperar essas informações de recurso no Microsoft Exchange Information Store para as 25 contas de uso mais altas em um banco de dados especificado. O uso de uma caixa de correio é definido como a quantidade de tempo do servidor gasto na execução de operações para essa caixa de correio. O cmdlet reporta os 25 principais usuários para cada período de um minuto nos últimos 10 minutos (250 objetos por intervalo de dez minutos). O uso de recursos é um indicador da carga que usuários diferentes impõem ao servidor.

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-StoreUsageStatistics -Server EX1 | ft -auto

Este exemplo recupera as estatísticas de uso de armazenamento para todos os bancos de dados de ativos no servidor EX1.

Exemplo 2

Get-StoreUsageStatistics -Server EX1 -IncludePassive | ft -auto

Este exemplo recupera as estatísticas de uso de armazenamento para todos os bancos de dados de ativos no servidor EX1.

Exemplo 3

Get-StoreUsageStatistics -Database DB1 | Sort-Object LogRecordBytes -desc | Select-Object -First 10 | ft DigestCategory, *guid, LogRecordBytes, *time* -auto

Este exemplo recupera as estatísticas de uso do armazenamento para o banco de dados DB1 e classifica a saída pelos 10 geradores de arquivos de log mais altos.

Parâmetros

-CopyOnServer

O parâmetro CopyOnServer especifica a cópia do banco de dados da caixa de correio para obter estatísticas de uso. Você pode usar qualquer valor que identifique exclusivamente o banco de dados da caixa de correio. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Você usa esse parâmetro com os parâmetros Servidor ou Identidade.

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

O parâmetro Banco de Dados especifica o nome do banco de dados da caixa de correio para obter estatísticas de uso (as 25 maiores caixas de correio no banco de dados de caixa de correio especificado). Você pode usar qualquer valor que identifique exclusivamente o banco de dados da caixa de correio. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Você não pode usar esse parâmetro com os parâmetros Identity ou Server.

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

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

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.

Type:String
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

-Identity

O parâmetro Identity especifica a caixa de correio para obter estatísticas de uso. Você pode usar um dos seguintes valores para identificar a caixa de correio:

  • GUID
  • Nome diferenciado (DN)
  • Domain\Account
  • Nome principal do usuário (UPN)
  • DN Herdado do Exchange
  • Endereço SMTP
  • Alias

O comando retornará os resultados da caixa de correio somente se for um dos 25 principais usuários dos recursos da loja.

Você não pode usar esse parâmetro com os parâmetros Banco de Dados ou Servidor.

Type:GeneralMailboxIdParameter
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

-IncludePassive

A opção IncludePassive especifica se você deve incluir estatísticas de uso de cópias ativas e passivas de bancos de dados de caixa de correio no servidor de caixa de correio especificado com o parâmetro Server. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, somente estatísticas de cópias ativas de bancos de dados de caixa de correio serão incluídas nos resultados.

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

O parâmetro Server especifica o servidor mailbox para obter estatísticas de uso (as 25 principais caixas de correio em todos os bancos de dados ativos no servidor especificado). Você pode usar um dos seguintes valores para identificar o servidor:

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

Você não pode usar esse parâmetro com os parâmetros Banco de Dados ou Identidade.

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

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.