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.
Sintaxe
Database
Get-StoreUsageStatistics
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Identity
Get-StoreUsageStatistics
[-Identity] <GeneralMailboxIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Server
Get-StoreUsageStatistics
-Server <ServerIdParameter>
[-IncludePassive]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Description
O Repositório de Informações do Microsoft Exchange coleta informações por usuário sobre latência, entrada/saída (E/S), contagens de páginas, uso do processador e TimeInServer. A métrica TimeInServer representa o tempo total que as solicitações síncronas e assíncronas passam no Repositório de Informações do Microsoft Exchange para a caixa de correio de um usuário. Você pode recuperar essas informações de recursos no Repositório de Informações do Microsoft Exchange para as 25 contas de uso mais alto 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 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-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 estatísticas de uso da loja para o banco de dados DB1 e classifica a saída pelos 10 geradores de arquivos de log mais altos.
Parâmetros
-CopyOnServer
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro CopyOnServer especifica a cópia do banco de dados da caixa de correio da qual 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 Server ou Identity.
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
O parâmetro Database especifica o nome do banco de dados de caixa de correio do qual 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
Não é possível usar esse parâmetro com os parâmetros Identity ou Server.
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
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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Identity especifica a caixa de correio da qual obter estatísticas de uso. Você pode usar um dos seguintes valores para identificar a caixa de correio:
- GUID
- Nome diferenciado (DN)
- Domínio\Conta
- Nome principal do usuário (UPN)
- DN Herdado do Exchange
- Endereço SMTP
- Alias
O comando retornará resultados para a caixa de correio somente se for um dos 25 principais usuários de recursos da loja.
Não é possível usar esse parâmetro com os parâmetros de Banco de Dados ou Servidor.
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: | GeneralMailboxIdParameter |
| 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 |
-IncludePassive
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção IncludePassive especifica se as estatísticas de uso devem ser incluídas 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 as estatísticas de cópias ativas de bancos de dados de caixa de correio serão incluídas nos resultados.
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 |
-Server
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Server especifica o servidor de Caixa de Correio do qual 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
Não é possível usar esse parâmetro com os parâmetros Database ou Identity.
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 |
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.