Get-Counter

[アーティクル]
10/30/2009

ローカルコンピューターおよびリモートコンピューターからパフォーマンスカウンターデータを取得します。

構文

Get-Counter [-Counter] <string[]> [-ComputerName <string[]>] [-Continuous] [-MaxSamples <Int64>] [-SampleInterval <int>] [<CommonParameters>]

Get-Counter -ListSet <string[]> [-ComputerName <string[]>] [<CommonParameters>]

説明

Get-Counter コマンドレットは、Windows のパフォーマンスモニターインストルメンテーションから直接リアルタイムのパフォーマンスカウンターデータをライブで取得します。このコマンドレットを使用して、指定したサンプル間隔でローカルコンピューターまたはリモートコンピューターからパフォーマンスデータを取得できます。

パラメーターを指定しなかった場合、"Get-Counter" コマンドは、一連のシステムカウンターに関するカウンターデータを取得します。

Get-Counter のパラメーターを使用すると、1 つまたは複数のコンピューターを指定したり、パフォーマンスカウンターセットとそのセットに含まれているカウンターを一覧表示したり、サンプルサイズと間隔を設定したりできます。

パラメーター

-ComputerName <string[]>

指定されたコンピューターからデータを取得します。コンピューターの NetBIOS 名、インターネットプロトコル (IP) アドレス、または完全修飾ドメイン名を入力します。既定値はローカルコンピューターです。

注: Get-Counter は、Windows PowerShell リモート処理に依存しません。コンピューターが Windows PowerShell リモート処理用に構成されていない場合でも、Get-Counter の ComputerName パラメーターを使用できます。

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Continuous

ユーザーが Ctrl キーを押しながら C キーを押すまで、サンプルを継続的に取得します。既定では、Get-Counter はカウンターサンプルを 1 つだけ取得します。SampleInterval パラメーターを使用すると、継続的サンプリングの間隔を設定できます。

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Counter <string[]>

指定されたパフォーマンスカウンターからデータを取得します。1 つ以上のカウンターパスを入力します。Instance 値にのみワイルドカードを使用できます。パイプを使用してカウンターパス文字列を Get-Counter に渡すこともできます。

各カウンターパスの形式は、次のとおりです。

"[\\<ComputerName>]\<CounterSet>(<Instance>)\<CounterName>"

次にその例を示します。

"\\Server01\Processor(2)\% User Time"

<ComputerName> 要素は省略可能です。省略すると、Get-Counter は ComputerName パラメーターの値を使用します。

注: 正しい形式のカウンターパスを取得するには、ListSet パラメーターを使用してパフォーマンスカウンターセットを取得します。各パフォーマンスカウンターセットの Paths プロパティおよび PathsWithInstances プロパティには、個々のカウンターパスが文字列形式で含まれています。カウンターパス文字列を変数に保存するか、パイプを使用して文字列を直接別の Get-Counter コマンドに渡すことができます。具体的な方法については、例を参照してください。

必須	true
位置	2
既定値
パイプライン入力を許可する	true (ByValue)
ワイルドカード文字を許可する	true

-ListSet <string[]>

コンピューター上の指定されたパフォーマンスカウンターセットを取得します。カウンターセットの名前を入力します。ワイルドカードを使用できます。パイプを使用してカウンターセット名を Get-Counter に渡すこともできます。

必須	true
位置	named
既定値
パイプライン入力を許可する	true (ByValue, ByPropertyName)
ワイルドカード文字を許可する	true

-MaxSamples <Int64>

各カウンターから取得するサンプルの数を指定します。既定は 1 サンプルです。サンプルを継続的に取得する (サンプルの最大サイズを指定しない) には、Continuous パラメーターを使用します。

非常に大きなデータセットを収集する場合は、Get-Counter コマンドを Windows PowerShell バックグラウンドジョブとして実行することを検討してください。詳細については、「about_Jobs」と「Start-Job」を参照してください。

必須	false
位置	named
既定値
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-SampleInterval <int>

サンプル間の時間を秒単位で指定します。最小値および既定値は 1 秒です。

必須	false
位置	named
既定値	1
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。詳細については、次を参照してください: about_Commonparameters.

入力と出力

入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。

入力

System.String[]

パイプを使用してカウンターパスおよびカウンターセット (ListSet) 名を Get-Counter に渡すことができます。

出力

Microsoft.PowerShell.Commands.GetCounter.CounterSet、Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet、Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSample

