VSPerfCmd
VSPerfCmd.exe ツールは、パフォーマンス データ収集を開始および停止するために使用します。このツールは、次の構文を使います。
VSPerfCmd [/U] [/options]
VSPerfCmd.exe ツールのオプションの説明を次の表に示します。
オプション |
Description |
---|---|
U |
リダイレクトされたコンソール出力は Unicode として書き込まれます。最初に指定する必要があります。 |
Start:mode |
プロファイリング サービスを指定されたモードで開始します。 |
Output:filename |
出力ファイル名を指定します。Start でのみ使用します。 |
Windows セッション全体でのプロファイリングを有効にします。Start、 Attach、 or Launch でのみ使用します。 |
|
User:[domain\]username |
プロファイラー サービスに指定したアカウントでアクセスできるようにします。Start でのみ使用します。 |
WaitStart[:n] |
データ コレクション ロガーの初期化が完了するのを待ちます。n を指定した場合、VSPerfCmd は最大で n 秒間待機します。n を指定しなかった場合、VSPerfCmd は無期限に待機します。これにより、バッチ処理の一部として VSPerfCmd を利用することが容易になります。 |
Counter:cfg |
サンプル プロファイリング方式を使用するときは、CPU カウンターおよびサンプリング間隔として使用するイベントの数を指定します。サンプリングできるカウンター値は 1 つだけです。 インストルメンテーション プロファイリング方式を使用するときに、各インストルメンテーション ポイントで収集する CPU カウンターを指定します。Start:Trace、 Attach、または Launch でのみ使用します。 |
現在のコンピューターの有効な CPU カウンターの一覧を表示します。 |
|
WinCounter:path |
プロファイル マーク データと共に含まれる Windows パフォーマンス カウンター イベントを指定します。Start でのみ使用します。 |
AutoMark:n |
Windows パフォーマンス カウンター データ コレクション イベント間の時間間隔 (ミリ秒単位) を指定します。WinCounter で使用します。 |
イベント:option |
指定された ETW (Event Tracing for Windows) イベントのコレクションを制御します。ETW データは、プロファイリング データ (.vsp) ファイルではない .itl ファイルに収集されます。 |
プロファイラーの状態、現在プロファイリングを行っているプロセスに関する情報、およびプロファイラーを制御する権限を持つアカウントを表示します。 |
|
Shutdown[:n] |
プロファイリング データ ファイルを閉じ、プロファイラーをオフにします。 |
VSPerfCmdGlobalOff を呼び出した後に、データ収集を再開します。 |
|
すべてのデータ収集を停止しますが、プロファイリング セッションは終了しません。 |
|
ProcessOn:pid |
VSPerfCmdProcessOff の呼び出しによってプロファイリングが停止された後に、指定されたプロセスに対してデータ収集を再開します。 |
ProcessOff:pid |
指定されたプロセスのデータ収集を停止します。 |
VSPerfCmdThreadOff の呼び出しによってプロファイリングが停止された後に、指定されたプロセスに対してプロファイリングを再開します。インストルメンテーショ方式でプロファイリングを行っている場合にのみ ThreadOn を使用します。 |
|
指定されたスレッドのプロファイリングを一時停止します。インストルメンテーショ方式でプロファイリングを行っている場合にのみ ThreadOff を使用します。 |
|
Mark:MarkNum[,MarkText] |
プロファイリング データ ファイルに、省略可能なテキストと共にマークを挿入します。 |
サンプリング方式のオプション
次のオプションは、サンプリング プロファイリング方式を使用している場合にのみ使用できます。
オプション |
Description |
---|---|
Launch:実行可能ファイル |
指定されたアプリケーションを起動し、プロファイリングを開始します。 |
Args:引数 |
起動したアプリケーションに渡されるコマンド ライン引数を指定します。 |
新しいコマンド プロンプト ウィンドウで指定されたコマンドを開始します。 |
|
Attach:PID[,PID] |
指定されたプロセスのプロファイリングを開始します。プロセスは、プロセス ID またはプロセス名で識別できます。 |
Detach[:PID[,PID]] |
指定されたプロセスのプロファイリングを停止します。プロセスは、プロセス ID またはプロセス名で識別できます。プロセスを指定しない場合、すべてのプロセスに対してプロファイリングが停止されます。 |
GC[:{Allocation|Lifetime}] |
.NET メモリの割り当ておよびオブジェクトの有効期間データを収集します。VSPerfCmdLaunch オプションでのみ使用します。 |
サンプリング間隔オプション
次のオプションを使用して、サンプリング間隔の種類と期間を指定します。既定値は、Timer です。Counter オプションを使用して間隔として CPU カウンターを指定することもできます。これらのオプションは Launch またはプロファイリング セッションの最初の Attach でのみ指定できます。
オプション |
Description |
---|---|
PF[:n] |
n 番目のページ フォールトごとにサンプリングを行います (既定 = 10)。 |
Sys (VSPerfCmd)[:n] |
n 番目のシステム コールごとにサンプリングを行います (既定 = 10)。 |
Timer[:n] |
n 番目のプロセッサ サイクルごとにサンプリングを行います (既定 = 10000000)。 |
サービス コンポーネントとカーネル モード デバイスのオプション
次の Admin オプションは、プロファイリング サービス コンポーネントまたはカーネル モード デバイス ドライバーの管理に使用できます。Admin オプションを使用して、プロファイリング権限を設定し、プロファイリングを行ったサービスまたはデバイス ドライバーを制御します。
Admin オプションは、管理者の資格情報で実行されているコマンド プロンプトで実行する必要があります。
オプション |
Description |
---|---|
Admin:Security <ALLOW|DENY> Right[ Right] <User|Group> |
プロファイリング サービスに対して、指定のユーザー アクセスまたはグループ アクセスを許可または拒否します。 Right は、以下の値を取ります。 CrossSession - セッション間プロファイリングを実行するサービスに対するユーザー アクセスを提供します。 SampleProfiling - サンプリング プロファイルを有効にするドライバーへのユーザー アクセスを提供します。トレース プロファイル中の、カーネル転送情報へのアクセスにも使用されます。 FullAccess - CrossSession ユーザー アクセスと SampleProfiling ユーザー アクセスの両方を提供します。 |
Admin:Security, List |
プロファイリング サービスの現在の状態を示し、ユーザーのアクセス権を一覧表示します。 |
Admin:<Service|Driver><START|STOP|INSTALL|UNINSTALL> |
プロファイリング サービス コンポーネント (サービス) またはカーネル モード デバイス ドライバー (ドライバー) の開始、停止、インストール、またはアンインストールを行います。 |
Admin:<Service|Driver>AutoStart<ON|OFF> |
再起動後の、プロファイリング サービス (サービス) またはカーネル モード デバイス ドライバー (ドライバー) の自動的な開始を有効または無効にします。 |
VSPerfCmd /Driver
VSPerfCmd /Driver オプションは、廃止されましたが、互換性のために残されています。この機能の代わりに VsPerfCmdAdmin オプションを使用してください。