Export-Counter

構文

Export-Counter
      [-Path] <String>
      [-FileFormat <String>]
      [-MaxSize <UInt32>]
      -InputObject <PerformanceCounterSampleSet[]>
      [-Force]
      [-Circular]
      [<CommonParameters>]

説明

Export-Counter コマンドレットは、パフォーマンス カウンター データ (PerformanceCounterSampleSet オブジェクト) をバイナリ パフォーマンス ログ (.blg)、コンマ区切り値 (.csv)、またはタブ区切り値 (.tsv) 形式でログ ファイルにエクスポートします。 このコマンドレットを使用して、パフォーマンス カウンター データをログに記録します。

Export-Counter コマンドレットは、Get-Counter および Import-Counter コマンドレットによって返されるデータをエクスポートするように設計されています。

このコマンドレットは、Windows 7、Windows Server 2008 R2、およびそれ以降のバージョンの Windows でのみ実行されます。

例

例 1: カウンター データをファイルにエクスポートする

次の使用例は、カウンター データを BLG ファイルにエクスポートします。

Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg

このコマンドは、Get-Counter コマンドレットを使用してプロセッサ時間データを収集します。 パイプライン演算子 (|) を使用して、Export-Counter コマンドレットにデータを送信します。 Export-Counter コマンドは、Path 変数を使用して出力ファイルを指定します。

データ セットは非常に大きくなる可能性があるため、この例ではパイプラインを介してデータを Export-Counter に送信します。 データが変数に保存されている場合は、不均衡な量のメモリを使用する可能性があります。

例 2: カウンター ファイル形式にファイルをエクスポートする

次の使用例は、CSV ファイルをカウンター データ BLG 形式に変換します。

Import-Counter コマンドレットは、Threads.csv ファイルからパフォーマンス カウンター データをインポートします。 この例では、Export-Counter コマンドレットを使用して、このファイルが以前にエクスポートされたと想定しています。 パイプライン演算子 (|) は、インポートされたデータを Export-Counter コマンドレットに送信します。 コマンドは、Path パラメーターを使用して、出力ファイルの場所を指定します。 循環 と MaxSize パラメーター を使用して、Export-Counter コマンドレットを指示し、1 GB でラップする循環ログを作成します。 MaxSize パラメーターはメガバイト単位で表されます。

$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB

例 3: リモート コンピューターからカウンター データを取得し、データをファイルに保存する

この例では、リモート コンピューターからパフォーマンス カウンター データを取得し、リモート コンピューター上のファイルにデータを保存する方法を示します。

最初のコマンドでは、Get-Counter コマンドレットを使用して、リモート コンピューターである Server01 からワーキング セット カウンター データを収集します。 このコマンドは、$C 変数にデータを保存します。

2 番目のコマンドでは、パイプライン演算子 (|) を使用して、$C のデータを Export-Counter コマンドレットに送信します。これにより、Workingset.blg ファイルが Server01 コンピューターの Perf 共有に保存されます。

$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

20

例 4: 既存のデータを再ログする

この例では、Import-Counter コマンドレットと Export-Counter コマンドレットを使用して既存のデータを再ログ記録する方法を示します。

最初のコマンドでは、Import-Counter コマンドレットを使用して、DiskSpace.blg ログからパフォーマンス カウンター データをインポートします。 $All 変数にデータが保存されます。 このファイルには、企業内の 200 台を超えるリモート コンピューターの "LogicalDisk% Free Space" カウンターのサンプルが含まれています。

2 番目のコマンドでは、Where-Object コマンドレットを使用して、CookedValue が 15 (パーセント) 未満のオブジェクトを選択します。 このコマンドは、結果を $LowSpace 変数に保存します。

3 番目のコマンドでは、パイプライン演算子 (|) を使用して、$LowSpace 変数のデータを Export-Counter コマンドレットに送信します。 このコマンドは、Path パラメーターを使用して、選択したデータを LowDiskSpace.blg ファイルに記録する必要があることを示します。

$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg

パラメーター

-Circular

-FileFormat

-Force

-InputObject

-MaxSize

-Path

入力

PerformanceCounterSampleSet

パフォーマンス カウンター データは、Get-Counter または Import-Counter からこのコマンドレットにパイプできます。

出力

None

メモ

ログ ファイル ジェネレーターは、すべての入力オブジェクトが同じカウンター パスを持ち、オブジェクトが昇順で配置されることを想定しています。

最初の入力オブジェクトのカウンターの種類とパスによって、ログ ファイルに記録されるプロパティが決まります。 他の入力オブジェクトに記録されたプロパティの値がない場合、プロパティ フィールドは空です。 オブジェクトに記録されなかったプロパティ値がある場合、追加のプロパティ値は無視されます。

パフォーマンス モニターでは、生成されるすべてのログ Export-Counter 読み取ることができない場合があります。 たとえば、パフォーマンス モニターでは、すべてのオブジェクトが同じパスを持ち、すべてのオブジェクトが同じ時間間隔で区切られている必要があります。

Import-Counter コマンドレットには、ComputerName パラメーターがありません。 ただし、コンピューターがリモート Windows PowerShell Windows PowerShell 用に構成されている場合は、Invoke-Command コマンドレットを使用して、リモート コンピューターで Import-Counter コマンドを実行できます。

関連リンク

• Get-Counter
• Import-Counter