DetachDetach

VSPerfCmd.exe Detach オプションは、何も指定されていない場合、プロファイラーを指定のプロセスまたはすべてのプロセスから切断します。The VSPerfCmd.exe Detach option disconnects the profiler fromthe specified processes or all processes if none are specifed. サンプリング方法を利用し、プロファイリングを初期化しておく必要があります。Profiling must have been initialized by using the sampling method.

Launch オプションまたは Attach オプションを指定して開始したプロファイリングは、Detach で切断できます。Profiling that was started with either the Launch or the Attach options can be disconnected with Detach. 後続の Attach コマンドでプロファイラーを再接続できます。The profiler can be reattched by using subsequent Attach commands.

Detach では、プロファイリング データ ファイルは閉じられません。Detach does not close the profiling data file. プロファイリングを終了し、データ ファイルを閉じるには、Shutdown オプションを使用します。Use the Shutdown option to end profiling and close the data file.

注意

Start オプションを Crosssession オプションと共に指定した場合、VSPerfCmd /Attach または VSPerfCmd /Detach を呼び出すには Crosssession も指定する必要があります。If the Start option was specified with the Crosssession option, any calls to VSPerfCmd /Attach or to VSPerfCmd /Detach must also specify Crosssession.

構文Syntax

VSPerfCmd.exe /Detach[:PIDs|ProcessNames]  

パラメーターParameters

PIDs|ProcessNames
PID - 1 つまたは複数のプロセスの数字のシステム識別子。PID - The numeric system identifer of one or more processes.

ProcessNames - プロセスの名前。ProcessNames - the name of the process. 名前付きプロセスの複数のインスタンスが実行されている場合、結果は予想できません。If multiple instances of the named process are running, results are unpredictable.

複数のプロセスを指定するときは、コンマで区切ります。Separate multiple processes with commas.

プロセスが指定されていない場合、プロファイリングされているすべてのプロセスからプロファイラーが切断されます。If no process is specified, the profiler is detached from all profiled process.

有効なオプションValid options

Attach オプションと組み合わせて単一コマンド ラインで指定できる VSPerfCmd オプションを以下に示します。The following VSPerfCmd options can be combined with the Attach option on a single command line.

CrosssessionCrosssession
ログオン セッション以外のセッションでプロファイリング アプリケーションを有効にします。Enables profiling applications in sessions other than the logon session. Start オプションが Crosssession オプションと共に指定された場合、必須です。Required if the Start option was specified with the Crosssession option.

Example

この例では、Detach コマンドはプロファイリングを一時停止します。Shutdown コマンドはプロファイラー データ ファイルを閉じます。In this example, the Detach command suspends profiling and the Shutdown command closes the profiler data file.

VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp  
VSPerfCmd.exe /Launch:TestApp.exe  
;REM Excercise the application  
VSPerfCmd.exe /Detach  
VSPerfCmd.exe /Shutdown  

関連項目See Also

VSPerfCmd VSPerfCmd
スタンドアロン アプリケーションのプロファイリング Profiling Stand-Alone Applications
ASP.NET Web アプリケーションのプロファイリング Profiling ASP.NET Web Applications
プロファイリング (サービスの)Profiling Services