Attach

VSPerfCmd.exe の Attach オプションは、プロセス ID (PID) で指定された実行中のプロセスのサンプルプロファイルを開始します。

Attach オプションを使用するには、Start オプションで Sample メソッドを指定する必要があります。

[!メモ]

Start オプションと共に Crosssession オプションが指定されている場合は、VSPerfCmd /Attach または VSPerfCmd /Detach への呼び出しでも Crosssession を指定する必要があります。

VSPerfCmd.exe /Attach:ProcessID [Options]

パラメーター

ProcessID
実行中のプロセスのプロセス ID (PID)。実行中のプロセスの PID は、Windows タスクマネージャーの [プロセス] タブに表示されます。

Attach オプションと組み合わせて 1 行のコマンドラインで指定できる VSPerfCmd オプションを次に示します。

Crosssession
ログオンセッション以外のセッションにおけるアプリケーションのプロファイリングを有効にします。Start オプションと共に Crosssession オプションが指定された場合は必須です。
**Start:**Method
コマンドラインプロファイラーセッションを初期化し、指定されたプロファイル方法を設定します。
TargetCLR
プロファイルセッションに複数バージョンの .NET Framework 共通言語ランタイム (CLR: Common Language Runtime) が読み込まれている場合に、プロファイルを行う CLR のバージョンを指定します。既定では、最初に読み込まれたバージョンがプロファイルされます。
GlobalOnGlobalOff
プロファイリングを再開 (GlobalOn) または一時停止 (GlobalOff) しますが、プロファイルセッションは終了しません。
**ProcessOn:PIDProcessOff:**PID
指定されたプロセスのプロファイリングを再開 (ProcessOn) または一時停止 (ProcessOff) します。

Attach のコマンドラインでは、次のサンプリング間隔オプションのうちのいずれか 1 つを指定できます。既定のサンプリング間隔は、プロセッサのクロックサイクル数 10,000,000 です。

Timer[**:Cycles]PF[:Events]Sys[:Events]Counter[:**Name,Reload,FriendlyName]
サンプリング間隔の数値と種類を指定します。
- Timer: プロセッサのクロックサイクル数が Cycles で指定された回数に到達するたびにサンプリングを行います。Cycles が指定されていない場合は、10,000,000 サイクルに設定されます。
- PF: ページフォールト数が Events で指定された回数に到達するたびにサンプリングを行います。Events が指定されていない場合は、ページフォールト数 10 回に設定されます。
- Sys: オペレーティングシステムへの呼び出しが Events で指定された回数に到達するたびにサンプリングを行います。Events が指定されていない場合は、システムコール 10 回に設定されます。
- Counter: Name で指定された CPU のパフォーマンスカウンターが、Reload で指定された数値に到達するたびにサンプリングを行います。オプションとして、FriendlyName でプロファイラーレポート内の列ヘッダーとして使用する文字列を指定できます。

次の例では、アプリケーションの実行中のインスタンス (プロセス ID 12345) にプロファイラーをアタッチする方法を示します。

VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp
VSPerfCmd.exe /Attach:12345