Get-Counter

  • 参考
模块:
Microsoft.PowerShell.Diagnostics

从本地和远程计算机获取性能计数器数据。

语法

Get-Counter
   [[-Counter] <String[]>]
   [-SampleInterval <Int32>]
   [-MaxSamples <Int64>]
   [-Continuous]
   [-ComputerName <String[]>]
   [<CommonParameters>]
Get-Counter
   [-ListSet] <String[]>
   [-ComputerName <String[]>]
   [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

Get-Counter cmdlet 直接从 Windows 操作系统系列中的性能监视检测获取性能计数器数据。 Get-Counter 从本地计算机或远程计算机获取性能数据。

可以使用 Get-Counter 参数指定一台或多台计算机、列出性能计数器集及其包含的实例、设置样本间隔并指定最大样本数。 如果没有参数，Get-Counter 会获取一组系统计数器的性能计数器数据。

许多计数器集受访问控制列表 (ACL) 的保护。 若要查看所有计数器集，请使用“以管理员身份运行”选项打开 PowerShell。

此 cmdlet 在 PowerShell 7 中重新引入。

注意

性能计数器名称已本地化。 此处显示的示例使用性能对象、计数器和实例的英文名称。 名称在使用另一种语言的系统上将有所不同。 使用 Get-Counter -ListSet 命令查看本地化名称。

示例

示例 1：获取计数器集列表

此示例会获取本地计算机的计数器集列表。

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 使用带星号 (*) 的 ListSet 参数来获取计数器集的列表。 MachineName 列中的点 (.) 表示本地计算机。

示例 2：指定 SampleInterval 和 MaxSamples

此示例获取本地计算机上所有处理器的计数器数据。 数据以两秒间隔收集，直到有三个样本。

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.5968799396998

Get-Counter 使用 Counter 参数指定计数器路径 \Processor(_Total)\% Processor Time。 SampleInterval 参数设置一个两秒间隔来检查计数器。 MaxSamples 确定 3 是检查计数器的最大次数。

示例 3：获取计数器的连续样本

此示例每秒获取计数器的连续样本。 若要停止该命令，请按 CTRL+C。 若要指定样本之间的较长间隔，请使用 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.5901500127408

Get-Counter 使用 Counter 参数来指定 \Processor\% Processor Time 计数器。 Continuous 参数指定每秒获取样本，直到使用 CTRL+C 停止命令。

示例 4：计数器集的字母顺序列表

此示例使用管道获取计数器列表集，然后按字母顺序对列表进行排序。

Get-Counter -ListSet * |
  Sort-Object -Property CounterSetName |
    Format-Table CounterSetName, CounterSetType -AutoSize

CounterSetName                        CounterSetType
--------------                        --------------
.NET CLR Data                         SingleInstance
.NET Data Provider for SqlServer      SingleInstance
AppV Client Streamed Data Percentage  SingleInstance
Authorization Manager Applications    SingleInstance
BitLocker                             MultiInstance
Bluetooth Device                      SingleInstance
Cache                                 SingleInstance
Client Side Caching                   SingleInstance

Get-Counter 使用带星号 (*) 的 ListSet 参数来获取计数器集的完整列表。 CounterSet 对象会沿着管道发送。 Sort-Object 使用 Property 参数指定对象按 CounterSetName 排序。 对象沿着管道发送到 Format-Table。 AutoSize 参数调整列宽以最大程度地减少截断。

MachineName 列中的点 (.) 表示本地计算机。

示例 5：运行后台作业以获取计数器数据

在此示例中，Start-Job 在本地计算机上以后台作业的形式运行 Get-Counter 命令。 若要查看作业的性能计数器输出，请使用 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 -Counter

Start-Job 使用 ScriptBlock 参数来运行 Get-Counter 命令。 Get-Counter 使用 Counter 参数指定计数器路径 \LogicalDisk(_Total)\% Free Space。 MaxSamples 参数指定获取计数器的 1000 个样本。

示例 6：从多台计算机获取计数器数据

此示例使用变量从两台计算机获取性能计数器数据。

$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.983050344269146

$DiskReads 变量存储 \LogicalDisk(C:)\Disk Reads/sec 计数器路径。 $DiskReads 变量沿着管道发送到 Get-Counter。 Counter 是第一个位置参数，接受存储在 $DiskReads 中的路径。 ComputerName 指定两台计算机，MaxSamples 指定从每台计算机获取 10 个样本。

示例 7：从多个随机计算机获取计数器的实例值

此示例获取企业中 50 台随机远程计算机上的性能计数器的值。 ComputerName 参数使用存储在变量中的随机计算机名。 若要更新变量中的计算机名称，请重新创建该变量。

ComputerName 参数中的服务器名称的替代方法是使用文本文件。 例如：

-ComputerName (Get-Random (Get-Content -Path C:\Servers.txt) -Count 50)

计数器路径包括实例名称中的星号 (*)，以获取每个远程计算机的处理器的数据。

$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.35768447160776

Get-Random cmdlet 使用 Get-Content 从 Servers.txt 文件中选择 50 个随机计算机名称。 远程计算机名称存储在 $Servers 变量中。 \Processor(*)\% Processor Time 计数器的路径存储在 $Counter 变量中。 Get-Counter 使用 Counter 参数来指定 $Counter 变量中的计数器。 ComputerName 参数指定 $Servers 变量中的计算机名称。

示例 8：使用 Path 属性获取格式化的路径名称

此示例使用计数器集的 Path 属性查找性能计数器的格式化路径名称。

管道与 Where-Object cmdlet 一起用于查找路径名的子集。 若要查找计数器路径的计数器集完整列表，请删除管道 (|) 和 Where-Object 命令。

$_ 是管道中当前对象的自动变量。 有关详细信息，请参阅 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 使用 ListSet 参数来指定 Memory 计数器集。 命令括在括号中，以便 Path 属性将每个路径作为字符串返回。 对象沿着管道发送到 Where-Object。 Where-Object 使用变量 $_ 处理每个对象，并使用 -like 运算符查找字符串 *Cache* 的匹配项。 星号 (*) 是任何字符的通配符。

示例 9：使用 PathsWithInstances 属性获取格式化的路径名称

此示例获取格式化的路径名称，其中包括 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 Time

Get-Counter 使用 ListSet 参数来指定 PhysicalDisk 计数器集。 该命令括在括号中，以便 PathsWithInstances 属性将每个路径实例作为字符串返回。

示例 10：获取计数器集中每个计数器的单个值

在此示例中，为本地计算机的 Memory 计数器集中的每个性能计数器返回单个值。

$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 :
                          19603333120

Get-Counter 使用 ListSet 参数来指定 Memory 计数器集。 命令括在括号中，以便 Path 属性将每个路径作为字符串返回。 路径存储在 $MemCounters 变量中。 Get-Counter 使用 Counter 参数来指定 $MemCounters 变量中的计数器路径。

示例 11：显示对象的属性值

PerformanceCounterSample 对象中的属性值表示每个数据示例。 在此示例中，我们使用 CounterSamples 对象的属性来检查、选择、排序和分组数据。

$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         : 10000000

计数器路径存储在 $Counter 变量中。 Get-Counter 获取计数器值的一个示例，并将结果存储在 $Data 变量中。 $Data 变量使用 CounterSamples 属性来获取对象的属性。 该对象沿着管道发送到 Format-List。 Property 参数使用星号 (*) 通配符来选择所有属性。

示例 12：性能计数器数组值

在此示例中，变量存储每个性能计数器。 CounterSamples 属性是可以显示特定计数器值的数组。

若要显示每个计数器示例，请使用 $Counter.CounterSamples。

$Counter = Get-Counter -Counter "\Processor(*)\% Processor Time"
$Counter.CounterSamples[0]

Path                                         InstanceName        CookedValue
----                                         ------------        -----------
\\Computer01\processor(0)\% processor time   0              1.33997091699662

Get-Counter 使用 Counter 参数来指定计数器 \Processor(*)\% Processor Time。 这些值存储在 $Counter 变量中。 $Counter.CounterSamples[0] 显示第一个计数器值的数组值。

示例 13：比较性能计数器值

此示例查找本地计算机上每个处理器使用的处理器时间量。 CounterSamples 属性用于将计数器数据与指定值进行比较。

若要显示每个计数器示例，请使用 $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.7598095767344

Get-Counter 使用 Counter 参数来指定计数器 \Processor(*)\% Processor Time。 这些值存储在 $Counter 变量中。 存储在 $Counter.CounterSamples 中的对象将沿管道发送。 Where-Object 使用脚本块将每个对象值与指定的 20 值进行比较。 $_.CookedValue 是管道中当前对象的变量。 将显示 CookedValue 小于 20 的计数器。

示例 14：对性能计数器数据进行排序

此示例演示如何对性能计数器数据进行排序。 此示例在计算机上查找采样期间使用处理器时间最多的进程。

$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                    0

Get-Counter 使用 Counter 参数为本地计算机上所有进程的指定 \Process(*)\% Processor Time 计数器。 结果存储在 $Procs 变量中。 具有 CounterSamples 属性的 $Procs 变量将沿管道发送 PerformanceCounterSample 对象。 Sort-Object 使用 Property 参数按 CookedValue 以降序排列对象。 Format-Table 使用 Property 参数为输出选择列。 AutoSize 参数调整列宽以最大程度地减少截断。

参数

-ComputerName

指定一个计算机名称或以逗号分隔的远程计算机名称数组。 使用 NetBIOS 名称、IP 地址或计算机的完全限定的域名。

若要从本地计算机获取性能计数器数据，请排除 ComputerName 参数。 对于包含 MachineName 列的 ListSet 等输出，点 (.) 指示本地计算机。

Get-Counter 不依赖于 PowerShell 远程处理。 即使计算机未配置为运行远程命令，也可以使用 ComputerName 参数。

Type:String[]
Aliases:Cn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Continuous

指定 Continuous 时，Get-Counter 会获取样本，直到你按 CTRL+C。 为每个指定的性能计数器每秒获取一次样本。 使用 SampleInterval 参数可增加连续样本之间的间隔。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Counter

指定一个或多个计数器路径的路径。 路径以逗号分隔的数组、变量或文本文件中值的形式输入。 可以将计数器路径字符串沿管道发送到 Get-Counter。

计数器路径使用以下语法：

\\ComputerName\CounterSet(Instance)\CounterName

\CounterSet(Instance)\CounterName

例如：

\\Server01\Processor(*)\% User Time

\Processor(*)\% User Time

性能计数器路径中的 \\ComputerName 是可选的。 如果计数器路径不包含计算机名称，则 Get-Counter 使用本地计算机。

实例中的星号 (*) 是一个通配符，用于获取计数器的所有实例。

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-ListSet

列出计算机上的性能计数器集。 使用星号 (*) 指定所有计数器集。 输入一个名称或以逗号分隔的计数器集名称字符串。 可以沿管道发送计数器集名称。

若要获取计数器集格式化的计数器路径，请使用 ListSet 参数。 每个计数器集的 Paths 和 PathsWithInstances 属性包含格式化为字符串的单个计数器路径。

可以将计数器路径字符串保存在变量中，或使用管道将字符串发送到另一个 Get-Counter 命令。

例如，将每个 Processor 计数器路径发送到 Get-Counter：

Get-Counter -ListSet Processor | Get-Counter

注意

在 PowerShell 7 中，Get-Counter 无法检索计数器集的 Description 属性。 Description 设置为 $null。

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-MaxSamples

指定要从每个指定的性能计数器获取的样本数。 若要获取样本的常量流，请使用 Continuous 参数。

如果未指定 MaxSamples 参数，则 Get-Counter 仅为每个指定的计数器获取一个样本。

若要收集大型数据集，请以 PowerShell 后台作业的形式运行 Get-Counter。 有关详细信息，请参阅 about_Jobs。

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SampleInterval

指定每个指定性能计数器的样本之间的秒数。 如果未指定 SampleInterval 参数，则 Get-Counter 使用一秒间隔。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

String[]

Get-Counter 接受计数器路径和计数器集名称的管道输入。

输出

CounterSet

使用 ListSet 参数时，此 cmdlet 返回 CounterSet 对象。

PerformanceCounterSampleSet

默认情况下，此 cmdlet 使用 Counter 参数返回 PerformanceCounterSampleSet 对象。

备注

如果未指定任何参数，Get-Counter 会为每个指定的性能计数器获取一个样本。 使用 MaxSamples 和 Continuous 参数获取更多样本。

Get-Counter 在样本间使用一秒间隔。 使用 SampleInterval 参数来增加间隔。

MaxSamples 和 SampleInterval 值适用于命令中每台计算机上的所有计数器。 若要为不同的计数器设置不同的值，请输入单独的 Get-Counter 命令。

在 PowerShell 7 中使用 ListSet 参数时，Get-Counter 无法检索计数器集的 Description 属性。 Description 设置为 $null。