ListSet パラメーターは、Microsoft.PowerShell.Commands.GetCounter.CounterSet オブジェクトを取得します。Counter パラメーターは、Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet オブジェクトを取得します。各カウンター値は、Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSample オブジェクトです。

注

通常、パフォーマンスカウンターはアクセス制御リスト (ACL) によって保護されています。利用可能なすべてのパフォーマンスカウンターを取得するには、[管理者として実行] を指定して Windows PowerShell を開きます。

既定では、Get-Counter は 1 秒のサンプル間隔の間に 1 サンプルを取得します。この動作を変更するには、MaxSamples パラメーターと Continuous パラメーターを使用します。

設定した MaxSamples および SampleInterval の値は、そのコマンド内ですべてのコンピューター上のすべてのカウンターに適用されます。それぞれのカウンターに異なる値を設定するには、各カウンターに個別の Get-Counter コマンドを入力します。

例 1

C:\PS># Get-Counter

説明
-----------
このコマンドは、ローカル コンピューター上のすべてのカウンター セットを取得します。

C:\PS> get-counter -ListSet *

多くのカウンター セットはアクセス制御リスト (ACL) によって保護されているため、すべてのカウンター セットを確認するには、Get-Counter コマンドを使用する前に、[管理者として実行] を指定して Windows PowerShell を開きます。

例 2

C:\PS># Get-Counter

説明
-----------
このコマンドは、ローカル コンピューター上にあるすべてのプロセッサの現在の "% Processor Time" 合計値を取得します。値の数が 3 つになるまで、2 秒ごとにデータが収集されます。

C:\PS> get-counter -Counter "\Processor(_Total)\% Processor Time" -SampleInterval 2 -MaxSamples 3

例 3

C:\PS># Get-Counter

説明
-----------
このコマンドは、ローカル コンピューター上のすべてのカウンター セット名をアルファベット順に並べ替えた一覧を取得します。

C:\PS> get-counter -listset * | sort-object  countersetname | format-table countersetname

例 4

C:\PS># Get-Counter

説明
-----------
これらのコマンドは、カウンター セットの Paths プロパティを使用して、パフォーマンス カウンターの正しい形式のパス名を検索します。このようなコマンドを使用し、正しいカウンター パス名を取得できます。

最初のコマンドは、ローカル コンピューター上の Memory カウンター セットにあるパフォーマンス カウンターのパス名を取得します。

C:\PS> (get-counter -listset memory).paths

\Memory\Page Faults/sec
\Memory\Available Bytes
\Memory\Committed Bytes
\Memory\Commit Limit
\Memory\Write Copies/sec
\Memory\Transition Faults/sec
\Memory\Cache Faults/sec
\Memory\Demand Zero Faults/sec
\Memory\Pages/sec
\Memory\Pages Input/sec
...

2 番目のコマンドは、"cache" を含むパス名を取得します。

