PwrTest の構文
PwrTestは、コマンド プロンプト ウィンドウから実行します。 コマンド オプションを使用して、 PwrTest Scenarios を選択して構成できます。
PwrTest ツールの構文は、以下のとおりです。
pwrtest /scenario [/scenario_options] [/common_options]
/scenario
| シナリオ | 説明 |
|---|---|
| sleep | スリープ/再開の切り替えを通じてコンピューターを循環させます。 (Windows 7 以降) |
| battery | バッテリ情報と監視を提供します。 (Windows 7 以降) |
| info | システム電源情報を提供します。 (Windows 7 以降) |
| es | スレッドの実行状態を監視します。 (Windows 7 以降) |
| アイドル | システム アイドル イベントを監視します。 (Windows 7 以降) |
| ppm | プロセッサの電源管理を監視します。 (Windows 7 以降) |
| タイマー | システム タイマー分解能の変更を監視します。 (Windows 7 以降) |
| disk | ディスクアイドル統計とスピンダウン イベントを監視します。 (Windows 7 以降) |
| device | デバイスのアイドル状態の統計情報と電源ダウン イベントを監視します。 (Windows 7 以降) |
| 監視 | モニター/ディスプレイの自動調光とブランクに関連するユーザーのアイドル状態の統計を記録します。(Windows 7 以降) |
| requests | 未処理の電源要求と新しい電源要求を表示します。 (Windows 7 以降) |
| 温度 | ACPI 温度ゾーンの情報と統計情報を監視します。 このシナリオは、温度ゾーンと温度変化を報告するシステムでのみサポートされます。 (Windows 7 以降)。 |
| プロセスアイドル | バックグラウンド メインテナント タスクを (スケジュールされた時刻ではなく) 強制的に実行し、進行状況を監視します。 (Windows 7 以降) |
| cs | コンピューターがシステムでサポートされている場合は、コネクト スタンバイの切り替えを循環させます。 (Windows 8 以降) |
| プラットアイドル | システムでサポートされている場合は、プラットフォームのアイドル状態の遷移数を監視してログに記録しようとします。 (Windows 8 以降) |
| ディレクテッドエフエックス | Directed Power Management Framework (DFx)に関連する低電力アイドル状態スイッチを監視します。 (Windows10、バージョン1903以降) |
/シナリオ- オプション
各 Pwrtest シナリオで使用可能なオプションを表示するには、「 pwrtest.exe /scenario /?
例: pwrtest.exe /sleep /?
/共通オプション
| 共通オプション | 説明 |
|---|---|
| /lf:folder | ログファイルのフォルダを指定します。 たとえば、c:\myfolder や \\server\share です。 既定のログの場所は、pwrtest.exeと同じフォルダーです。 |
| /ln:name | ログ ファイルの名前と、Windows イベント トレーシング (ETW) トレース セッションの名前を指定します。 ログ ファイル拡張子は自動的に追加されます (.wtl、.xmlなど)。 既定の名前は pwrtestlog です。 |
| /etwbuffersize:n | 既定のサイズより大きい場合は、ETW バッファー サイズをKB (キロバイト)で指定します。 既定値は、現在のページ サイズまたは 256 KB (キロバイト) (いずれか大きい方) です。 |
| /etwminbuffers:n | 論理プロセッサあたり最小 2 を超える場合に、ETW セッションに割り当てられるバッファーの最小数を指定します。 既定値は、論理プロセッサあたり 2 バッファーです。 |
| /etwmaxbuffers:n | ETW セッションに割り当てられるバッファーの最大数を指定します。その数が論理プロセッサあたり最小 2 を超え、etwminbuffers 設定よりも大きい場合です。 既定値は etwminbuffers 値 + 20 です。 |
| /delaywrite | ディスクの書き込みを減らすために、ログ データをメモリにバッファーするように指定します。 このオプションは、ETL を含むすべてのログの種類に影響します。 |
使用例
pwrtest /?
pwrtest /requests /?
pwrtest /requests /t:60
解説
ETW トレースをサポートするための実行要件:
Pwrtest は、管理者または管理者特権の コマンド プロンプト ウィンドウ (管理者として実行) から実行する必要があります。
Pwrtest はネイティブに実行する必要があります (WoW64 はサポートされていません)。
システム管理者によって設定されたグループ ポリシー設定は、電源設定値を一時的に変更する必要がある一部のシナリオ (スリープ シナリオなど) に干渉する可能性があります。
PwrTest では、.log (プレーンテキスト)、.xml (シナリオによって形式が異なります)、.wtl (WTTLog)、および .etl (ETW トレース) の各ログ形式で、実行ごとに複数のログが自動的に生成されます。
すべての PwrTest シナリオを使用できるようにするには、まずVisual Studio と WDK を使用してテストするためのテスト コンピューターをプロビジョニングする必要があります。 詳細については、 「ドライバーの展開とテスト用にコンピューターをプロビジョニングする (WDK 8.1)」 または 「ドライバーの展開とテスト用にコンピューターをプロビジョニングする (WDK 8)」を参照してください。 一部のシナリオでは、Windows Driver Testing Framework (WDTF) の一部である電源ボタン ドライバーが必要です。 Visual Studio と WDK を使用してテストするためのシステムをプロビジョニングすると、WDTF (および付属の電源ボタン ドライバー) が自動的にインストールされます。 WDTF の詳細については、「Windows デバイス テスト フレームワーク (WDTF) (Windows ドライバー)」を参照してください。