GlobalOn et GlobalOffGlobalOn and GlobalOff

Les options GlobalOff et GlobalOn de VSPerfCmd.exe suspendent et reprennent le profilage pour tous les processus et threads dans une session de profilage en ligne de commande.The VSPerfCmd.exe GlobalOff and GlobalOn options pause and resume profiling for all processes and threads in a command-line profiling session.

Vous pouvez spécifier GlobalOn et GlobalOff comme uniques options sur une ligne de commande VSPerfCmd.exe, ou vous pouvez les inclure sur des lignes de commande qui contiennent aussi les options Start, Launch ou 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.

Vous pouvez aussi combiner GlobalOn et GlobalOff avec les options ProcessOn, ProcessOff, ThreadOn et ThreadOff.GlobalOn and GlobalOff can also be combined with the ProcessOn, ProcessOff, ThreadOn, and ThreadOff options.

Les options GlobalOn et GlobalOff interagissent avec les options ProcessOn et ProcessOff qui contrôlent la collecte de données pour un processus spécifié, et avec les options ThreadOn et ThreadOff qui contrôlent la collecte de données pour un thread spécifié.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.

Les options GlobalOff et GlobalOn affectent également le nombre Start/Stop global manipulé par les fonctions d’API du profileur.The GlobalOff and GlobalOn options also affect the Global Start/Stop count that is manipulated by the profiler's API functions.

  • GlobalOff affecte immédiatement la valeur 0 au Nombre Start/Stop global et suspend ainsi le profilage.GlobalOff immediately sets the Global Start/Stop Count to 0 and therefore pauses profiling.

  • GlobalOff affecte immédiatement la valeur 1 au Nombre Start/Stop global et reprend ainsi le profilage.GlobalOn immediately sets the Global Start/Stop Count to 1 and therefore resumes profiling.

    Pour plus d’informations, consultez API des outils de profilage.For more information, see Profiling tools APIs.

SyntaxeSyntax

VSPerfCmd.exe /{GlobalOff|GlobalOn}  

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

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

ParamètresParameters

Aucun.None

Options validesValid Options

Vous pouvez spécifier GlobalOn et GlobalOff sur des lignes de commande qui contiennent également les options suivantes.GlobalOn and GlobalOff can be specified on command lines that also contain the following options.

Start : MethodStart: Method
Initialise la session de profileur en ligne de commande et définit la méthode de profilage spécifiée.Initializes the command-line profiler session and sets the specified profiling method.

Launch : AppNameLaunch: AppName
Démarre l’application spécifiée et commence le profilage avec la méthode d’échantillonnage.Starts the specified application and begins profiling with the sampling method.

Attach : PIDAttach: PID
Démarre le profilage du processus spécifié.Begins profiling the specified process.

{ProcessOff|ProcessOn} :PID{ProcessOff|ProcessOn}:PID
Arrête ou démarre le profilage du processus spécifié.Stops or starts profiling for the specified process.

{ThreadOff|ThreadOn} :TID{ThreadOff|ThreadOn}:TID
Arrête ou démarre le profilage du processus spécifié (méthode d’instrumentation uniquement).Stops or starts profiling for the specified process (instrumentation method only).

ExempleExample

Dans cet exemple, les options GlobalOff et GlobalOn permettent d’éviter la collecte de données de profilage pour le démarrage et l’arrêt de l’application.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  

Voir aussiSee also

VSPerfCmd VSPerfCmd
Profiler des applications autonomes Profile stand-alone applications
Profiler des applications web ASP.NET Profile ASP.NET web applications
Profiler des servicesProfile services