C:\PS> (get-counter -listset memory).paths | where {$_ -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

例 5

C:\PS># Get-Counter

説明
-----------
これらのコマンドは、Server01 および Server02 コンピューターから Disk Reads/sec カウンター データを取得します。

最初のコマンドは、Disk Reads/sec カウンター パスを $diskreads 変数に保存します。

C:\PS> $diskreads = "\LogicalDisk(C:)\Disk Reads/sec"

2 番目のコマンドは、パイプライン演算子 (|) を使用して、$diskreads 変数に保存されているカウンター パスを Get-Counter コマンドレットに送ります。このコマンドは、MaxSamples パラメーターを使用して、出力されるサンプルの数を 10 個に制限します。

C:\PS> $diskreads | get-counter -computer Server01, Server02 -maxsamples 10

例 6

C:\PS># Get-Counter

説明
-----------
このコマンドは、PhysicalDisk パフォーマンス カウンターの正しい形式のパス名 (インスタンス名を含む) を取得します。

C:\PS> (get-counter -list physicaldisk).pathswithinstances

例 7

C:\PS># Get-Counter

説明
-----------
これらのコマンドは、エンタープライズ内の無作為に選択した 50 台のコンピューター上にある "% DPC Time" パフォーマンス カウンターの値を取得します。

最初のコマンドは、Get-Content コマンドレットを使用して、Servers.txt ファイルからエンタープライズ サーバーの一覧を取得します。次に、Get-Random コマンドレットを使用して、Servers.txt ファイルの内容から無作為に 50 個のサーバー名を選択します。結果は $servers 変数に保存されます。

C:\PS> $servers = get-random (get-content servers.txt) -count 50

2 番目のコマンドは、"% DPC Time" コマンドレットのカウンター パスを $counter 変数に保存します。カウンター パスでは、各コンピューターのすべてのプロセッサに関するデータを取得するために、インスタンス名にワイルドカード文字が含まれています。

C:\PS> $counter = "\Processor(*)\% DPC Time"

3 番目のコマンドは、Get-Counter コマンドレットを使用してカウンター値を取得します。このコマンドは、Counter パラメーターを使用してカウンターを指定し、ComputerName パラメーターを使用して $servers 変数に保存されているコンピューターを指定します。

C:\PS> get-counter -Counter $counter -computername $servers

例 8

C:\PS># Get-Counter

説明
-----------
これらのコマンドは、ローカル コンピューター上の memory カウンター セットにあるすべてのパフォーマンス カウンターに対して単一の値を取得します。

最初のコマンドは、カウンター パスを取得して、$memCounters 変数に保存します。

C:\PS> $memCounters = (get-counter -list memory).paths

2 番目のコマンドは、Get-Counter コマンドレットを使用して、各カウンターのカウンター データを取得します。また、Counter パラメーターを使用して、$memCounters 変数に保存されているカウンターを指定します。

C:\PS> get-counter -counter $memCounters

例 9

C:\PS># Get-Counter

説明
-----------
この例では、各データ サンプルを表す PerformanceCounterSample オブジェクトのプロパティ値を示します。

最初のコマンドは、カウンター パスを $counter 変数に保存します。

C:\PS> $counter = "\\SERVER01\Process(Idle)\% Processor Time"

2 番目のコマンドは、Get-Counter コマンドレットを使用して、カウンター値のサンプルを 1 つ取得します。結果は $data 変数に保存されます。

C:\PS> $data = get-counter $counter

3 番目のコマンドは、Format-List コマンドレットを使用して、サンプル セット オブジェクトのすべての CounterSamples プロパティを一覧表示します。

C:\PS> $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        : 7/15/2008 6:39:12 PM
Timestamp100NSec : 128606207528320000
Status           : 0
DefaultScale     : 0
TimeBase         : 10000000

CounterSamples オブジェクトのプロパティを使用して、データの確認、選択、並べ替え、およびグループ化を行うことができます。

例 10

C:\PS># Get-Counter

説明
-----------
このコマンドは、Get-Counter コマンドをバックグラウンド ジョブとして実行します。詳細については、「Start-Job」を参照してください。

C:\PS> $counters = "\LogicalDisk(_Total)\% Free Space"

C:\PS> start-job -scriptblock {get-counter -counter $counters -maxsamples 1000)

例 11

C:\PS># Get-Counter

説明
-----------
このコマンドは、Get-Counter および Get-Random コマンドレットを使用して、Servers.txt ファイルから無作為に選択した 50 台のコンピューター上の空きディスク領域の割合を調べます。

C:\PS> get-counter -computername (get-random servers.txt -count 50) -counter "\LogicalDisk(*)\% Free Space"

例 12

C:\PS># Get-Counter

説明
-----------
この例では、カウンター データとその生成元のコンピューターとを関連付ける方法、およびデータを操作する方法を示します。


最初のコマンドは、Get-Counter コマンドレットを使用して、S1 および S2 という 2 つのリモート コンピューターから "LogicalDisk\% Free Space" カウンター値を取得します。結果は $a 変数に保存されます。

$a = get-counter "\LogicalDisk(_Total)\% Free Space" -comp s1, s2



2 番目のコマンドは $a 変数に保存された結果を表示します。すべてのデータがオブジェクトに保存されますが、この形式では簡単に確認できません。

C:\PS> $a

Counter Paths: \\s1\\logicaldisk(c:)\% free space, \\s1\\logicaldisk(d:)\% free space, \\s1\\logicaldisk(_total)\% free space, \\s2\\logicaldisk(c:)\% free space, \\s2\\logicaldisk(_total)\% free space

Timestamp     : 7/15/2008 5:09:08 PM
Cooked Values : "0.327058823529412", "17.8952248493278", "12.9994033060778", "75.0754805595626", "75.0754805595626"



3 番目のコマンドは、Get-Counter により返された PerformanceCounterSampleSet オブジェクトの CounterSamples プロパティの値をテーブルとして表示します (オブジェクトのすべてのプロパティおよびメソッドを表示するには、パイプを使用してその値を Get-Member コマンドレットに渡します)。

C:\PS> $a.countersamples | format-table -auto

Path                                     InstanceName       CookedValue
----                                     ------------       -----------
\\s1\\logicaldisk(c:)\% free space       c:           0.327058823529412
\\s1\\logicaldisk(d:)\% free space       d:            17.8952248493278
\\s1\\logicaldisk(_total)\% free space   _total        12.9994033060778
\\s2\\logicaldisk(c:)\% free space       c:            75.0754805595626
\\s2\\logicaldisk(_total)\% free space   _total        75.0754805595626

CounterSamples プロパティには、PerformanceCounterSample オブジェクトがそのプロパティおよびメソッドと共に含まれています。4 番目のコマンドは、配列表記を使用して最初のカウンター サンプルを取得し、パイプライン演算子を使用してカウンター サンプル オブジェクトを Format-List コマンドレットに送信します。カウンター サンプルのすべてのプロパティおよびメソッドが一覧表示されます。この方法では、各カウンター サンプル オブジェクトに含まれるデータを詳細に表示できます。



5 番目のコマンドは、カウンター サンプルからデータを選択する方法を示しています。このコマンドは、Where-Object コマンドレットを使用して、15 未満の CookedValue を持つカウンター サンプルのみを取得します。

C:\PS> $a.countersamples | where {$_.cookedvalue -lt 15}

Path                                     InstanceName       CookedValue
----                                     ------------       -----------
\\s1\\logicaldisk(c:)\% free space       c:           0.327058823529412
\\s1\\logicaldisk(_total)\% free space   _total        12.9994033060778

例 13

C:\PS># Get-Counter

説明
-----------
この例では、取得したパフォーマンス カウンター データを並べ替える方法を示します。この例では、サンプリング時にプロセッサ時間が最も長いコンピューター上のプロセスを検索します。

最初のコマンドは、コンピューター上のすべてのプロセスの "Process\% Processor Time" カウンターを取得します。結果は $p 変数に保存されます。

C:\PS> $p = get-counter '\Process(*)\% Processor Time'


2 番目のコマンドは、$p に保存されているサンプル セット オブジェクトの CounterSamples プロパティを取得し、サンプルの処理済みの値 (CookedValue) に基づいてサンプルを降順に並べ替えます。このコマンドは、Format-Table コマンドレットとその AutoFormat パラメーターを使用し、テーブルの列を配置します。

C:\PS> $p.CounterSamples | sort-object -property CookedValue -Descending | format-table -auto

Path                                              InstanceName      CookedValue
----                                              ------------      -----------
\\server01\process(_total)\% processor time        _total        200.00641042078
\\server01\process(idle)\% processor time          idle          200.00641042078
\\server01\process(explorer#1)\% processor time    explorer                    0
\\server01\process(dwm#1)\% processor time         dwm                         0
\\server01\process(taskeng#1)\% processor time     taskeng                     0
\\server01\process(taskhost#1)\% processor time    taskhost                    0
\\server01\process(winlogon)\% processor time      winlogon                    0
\\server01\process(csrss)\% processor time         csrss                       0

例 14

C:\PS># Get-Counter

説明
-----------
これらのコマンドは、ワーキング セットが最大であるコンピューター上のプロセスを検索します。プロセスをワーキング セットのサイズに基づいて降順に一覧表示します。

最初のコマンドは、各プロセスの "Process\Working Set - Private" カウンターのサンプルを 1 つ取得します。このコマンドは、カウンター データを $ws 変数に保存します。

C:\PS> $ws = get-counter "\Process(*)\Working Set - Private"

2 番目のコマンドは、パイプライン演算子 (|) を使用して、$ws 変数の CounterSamples プロパティのデータを Sort-Object コマンドレットに送信し、プロセス データを CookedValue プロパティの値で降順に並べ替えます。また、別のパイプラインを使用して、並べ替えたデータを Format-Table コマンドレットに送信し、InstanceName 列および CookedValue 列を持つテーブルの形式でデータを表示します。

C:\PS> $ws.countersamples | sort-object -property cookedvalue -descending | format-table -property InstanceName, CookedValue -auto

InstanceName  CookedValue
------------  -----------
_total          162983936
svchost          40370176
powershell       15110144
explorer         14135296
svchost          10928128
svchost           9027584
...

例 15

C:\PS># Get-Counter

説明
-----------
このコマンドは、Processor\% Processor Time カウンターの一連のサンプルを既定の 1 秒間隔で取得します。コマンドを停止するには、Ctrl キーを押しながら C キーを押します。

C:\PS> get-counter -counter "\processor(_total)\% processor time" -continuous

次の方法で共有