LaunchLaunch

Launch オプションは、サンプリング メソッドを使用するプロファイラーを起動し、指定されたアプリケーションも起動します。The Launch option starts the profiler using the sampling method and it also starts the specified application.

Launch オプションを使用するには、Start オプションで Sample メソッドを指定する必要があります。To use the Launch option, you must specify the Sample method in the Start option.

構文Syntax

VSPerfCmd.exe /Launch:AppName [Options]  

パラメーターParameters

AppName
起動するアプリケーションの名前。The name of the application to launch. 現在のディレクトリからの完全パスおよび部分パスがサポートされます。Full and partial paths from the current directory are supported.

有効なオプションValid Options

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

Start: MethodStart: Method
コマンド ライン プロファイラー セッションを初期化し、指定されたプロファイル方法を設定します。Initializes the command-line profiler session and sets the specified profiling method.

GlobalOn および GlobalOffGlobalOnand GlobalOff
プロファイリングを再開 (GlobalOn) または一時停止 (GlobalOff) しますが、プロファイル セッションは終了しません。Resumes (GlobalOn) or pauses (GlobalOff) profiling, but does not end the profiling session.

ProcessOn: PID および ProcessOff:PIDProcessOn: PID and ProcessOff:PID
指定されたプロセスのプロファイリングを再開 (ProcessOn) または一時停止 (ProcessOff) します。Resumes (ProcessOn) or pauses (ProcessOff) profiling for the specified process.

TargetCLRTargetCLR
プロファイル セッションに複数バージョンの .NET Framework 共通言語ランタイム (CLR) が読み込まれている場合に、プロファイルを行う CLR のバージョンを指定します。Specifies the version of the .NET Framework Common Language Runtime (CLR) to profile when more than one version is loaded in a profiling session. 既定では、最初に読み込まれたバージョンがプロファイルされます。By default, the first loaded version is profiled.

排他的なオプションExclusive Options

次のオプションは、Launch オプションと共に指定する場合にのみ使用できます。The following options can only be used with the Launch option.

コンソールConsole
指定されたコマンド ライン アプリケーションを新しいウィンドウで起動します。Launches the specified command-line application in a new window.

Args: ArgListArgs: ArgList
アプリケーションに渡す引数リストを指定します。Specifies the list of arguments to pass to the application.

LineOffLineOff
行レベルのプロファイル データの収集を無効にします。Disables the collection of line-level profiling data.

サンプリングのオプションSampling Options

Launch コマンド ラインでは、次のサンプリング間隔オプションのいずれかを指定できます。One of the following sampling interval options can be specified on the Launch command line. 既定のサンプリング間隔は、10,000,000 プロセッサ クロック サイクルです。The default sampling interval is 10,000,000 processor clock cycles.

Timer[:Cycles]PF[:Events]Sys[:Events]Counter[:Name,Reload,FriendlyName]GC[:allocation|lifetime]Timer[:Cycles]PF[:Events]Sys[:Events]Counter[:Name,Reload,FriendlyName]GC[:allocation|lifetime]
サンプリング間隔の数値と種類を指定します。Specifies the number and type of sampling interval.

  • Timer - Cycles のプロセッサ クロック サイクル (停止なし) ごとにサンプリングを行います。Timer - Samples every Cycles non-halted processor clock cycles. Cycles が指定されていない場合、10,000,000 サイクルが使用されます。If Cycles is not specified, 10,000,000 cycles are used.

  • PF - Events のページ フォールトごとにサンプリングを行います。PF - Samples every Events page faults. Events が指定されていない場合は、10 ページ フォールトになります。If Events is not specified, 10 page faults.

  • Sys - オペレーティング システムへの Events の呼び出しごとにサンプリングを行います。Sys - Samples every Events calls to the operating system. Events が指定されていない場合は、10 システム呼び出しが使用されます。If Events is not specified, 10 system calls are used.

  • Counter - Name で指定された CPU パフォーマンス カウンターの Reload の数値ごとにサンプリングを行います。Counter - Samples every Reload number of the CPU performance counter specified by Name. 必要に応じて、FriendlyName でプロファイラー レポート内の列ヘッダーとして使用する文字列を指定できます。Optionally, FriendlyName can specify a string to use as the column header in profiler reports.

  • GC - .NET メモリ データを収集します。GC - Collects .NET memory data. 既定 (allocation) では、データはメモリの割り当てイベントごとに収集されます。By default (allocation), data is collected at every memory allocation event. lifetime パラメーターが指定されている場合、ガベージ コレクション イベントごとのデータも収集されます。When the lifetime parameter is specified, data is also collected at each garbage collection event.

Example

Launch を使用してアプリケーションを起動する例を以下に示します。This example demonstrates the use of Launch to start an application.

VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp  
VSPerfCmd.exe /Launch:TestApp.exe  

関連項目See Also

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