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 Arquivo de Informações do Microsoft Exchange recolhe informações por utilizador sobre latência, entrada/saída (E/S), contagens de páginas, utilização do processador e TimeInServer. A métrica TimeInServer representa o tempo total que os pedidos síncronos e assíncronos passam no Arquivo de Informações do Microsoft Exchange para a caixa de correio de um utilizador. Pode obter estas informações de recursos no Arquivo de Informações do Microsoft Exchange para as 25 contas de utilização mais elevadas numa base de dados especificada. 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, 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-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 obtém as estatísticas de utilização do arquivo da base de dados DB1 e ordena a saída pelos 10 geradores de ficheiros de registo mais elevados.
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 da base de dados da caixa de correio para obter estatísticas de utilização. Pode utilizar qualquer valor que identifique exclusivamente a base de dados da caixa de correio. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Utilize este parâmetro com os parâmetros Servidor ou Identidade.
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 Base de Dados especifica o nome da base de dados da caixa de correio para obter estatísticas de utilização (as 25 maiores caixas de correio na base de dados de caixa de correio especificada). Pode utilizar qualquer valor que identifique exclusivamente a base de dados da caixa de correio. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Não pode utilizar este parâmetro com os parâmetros Identidade ou Servidor.
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 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.
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 Identidade especifica a caixa de correio da onde obter estatísticas de utilização. Pode utilizar 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 devolve resultados para a caixa de correio apenas se for um dos 25 principais utilizadores de recursos de armazenamento.
Não pode utilizar este parâmetro com os parâmetros Base de Dados ou Servidor.
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: | 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
O comutador IncludePassive especifica se deve incluir estatísticas de utilização de cópias ativas e passivas de bases de dados de caixa de correio no servidor da Caixa de Correio que especificou com o parâmetro Servidor. Não é preciso especificar um valor com essa opção.
Se não utilizar este comutador, apenas as estatísticas de cópias ativas de bases de dados de caixas de correio sã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 Servidor especifica o servidor da Caixa de Correio a partir do qual obter estatísticas de utilização (as 25 principais caixas de correio em todas as bases de dados ativas no servidor especificado). Pode utilizar um dos seguintes valores para identificar o servidor:
- Nome de domínio totalmente qualificado (FQDN)
- Nome NetBIOS
Não pode utilizar este parâmetro com os parâmetros Base de Dados ou Identidade.
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 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.