Get-Counter
Obtém os dados do contador de desempenho de computadores locais e remotos.
Syntax
Get-Counter
[[-Counter] <string[]>]
[-SampleInterval <int>]
[-MaxSamples <long>]
[-Continuous]
[-ComputerName <String[]>]
[<CommonParameters>]Get-Counter
[-ListSet] <String[]>
[-ComputerName <String[]>]
[<CommonParameters>]Description
O Get-Counter cmdlet obtém dados do contador de desempenho diretamente da instrumentação de monitoramento de desempenho na família Windows de sistemas operacionais. Get-Counter obtém dados de desempenho de um computador local ou computadores remotos.
Você pode usar os Get-Counter parâmetros para especificar um ou mais computadores, listar os conjuntos de contadores de desempenho e as instâncias que eles contêm, definir os intervalos de exemplo e especificar o número máximo de exemplos. Sem parâmetros, Get-Counter obtém dados do contador de desempenho para um conjunto de contadores do sistema.
Muitos conjuntos de contadores são protegidos por ACL (listas de controle de acesso). Para ver todos os conjuntos de contadores, abra o PowerShell com a opção Executar como administrador .
Exemplos
Exemplo 1: Obter a lista de conjuntos de contadores
Este exemplo obtém a lista de conjuntos de contadores do computador local.
Get-Counter -ListSet *
CounterSetName : Processor
MachineName : .
CounterSetType : MultiInstance
Description : The Processor performance object consists of counters that measure aspects ...
computer that performs arithmetic and logical computations, initiates ...
computer can have multiple processors. The processor object represents ...
Paths : {\Processor(*)\% Processor Time, \Processor(*)\% User Time, ...
PathsWithInstances : {\Processor(0)\% Processor Time, \Processor(1)\% Processor Time, ...
Counter : {\Processor(*)\% Processor Time, \Processor(*)\% User Time, ...Get-Counter usa o parâmetro ListSet com um asterisco (*) para obter a lista de conjuntos de contadores.
O ponto (.) na coluna MachineName representa o computador local.
Exemplo 2: especificar sampleInterval e MaxSamples
Esses exemplos obtém os dados do contador para todos os processadores no computador local. Os dados são coletados em intervalos de dois segundos até que haja três amostras.
Get-Counter -Counter "\Processor(_Total)\% Processor Time" -SampleInterval 2 -MaxSamples 3
Timestamp CounterSamples
--------- --------------
6/18/2019 14:39:56 \\Computer01\processor(_total)\% processor time :
20.7144271584086
6/18/2019 14:39:58 \\Computer01\processor(_total)\% processor time :
10.4391790575511
6/18/2019 14:40:01 \\Computer01\processor(_total)\% processor time :
37.5968799396998Get-Counter usa o parâmetro Counter para especificar o caminho \Processor(_Total)\% Processor Timedo contador . O parâmetro SampleInterval define um intervalo de dois segundos para marcar o contador. MaxSamples determina que três é o número máximo de vezes para marcar o contador.
Exemplo 3: Obter amostras contínuas de um contador
Esses exemplos obtém exemplos contínuos para um contador a cada segundo. Para interromper o comando, pressione CtrlC. Para especificar um intervalo mais longo entre exemplos, use o parâmetro SampleInterval .
Get-Counter -Counter "\Processor(_Total)\% Processor Time" -Continuous
Timestamp CounterSamples
--------- --------------
6/19/2019 15:35:03 \\Computer01\processor(_total)\% processor time :
43.8522842937022
6/19/2019 15:35:04 \\Computer01\processor(_total)\% processor time :
29.7896844697383
6/19/2019 15:35:05 \\Computer01\processor(_total)\% processor time :
29.4962645638135
6/19/2019 15:35:06 \\Computer01\processor(_total)\% processor time :
25.5901500127408Get-Counter usa o parâmetro Counter para especificar o \Processor\% Processor Time contador.
O parâmetro Contínuo especifica para obter amostras a cada segundo até que o comando seja interrompido com CTRL+C.
Exemplo 4: lista alfabética de conjuntos de contadores
Este exemplo usa o pipeline para obter o conjunto de listas de contadores e, em seguida, classificar a lista em ordem alfabética.
Get-Counter -ListSet * | Sort-Object -Property CounterSetName | Format-Table -AutoSize
CounterSetName MachineName CounterSetType Description
-------------- ----------- -------------- -----------
.NET CLR Data . SingleInstance .Net CLR Data
.NET Data Provider for SqlServer . SingleInstance Counters for System.Data.SqlClient
AppV Client Streamed Data Percentage . SingleInstance Size of data streamed to disk ...
Authorization Manager Applications . SingleInstance The set of Counters for ...
BitLocker . MultiInstance BitLocker Drive Encryption ...
Bluetooth Device . SingleInstance Counters related to a remote ...
Cache . SingleInstance The Cache performance object ...
Client Side Caching . SingleInstance Performance counters for SMB ...Get-Counter usa o parâmetro ListSet com um asterisco (*) para obter uma lista completa de conjuntos de contadores. Os objetos CounterSet são enviados para baixo do pipeline. Sort-Object usa o parâmetro Property para especificar que os objetos são classificados por CounterSetName. Os objetos são enviados pelo pipeline para Format-Table. O parâmetro AutoSize ajusta as larguras da coluna para minimizar o truncamento.
O ponto (.) na coluna MachineName representa o computador local.
Exemplo 5: executar um trabalho em segundo plano para obter dados de contador
Neste exemplo, Start-Job executa um Get-Counter comando como um trabalho em segundo plano no computador local.
Para exibir a saída do contador de desempenho do trabalho, use o Receive-Job cmdlet .
Start-Job -ScriptBlock {Get-Counter -Counter "\LogicalDisk(_Total)\% Free Space" -MaxSamples 1000}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Running True localhost Get-Counter -CounterStart-Job usa o parâmetro ScriptBlock para executar um Get-Counter comando. Get-Counter usa o parâmetro Counter para especificar o caminho \LogicalDisk(_Total)\% Free Spacedo contador . O parâmetro MaxSamples especifica para obter 1000 amostras do contador.
Exemplo 6: Obter dados de contador de vários computadores
Este exemplo usa uma variável para obter dados de contador de desempenho de dois computadores.
$DiskReads = "\LogicalDisk(C:)\Disk Reads/sec"
$DiskReads | Get-Counter -ComputerName Server01, Server02 -MaxSamples 10
Timestamp CounterSamples
--------- --------------
6/21/2019 10:51:04 \\Server01\logicaldisk(c:)\disk reads/sec :
0
\\Server02\logicaldisk(c:)\disk reads/sec :
0.983050344269146A $DiskReads variável armazena o caminho do \LogicalDisk(C:)\Disk Reads/sec contador. A $DiskReads variável é enviada pelo pipeline para Get-Counter. Counter é o parâmetro de primeira posição e aceita o caminho armazenado em $DiskReads. ComputerName especifica os dois computadores e MaxSamples especifica para obter 10 amostras de cada computador.
Exemplo 7: Obter valores de instância de um contador de vários computadores aleatórios
Este exemplo obtém o valor de um contador de desempenho em 50 computadores remotos aleatórios na empresa. O parâmetro ComputerName usa nomes de computador aleatórios armazenados em uma variável. Para atualizar os nomes de computador na variável, recrie a variável.
Uma alternativa para os nomes de servidor no parâmetro ComputerName é usar um arquivo de texto. Por exemplo:
-ComputerName (Get-Random (Get-Content -Path C:\Servers.txt) -Count 50)
O caminho do contador inclui um asterisco (*) no nome da instância para obter os dados de cada um dos processadores do computador remoto.
$Servers = Get-Random (Get-Content -Path C:\Servers.txt) -Count 50
$Counter = "\Processor(*)\% Processor Time"
Get-Counter -Counter $Counter -ComputerName $Servers
Timestamp CounterSamples
--------- --------------
6/20/2019 12:20:35 \\Server01\processor(0)\% processor time :
6.52610319637854
\\Server01\processor(1)\% processor time :
3.41030663625782
\\Server01\processor(2)\% processor time :
9.64189975649925
\\Server01\processor(3)\% processor time :
1.85240835619747
\\Server01\processor(_total)\% processor time :
5.35768447160776O Get-Random cmdlet usa para selecionar 50 nomes de computador aleatórios Get-Content no arquivo Servers.txt . Os nomes de computador remoto são armazenados na $Servers variável . O \Processor(*)\% Processor Time caminho do contador é armazenado na $Counter variável . Get-Counter usa o parâmetro Counter para especificar os contadores na $Counter variável . O parâmetro ComputerName especifica os nomes de computador na $Servers variável .
Exemplo 8: usar a propriedade Path para obter nomes de caminho formatados
Este exemplo usa a propriedade Path de um contador definido para localizar os nomes de caminho formatados para os contadores de desempenho.
O pipeline é usado com o Where-Object cmdlet para localizar um subconjunto dos nomes de caminho. Para localizar uma lista completa de caminhos de contador de conjuntos de contadores, remova o pipeline (|) e Where-Object o comando .
O $_ é uma variável automática para o objeto atual no pipeline.
Para obter mais informações, confira about_Automatic_Variables.
(Get-Counter -ListSet Memory).Paths | Where-Object { $_ -like "*Cache*" }
\Memory\Cache Faults/sec
\Memory\Cache Bytes
\Memory\Cache Bytes Peak
\Memory\System Cache Resident Bytes
\Memory\Standby Cache Reserve Bytes
\Memory\Standby Cache Normal Priority Bytes
\Memory\Standby Cache Core Bytes
\Memory\Long-Term Average Standby Cache Lifetime (s)Get-Counter usa o parâmetro ListSet para especificar o conjunto de contadores de memória . O comando é colocado entre parênteses para que a propriedade Paths retorne cada caminho como uma cadeia de caracteres. Os objetos são enviados pelo pipeline para Where-Object. Where-Object usa a variável $_ para processar cada objeto e usa o parâmetro like para localizar correspondências para a cadeia de caracteres *Cache*. Os asteriscos (*) são curingas para qualquer caractere.
Exemplo 9: usar a propriedade PathsWithInstances para obter nomes de caminho formatados
Este exemplo obtém os nomes de caminho formatados que incluem as instâncias para os contadores de desempenho do PhysicalDisk .
(Get-Counter -ListSet PhysicalDisk).PathsWithInstances
\PhysicalDisk(0 C:)\Current Disk Queue Length
\PhysicalDisk(_Total)\Current Disk Queue Length
\PhysicalDisk(0 C:)\% Disk Time
\PhysicalDisk(_Total)\% Disk Time
\PhysicalDisk(0 C:)\Avg. Disk Queue Length
\PhysicalDisk(_Total)\Avg. Disk Queue Length
\PhysicalDisk(0 C:)\% Disk Read Time
\PhysicalDisk(_Total)\% Disk Read TimeGet-Counter usa o parâmetro ListSet para especificar o conjunto de contadores PhysicalDisk . O comando é colocado entre parênteses para que a propriedade PathsWithInstances retorne cada instância de caminho como uma cadeia de caracteres.
Exemplo 10: Obter um único valor para cada contador em um conjunto de contadores
Neste exemplo, um único valor é retornado para cada contador de desempenho no conjunto de contadores memória do computador local.
$MemCounters = (Get-Counter -ListSet Memory).Paths
Get-Counter -Counter $MemCounters
Timestamp CounterSamples
--------- --------------
6/19/2019 12:05:00 \\Computer01\memory\page faults/sec :
868.772077545597
\\Computer01\memory\available bytes :
9031176192
\\Computer01\memory\committed bytes :
8242982912
\\Computer01\memory\commit limit :
19603333120Get-Counter usa o parâmetro ListSet para especificar o conjunto de contadores de memória . O comando é colocado entre parênteses para que a propriedade Paths retorne cada caminho como uma cadeia de caracteres. Os caminhos são armazenados na $MemCounters variável . Get-Counter usa o parâmetro Counter para especificar os caminhos do contador na $MemCounters variável.
Exemplo 11: Exibir valores de propriedade de um objeto
Os valores de propriedade no objeto PerformanceCounterSample representam cada exemplo de dados. Neste exemplo, usamos as propriedades do objeto CounterSamples para examinar, selecionar, classificar e agrupar os dados.
$Counter = "\\Server01\Process(Idle)\% Processor Time"
$Data = Get-Counter $Counter
$Data.CounterSamples | Format-List -Property *
Path : \\Server01\process(idle)\% processor time
InstanceName : idle
CookedValue : 198.467899571389
RawValue : 14329160321003
SecondValue : 128606459528326201
MultipleCount : 1
CounterType : Timer100Ns
Timestamp : 6/19/2019 12:20:49
Timestamp100NSec : 128606207528320000
Status : 0
DefaultScale : 0
TimeBase : 10000000O caminho do contador é armazenado na $Counter variável . Get-Counter obtém um exemplo dos valores do contador e armazena os resultados na $Data variável . A $Data variável usa a propriedade CounterSamples para obter as propriedades do objeto. O objeto é enviado pelo pipeline para Format-List. O parâmetro Property usa um curinga asterisco (*) para selecionar todas as propriedades.
Exemplo 12: Valores de matriz do contador de desempenho
Neste exemplo, uma variável armazena cada contador de desempenho. A propriedade CounterSamples é uma matriz que pode exibir valores de contador específicos.
Para exibir cada exemplo de contador, use $Counter.CounterSamples.
$Counter = Get-Counter -Counter "\Processor(*)\% Processor Time"
$Counter.CounterSamples[0]
Path InstanceName CookedValue
---- ------------ -----------
\\Computer01\processor(0)\% processor time 0 1.33997091699662Get-Counter usa o parâmetro Counter para especificar o contador \Processor(*)\% Processor Time. Os valores são armazenados na $Counter variável .
$Counter.CounterSamples[0] exibe o valor da matriz para o primeiro valor do contador.
Exemplo 13: comparar valores de contador de desempenho
Este exemplo localiza a quantidade de tempo do processador usado por cada processador no computador local. A propriedade CounterSamples é usada para comparar os dados do contador com um valor especificado.
Para exibir cada exemplo de contador, use $Counter.CounterSamples.
$Counter = Get-Counter -Counter "\Processor(*)\% Processor Time"
$Counter.CounterSamples | Where-Object { $_.CookedValue -lt "20" }
Path InstanceName CookedValue
---- ------------ -----------
\\Computer01\processor(0)\% processor time 0 12.6398025240208
\\Computer01\processor(1)\% processor time 1 15.7598095767344Get-Counter usa o parâmetro Counter para especificar o contador \Processor(*)\% Processor Time. Os valores são armazenados na $Counter variável . Os objetos armazenados em $Counter.CounterSamples são enviados pelo pipeline. Where-Object usa um bloco de script para comparar cada valor de objetos com um valor especificado de 20. O $_.CookedValue é uma variável para o objeto atual no pipeline. Contadores com um CookedValue menor que 20 são exibidos.
Exemplo 14: Classificar dados do contador de desempenho
Este exemplo mostra como classificar dados do contador de desempenho. O exemplo localiza os processos no computador que estão usando mais tempo de processador durante o exemplo.
$Procs = Get-Counter -Counter "\Process(*)\% Processor Time"
$Procs.CounterSamples | Sort-Object -Property CookedValue -Descending |
Format-Table -Property Path, InstanceName, CookedValue -AutoSize
Path InstanceName CookedValue
---- ------------ -----------
\\Computer01\process(_total)\% processor time _total 395.464129650573
\\Computer01\process(idle)\% processor time idle 389.356575524695
\\Computer01\process(mssense)\% processor time mssense 3.05377706293879
\\Computer01\process(csrss#1)\% processor time csrss 1.52688853146939
\\Computer01\process(microsoftedgecp#10)\% processor time microsoftedgecp 1.52688853146939
\\Computer01\process(runtimebroker#5)\% processor time runtimebroker 0
\\Computer01\process(settingsynchost)\% processor time settingsynchost 0
\\Computer01\process(microsoftedgecp#16)\% processor time microsoftedgecp 0Get-Counter usa o parâmetro Counter para especificar o \Process(*)\% Processor Time contador para todos os processos no computador local. O resultado é armazenado na variável $Procs. A $Procs variável com a propriedade CounterSamples envia os objetos PerformanceCounterSample para baixo no pipeline. Sort-Object usa o parâmetro Property para classificar os objetos por CookedValue em ordem decrescente . Format-Table usa o parâmetro Property para selecionar as colunas para a saída. O parâmetro AutoSize ajusta as larguras de coluna para minimizar o truncamento.
Parâmetros
-ComputerName
Especifica um nome de computador ou uma matriz separada por vírgulas de nomes de computador remoto . Use o nome NetBIOS, um endereço IP ou o nome de domínio totalmente qualificado do computador.
Para obter dados do contador de desempenho do computador local , exclua o parâmetro ComputerName .
Para saída como um ListSet que contém a coluna MachineName , um ponto (.) indica o computador local.
Get-Counter não depende da comunicação remota do PowerShell. Você pode usar o parâmetro ComputerName mesmo se o computador não estiver configurado para executar comandos remotos.
| Type: | String[] |
| Aliases: | Cn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Continuous
Quando o Contínuo é especificado, Get-Counter obtém exemplos até pressionar CTRL+C. Os exemplos são obtidos a cada segundo para cada contador de desempenho especificado. Use o parâmetro SampleInterval para aumentar o intervalo entre amostras contínuas.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Counter
Especifica o caminho para um ou mais caminhos de contador. Os caminhos são inseridos como uma matriz separada por vírgulas, uma variável ou valores de um arquivo de texto. Você pode enviar cadeias de caracteres de caminho do contador pelo pipeline para Get-Counter.
Os caminhos do contador usam a seguinte sintaxe:
\\ComputerName\CounterSet(Instance)\CounterName
\CounterSet(Instance)\CounterName
Por exemplo:
\\Server01\Processor(*)\% User Time
\Processor(*)\% User Time
O \\ComputerName é opcional em um caminho de contador de desempenho. Se o caminho do contador não incluir o nome do computador, Get-Counter o usará o computador local.
Um asterisco (*) na instância é um caractere curinga para obter todas as instâncias do contador.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-ListSet
Listas os conjuntos de contadores de desempenho nos computadores. Use um asterisco (*) para especificar todos os conjuntos de contadores. Insira um nome ou uma cadeia de caracteres separada por vírgulas de nomes de conjunto de contadores. Você pode enviar nomes de conjunto de contadores pelo pipeline.
Para obter um contador define caminhos de contador formatados, use o parâmetro ListSet . As propriedades Paths e PathsWithInstances de cada conjunto de contadores contêm os caminhos de contador individuais formatados como uma cadeia de caracteres.
Você pode salvar as cadeias de caracteres de caminho do contador em uma variável ou usar o pipeline para enviar a cadeia de caracteres para outro Get-Counter comando.
Por exemplo, para enviar cada caminho de contador do Processador para Get-Counter:
Get-Counter -ListSet Processor | Get-Counter
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-MaxSamples
Especifica o número de amostras a serem obtidos de cada contador de desempenho especificado. Para obter um fluxo constante de exemplos, use o parâmetro Continuous .
Se o parâmetro MaxSamples não for especificado, Get-Counter só obterá uma amostra para cada contador especificado.
Para coletar um conjunto de dados grande, execute Get-Counter como um trabalho em segundo plano do PowerShell. Para obter mais informações, consulte about_Jobs.
| Type: | Long |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SampleInterval
Especifica o número de segundos entre exemplos para cada contador de desempenho especificado. Se o parâmetro SampleInterval não for especificado, Get-Counter usará um intervalo de um segundo.
| Type: | Int |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
String[]
Get-Counter aceita a entrada de pipeline para caminhos de contador e nomes de conjunto de contadores.
Saídas
Microsoft.PowerShell.Commands.GetCounter.CounterSet, Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet, Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSample
Para exibir as propriedades de um objeto, envie a saída pelo pipeline para Get-Member. Os tipos de objeto que são saída são os seguintes:
Parâmetro ListSet : Microsoft.PowerShell.Commands.GetCounter.CounterSet
Parâmetro de contador: Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet
Propriedade CounterSamples : Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSample
Observações
Se nenhum parâmetro for especificado, Get-Counter obterá um exemplo para cada contador de desempenho especificado. Use os parâmetros MaxSamples e Continuous para obter mais exemplos.
Get-Counter usa um intervalo de um segundo entre amostras. Use o parâmetro SampleInterval para aumentar o intervalo.
Os valores MaxSamples e SampleInterval se aplicam a todos os contadores em cada computador no comando . Para definir valores diferentes para contadores diferentes, insira comandos separados Get-Counter .