GlobalOn と GlobalOffGlobalOn and GlobalOff

VSPerfCmd.exe の GlobalOff オプションと GlobalOn オプションは、コマンド ライン プロファイル セッションのすべてのプロセスとスレッドのプロファイリングを一時停止および再開するために使用されます。The VSPerfCmd.exe GlobalOff and GlobalOn options pause and resume profiling for all processes and threads in a command-line profiling session.

GlobalOn および GlobalOff は、VSPerfCmd.exe コマンド ラインの唯一のオプションとして指定することも、Start オプション、Launch オプション、または Attach オプションを含んでいるコマンド ラインに含めることもできます。You can specify GlobalOn and GlobalOff as the only options in a VSPerfCmd.exe command line, or you can include them in command lines that also contain the Start, Launch, or Attach options.

GlobalOnGlobalOff は、ProcessOnProcessOffThreadOnThreadOff の各オプションと組み合わせて使用することもできます。GlobalOn and GlobalOff can also be combined with the ProcessOn, ProcessOff, ThreadOn, and ThreadOff options.

GlobalOn オプションと GlobalOff オプションは、指定したプロセスのデータ収集を制御する ProcessOn オプションおよび ProcessOff オプション、指定したスレッドのデータ収集を制御する ThreadOn オプションおよび ThreadOff オプションと対話します。The GlobalOn and GlobalOff options interact with the ProcessOn and ProcessOff options that control data collection for a specified process, and with the ThreadOn and ThreadOff options that control data collection for a specified thread.

GlobalOff オプションと GlobalOn オプションは、プロファイラーの API 関数によって操作されるグローバルな開始/停止数にも影響します。The GlobalOff and GlobalOn options also affect the Global Start/Stop count that is manipulated by the profiler's API functions.

  • GlobalOff は、グローバルな開始/停止数を直ちに 0 に設定して、プロファイリングを一時停止します。GlobalOff immediately sets the Global Start/Stop Count to 0 and therefore pauses profiling.

  • GlobalOn は、グローバルな開始/停止数を直ちに 1 に設定して、プロファイリングを再開します。GlobalOn immediately sets the Global Start/Stop Count to 1 and therefore resumes profiling.

    詳細については、「プロファイリング ツールの API」 を参照してください。For more information, see Profiling Tools APIs.

構文Syntax

VSPerfCmd.exe /{GlobalOff|GlobalOn}  

VSPerfCmd.exe /Start:Method /{GlobalOff|GlobalOn} [Options]  

VSPerfCmd.exe {Launch:AppName|Attach:PID} /{GlobalOff|GlobalOn}[Options]  

パラメーターParameters

なしNone

有効なオプションValid Options

GlobalOnGlobalOff は、次のオプションを含んでいるコマンド ラインで指定できます。GlobalOn and GlobalOff can be specified on command lines that also contain the following options.

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

Launch: AppNameLaunch: AppName
指定したアプリケーションを起動し、サンプリング メソッドでプロファイリングを開始します。Starts the specified application and begins profiling with the sampling method.

Attach: PIDAttach: PID
指定されたプロセスのプロファイリングを開始します。Begins profiling the specified process.

{ProcessOff|ProcessOn}:PID{ProcessOff|ProcessOn}:PID
指定されたプロセスのプロファイリングを停止または開始します。Stops or starts profiling for the specified process.

{ThreadOff|ThreadOn}:TID{ThreadOff|ThreadOn}:TID
指定されたプロセスのプロファイリングを停止または開始します (インストルメンテーション メソッドのみ)。Stops or starts profiling for the specified process (instrumentation method only).

Example

次の例では、アプリケーションの起動およびシャットダウンのプロファイル データを収集しないようにするために、GlobalOff オプションと GlobalOn オプションを使用しています。In this example, the GlobalOff and GlobalOn options are used to avoid collecting profiling data for application startup and shutdown.

; Initialize the profiler with profiling stopped.  
VSPerfCmd.exe /Start:Trace /Output:Instrument.vsp /GlobalOff  
; Start an instrumented application and wait for it to warm up.  
; Start profiling.  
VSPerfCmd.exe /GlobalOn  
; Exercise the application functionality that you want to profile.  
; Stop profiling.  
VSPerfCmd.exe /GlobalOff  
; Shut down the target application.  
; Close the profiler.  
VSPerfCmd /Shutdown  

関連項目See Also

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