PowerShellコマンドレット虎の巻

Import-Counter

Import-Counterは、パフォーマンスカウンタをImportするコマンドです。

エイリアスなし

解説

パフォーマンスカウンターデータをログファイルからインポートします。

BLG形式、CSV形式、TSV形式のファイルからインポートできます。
インポートしたデータをPowerShellオブジェクトとして扱い分析や処理が可能です。

構文

(構文)
Import-Counter [-Path] <string[]> [<CommonParameters>]
【主要パラメータ】
パラメータ説明
-Path パス対象パスを指定する(ワイルドカード使用可)
(例)-Path "D:\test*"
-ListSet カウンタセット名指定したカウンタセットを取得
("*"を指定した場合は全てが対象)
-StartTime 日時指定日時以降のデータのみ対象とする
-EndTime 日時指定日時以前のデータのみ対象とする
-Counter カウンタ名指定したカウンタのみインポートする
-Summary要約を取得する
-MaxSamples サンプル数インポートするサンプル数を指定する

共通的なパラメータは「共通パラメータ」をご覧ください。

サンプル

BLGファイルからカウンターデータをインポートする

Import-Counter -Path "C:\CounterMonitor.blg"

複数のBLGファイルからカウンターデータをインポートする

Import-Counter -Path "C:\CounterMonitor1.blg", "C:\CounterMonitor2.blg"

サンプル数を指定してカウンターデータをインポートする

Import-Counter -Path "C:\CounterMonitor.blg" -MaxSamples 100

CSVファイルからカウンターデータをインポートする

Import-Counter -Path "C:\CounterMonitor.csv"

特定のカウンターのみをインポートする

Import-Counter -Path "C:\\CounterMonitor.blg" -Counter "\Processor(_Total)\% Processor Time"

ログファイルの概要情報を取得する

Import-Counter -Path "C:\CounterMonitor.blg" -Summary

特定の時間範囲のデータのみインポートする

$start = Get-Date "2024-08-01 09:00:00" $end = Get-Date "2024-08-31 23:59:59" Import-Counter -Path "C:\CounterMonitor.blg" -StartTime $start -EndTime $end

コマンドのヘルプを表示する

Get-Help Import-Counter

備考

  • blgログは1回のコマンドで最大32ファイルをインポートできます。

関連項目