VSPerfCmd

VSPerfCmd.exe ツールはパフォーマンス データ収集の開始と停止に使用されます。 このツールでは、次の構文が使用されます。

VSPerfCmd [/U] [/options]  

次の表は、VSPerfCmd.exe ツール オプションの説明です。

オプション 説明
U リダイレクトされたコンソール出力は Unicode として書き込まれます。 このオプションは最初に指定する必要があります。
Start : mode 指定したモードでプロファイリング サービスを開始します。
Output : filename 出力ファイル名を指定します。 Start との併用でのみ使用します。
CrossSession|CS Windows セッション全体でプロファイリングを有効にします。 StartAttachLaunch との併用でのみ使用します。
User :[domain\]username プロファイラー サービスへの指定アカウント アクセスを有効にします。 Start との併用でのみ使用します。
WaitStart[:n] データ コレクション ロガーの初期化を待ちます。 n が指定されている場合、VSPerfCmd は最大 n 秒待機します。 n が指定されていない場合、VSPerfCmd は無期限に待機します。 これで、バッチ プロセスの一部として VSPerfCmd の使い勝手が良くなります。
Counter : cfg サンプル プロファイル方法が使用されるとき、サンプリング間隔として利用する CPU カウンターとイベント数を指定します。 サンプリングできるカウンター値は 1 つだけです。

インストルメンテーション プロファイル方法を使用するときに、各インストルメンテーション ポイントで収集する CPU カウンターを指定します。 StartTraceAttachLaunch との併用でのみ使用します。
QueryCounters 現在のマシンで有効な CPU カウンターの一覧を表示します。
WinCounter : path プロファイル マーク データと共に含める Windows パフォーマンス カウンター イベントを指定します。 Start との併用でのみ使用します。
AutoMark : n Windows パフォーマンス カウンター データ コレクション イベントの間隔をミリ秒単位で指定します。 WinCounter と併用します。
Events : option 指定した Windows イベント トレーシング (ETW) の収集を制御します。 ETW データは、プロファイリング データ .itl ファイルではない (.vsp) ファイルに収集されます。
状態 プロファイラーの状態、現在プロファイリングされているプロセスに関する情報、プロファイラーを制御する権限が与えられたアカウントを表示します。
Shutdown[:n] プロファイリング データ ファイルを閉じ、プロファイラーをオフにします。
GlobalOn VSPerfCmdGlobalOff の呼び出し後、データ コレクションを再開します。
GlobalOff すべてのデータ コレクションを停止するが、プロファイリング セッションは終了しません。
ProcessOn : pid VSPerfCmdProcessOff を呼び出し、プロファイリングを一時停止した後、指定したプロセスのデータ コレクションを再開します。
ProcessOff : pid 指定したプロセスのデータ コレクションを停止します。
ThreadOn と ThreadOff : tid VSPerfCmdThreadOff を呼び出し、プロファイリングを一時停止した後、指定したプロセスのプロファイリングを再開します。 インストルメンテーション メソッドでプロファイリングするときにのみ、ThreadOn を使用します。
ThreadOn と ThreadOff : tid 指定したスレッドのプロファイリングを一時停止します。 インストルメンテーション方法でプロファイリングするときにのみ、ThreadOff を使用します。
Mark : MarkNum[,MarkText] プロファイリング データ ファイルにマークと任意のテキストを挿入します。

サンプリング メソッド オプション

次のオプションは、サンプリング プロファイル方法の使用時にのみ利用できます。

オプション 説明
Launch : Executable 指定したアプリケーションを開始し、プロファイリングを開始します。
Args : Arguments 起動したアプリケーションに渡すコマンド ライン引数を指定します。
コンソール 新しいコマンド プロント ウィンドウで指定のコマンドを開始します。
Attach : PID[,PID] 指定されたプロセスのプロファイリングを開始します。 プロセスはプロセス ID またはプロセス名で識別されます。
Detach[:PID[,PID]] 指定されたプロセスのプロファイリングを停止します。 プロセスはプロセス ID またはプロセス名で識別されます。 プロセスが指定されていない場合、すべてのプロセスに対してプロファイリングが停止します。
GC[:{Allocation|Lifetime}] .NET メモリの割り当てとオブジェクトの有効期間データを収集します。 使用時は必ず VSPerfCmdLaunch オプションを付けます。

サンプリング間隔オプション

次のオプションは、サンプリング間隔の種類と期間を指定します。 既定は Timer です。 Counter オプションを使用し、CPU カウンターを間隔として指定することもできます。 これらのオプションは Launch と共に指定するか、プロファイリング セッションの最初の Attach と共に指定します。

オプション 説明
PF[:n] n 回目のページ フォールトごとにサンプリングします (既定=10)。
Sys[:n] n 回目のシステム呼び出しごとにサンプリングします (既定=10)。
Timer[:n] n 回目のプロセッサ サイクルごとにサンプリングします (既定=10000000)。

サービス コンポーネントとカーネル モード デバイスのオプション

次の管理オプションは、プロファイリング サービス コンポーネントまたはカーネル モード デバイス ドライバーに対応しています。 管理オプションはプロファイリング アクセス許可を設定し、プロファイリングされるサービスまたはデバイス ドライバーを制御します。

管理オプションは、管理資格情報で実行されるコマンド プロンプトで実行する必要があります。

オプション 説明
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 オプションを使用してください。

関連項目

VSInstr
VSPerfMon
VSPerfReport