ProcessOn et ProcessOffProcessOn and ProcessOff

Les sous commandes ProcessOff et ProcessOn de VSPerfCmd.exe permettent de suspendre et de reprendre le profilage pour le processus spécifié dans une session de profilage en ligne de commande.The VSPerfCmd.exe ProcessOff and ProcessOn subcommands pause and resume profiling for the specified process in a command-line profiling session. ProcessOff arrête le profilage du processus et ProcessOn le démarre.ProcessOff stops profiling the process and ProcessOn starts profiling the process.

Dans la plupart des cas, vous spécifiez ProcessOn ou ProcessOff comme seule option d’une ligne de commande VSPerfCmd.exe, mais elles peuvent aussi être combinées avec les sous-commandes GlobalOn, GlobalOff, ThreadOn et ThreadOff.In most cases, you specify ProcessOn or ProcessOff as the only option in a VSPerfCmd.exe command line, but they can also be combined with the GlobalOn, GlobalOff, ThreadOn, and ThreadOff subcommands.

Les sous-commandes ProcessOn et ProcessOff interagissent avec les sous-commandes GlobalOn et GlobalOff qui contrôlent la collecte de données pour tous les processus dans une session de profilage en ligne de commande, et avec les sous-commandes ThreadOn et ThreadOff qui contrôlent la collecte de données pour un thread spécifié.The ProcessOn and ProcessOff subcommands interact with the GlobalOn and GlobalOff subcommands that control data collection for all processes in a command-line profiling session, and the ThreadOn and ThreadOff subcommands that control data collection for a specified thread.

Les sous-commandes ProcessOff et ProcessOn affectent également le nombre de démarrage/arrêt de processus qui est manipulé par les fonctions d’API du profileur.The ProcessOff and ProcessOn subcommands also affect the Process Start/Stop count that is manipulated by profiler API functions.

  • ProcessOff définit immédiatement le nombre de démarrage/arrêt de processus sur 0 et suspend ainsi le profilage.ProcessOff immediately sets the Process Start/Stop Count to 0 and therefore pauses profiling.

  • ProcessOn définit immédiatement le nombre de démarrage/arrêt de processus sur 1 et reprend ainsi le profilage.ProcessOn immediately sets the Process 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 /{ProcessOff|ProcessOn}:PID [Options]  

ParamètresParameters

PID
L’identificateur entier du processus à démarrer ou à arrêter.The integer identifier of the process to start or stop. Les ID de processus sont répertoriés sous l’onglet Processus du Gestionnaire des tâches de Windows.Process IDs are listed on the Process tab of Windows Task Manager.

Sous-commandes obligatoiresRequired Subcommands

Aucun.None

Sous-commandes validesValid Subcommands

Vous pouvez spécifier ProcessOn et ProcessOff sur des lignes de commande qui contiennent également les sous-commandes suivantes.ProcessOn and ProcessOff can be specified on command lines that also contain the following subcommands.

Start: MethodStart: Method
Initialise la session de profilage en ligne de commande et définit la méthode de profilage spécifiée.Initializes the command-line profiling 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.

GlobalOff|GlobalOnGlobalOff|GlobalOn
Arrête ou démarre le profilage de tous les processus d’une session de profilage en ligne de commande.Stops or starts profiling for all processes in a command-line profiling session.

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

ExempleExample

Dans cet exemple, la sous-commande ProcessOff est utilisé pour collecter des données de profilage pour le démarrage de l’application.In this example, the ProcessOff subcommand is used to collect profiling data for application startup.

; Initialize the profiler.  
VSPerfCmd.exe /Start:Trace /Output:Instrument.vsp   
; Start the instrumented application.  
; Stop profiling the process after startup.  
VSPerfCmd.exe /ProcessOff:12345  
; Shut down the target application.  
; Close the profiler.  
VSPerfCmd /Shutdown  

Voir aussiSee Also

VSPerfCmd VSPerfCmd
Profilage d’applications autonomes Profiling Stand-Alone Applications
Profilage d’applications web ASP.NET Profiling ASP.NET Web Applications
Profilage de servicesProfiling Services