VSPerfCmdVSPerfCmd

L’outil VSPerfCmd.exe est utilisé pour démarrer et arrêter la collecte de données de performances.The VSPerfCmd.exe tool is used to start and stop performance data collection. Il utilise la syntaxe suivante :It uses the following syntax:

VSPerfCmd [/U] [/options]  

Les tableaux suivants décrivent les options de l’outil VSPerfCmd.exe.The following tables describe VSPerfCmd.exe tool options.

OptionOption DescriptionDescription
UU La sortie redirigée de la console est écrite au format Unicode.Redirected console output is written as Unicode. Doit être la première option spécifiée.Must be the first option specified.
Start : modeStart : mode Démarre le service de profilage dans le mode spécifié.Starts the profiling service in the specified mode.
Output : filenameOutput : filename Spécifie le nom du fichier de sortie.Specifies the output file name. À utiliser uniquement avec Start.Use only with Start.
CrossSession|CSCrossSession|CS Active le profilage entre des sessions Windows.Enables profiling across Windows sessions. À utiliser seulement avec Start, Attach ou Launch.Use only with Start, Attach, or Launch.
User :[domain\]usernameUser :[domain\]username Permet au compte spécifié d’accéder au service du profileur.Enables the specified account access to the profiler service. À utiliser uniquement avec Start.Use only with Start.
WaitStart[:n]WaitStart[:n] Attend que le journal de collecte de données soit initialisé.Waits for the data collection logger to initialize. Si n est spécifié, VSPerfCmd attend au plus n secondes.If n is specified, VSPerfCmd will wait at most n seconds. Si n n’est pas spécifié, VSPerfCmd attend indéfiniment.If n is not specified, VSPerfCmd will wait indefinitely. Ceci facilite l’utilisation de VSPerfCmd dans le cadre d’un traitement par lots.This eases use of VSPerfCmd as part of a batch process.
Counter : cfgCounter : cfg Quand l’exemple de méthode de profilage par échantillonnage est utilisée, spécifie un compteur d’UC et le nombre d’événements à utiliser comme intervalle d’échantillonnage.When the sample profiling method is used, specifies a CPU counter and the number of events to use as the sampling interval. Vous ne pouvez échantillonner qu’une seule valeur de compteur.You can sample only one counter value.

Quand la méthode de profilage par instrumentation est utilisée, spécifie un compteur d’UC à collecter à chaque point d’instrumentation.When the instrumentation profiling method is used, specifies a CPU counter to be collected at each instrumentation point. À utiliser seulement avec StartTrace, Attach ou Launch.Use only with Start:Trace, Attach, or Launch.
QueryCountersQueryCounters Affiche une liste des compteurs d’UC valides pour la machine active.Displays a list of valid CPU counters for the current machine.
WinCounter : pathWinCounter : path Spécifie un événement de compteur de performance Windows à inclure avec les données de marque du profil.Specifies a Windows performance counter event to include with profile mark data. À utiliser uniquement avec Start.Use only with Start.
AutoMark : nAutoMark : n Spécifie l’intervalle de temps (en millisecondes) entre les événements de collecte des données du compteur de performances Windows.Specifies the time interval (in milliseconds) between Windows performance counter data collection events. À utiliser avec WinCounter.Use with WinCounter.
Events : optionEvents : option Contrôle la collecte des événements de suivi d’événements pour Windows (ETW) spécifiés.Controls collection of specified Event Tracing for Windows (ETW) events. Les données ETW sont collectées dans un fichier .itl qui n’est pas le fichier de données de profilage (.vsp).ETW data is collected to an .itl file that is not the profiling data (.vsp) file.
ÉtatStatus Affiche l’état du profileur, des informations sur les processus qui sont en cours de profilage et les comptes qui sont autorisés à contrôler le profileur.Displays the state of the profiler, information about processes that are currently being profiled, and accounts that have authority to control the profiler.
Shutdown[:n]Shutdown[:n] Ferme le fichier de données de profilage et désactive le profileur.Closes the profiling data file and turns the profiler off.
GlobalOnGlobalOn Reprend la collecte de données après un appel à VSPerfCmdGlobalOff.Resumes data collection after a call to VSPerfCmdGlobalOff.
GlobalOffGlobalOff Arrête complètement la collecte de données, mais ne met pas fin à la session de profilage.Stops all data collection, but does not end the profiling session.
ProcessOn : pidProcessOn : pid Reprend la collecte de données pour le processus spécifié après la mise en suspens du profilage via un appel à VSPerfCmdProcessOff.Resumes data collection for the specified process after profiling was paused by a call to VSPerfCmdProcessOff.
ProcessOff : pidProcessOff : pid Arrête la collecte de données pour le processus spécifié.Stops data collection for the specified process.
ThreadOn et ThreadOff : tidThreadOn and ThreadOff : tid Reprend le profilage pour le processus spécifié après la mise en suspens du profilage par un appel à VSPerfCmdThreadOff.Resumes profiling for the specified process after profiling was paused by a call to VSPerfCmdThreadOff. Utilisez ThreadOn seulement en cas de profilage avec la méthode d’instrumentation.Use ThreadOn only when profiling with the instrumentation method.
ThreadOn et ThreadOff : tidThreadOn and ThreadOff : tid Suspend le profilage pour le thread spécifié.Pauses profiling for the specified thread. Utilisez ThreadOff seulement en cas de profilage avec la méthode d’instrumentation.Use ThreadOff only when profiling with the instrumentation method.
Mark : MarkNum[,MarkText]Mark : MarkNum[,MarkText] Insère une marque dans le fichier de données de profilage, avec un texte facultatif.Inserts a mark into the profiling data file, with optional text.

Options de méthode d’échantillonnageSample method options

Les options suivantes sont disponibles seulement quand vous utilisez la méthode de profilage par échantillonnage.The following options are only available when you are using the sampling profiling method.

OptionOption DescriptionDescription
Launch : ExécutableLaunch : Executable Démarre l’application spécifiée et démarre le profileur.Starts the specified application and begins profiling.
Args : ArgumentsArgs : Arguments Spécifie les arguments de ligne de commande à passer à l’application lancée.Specifies command line arguments to pass to the launched application.
ConsoleConsole Démarre la commande spécifiée dans une nouvelle fenêtre d’invite de commandes.Starts the specified command in a new command prompt window.
Attach : PID[,PID]Attach : PID[,PID] Démarre le profilage des processus spécifiés.Begins profiling the specified processes. Vous pouvez identifier les processus par ID de processus ou par nom de processus.Processes can be identified by the process ID or by the process name.
Detach[:PID[,PID]]Detach[:PID[,PID]] Arrête le profilage des processus spécifiés.Stops profiling the specified processes. Vous pouvez identifier les processus par ID de processus ou par nom de processus.Processes can be identified by the process ID or by the process name. Si aucun processus n’est spécifié, le profilage est arrêté pour tous les processus.If no process is specified, profiling is halted for all processes.
GC[:{Allocation|Lifetime}]GC[:{Allocation|Lifetime}] Collecte les données d’allocation de mémoire et les données de durée de vie des objets de .NET.Collects .NET memory allocation and object lifetime data. À utiliser seulement avec l’option VSPerfCmdLaunch.Use only with the VSPerfCmdLaunch option.

Options d'intervalle d’échantillonnageSample interval options

Les options suivantes spécifient le type et la durée des intervalles d’échantillonnage.The following options specify the type and duration of sampling intervals. La valeur par défaut est Timer.The default is Timer. Vous pouvez également spécifier un compteur d’UC comme intervalle avec l’option Counter.You can also specify a CPU counter as the interval by using the Counter option. Ces options peuvent être spécifiées seulement avec Launch ou avec la première option Attach d’une session de profilage.These options can only be specified with Launch or with the first Attach of a profiling session.

OptionOption DescriptionDescription
PF[:n]PF[:n] Échantillonne tous les n défauts de page (valeur par défaut=10).Samples on every n-th page fault (default=10).
Sys[:n]Sys[:n] Échantillonne tous les n appels système (valeur par défaut=10).Samples on every n-th system call (default=10).
Timer[:n]Timer[:n] Échantillonne tous les n cycles de processeur (valeur par défaut=10 000 000).Samples on every n-th processor cycle (default=10000000).

Options des composants de service et des périphériques en mode noyauService component and kernel mode device options

Les options Admin suivantes prennent en charge le profilage des composants de service ou les pilotes de périphérique en mode noyau.The following Admin options support profiling service components or kernel mode device drivers. Les options Admin définissent des autorisations de profilage et contrôlent le service profilé ou le pilote de périphérique.The Admin options set profiling permissions and control the profiled service or device driver.

Les options Admin doivent être exécutées à une invite de commandes s’exécutant avec des informations d’identification d’administration.Admin options must be executed at a command prompt that is running with administrative credentials.

OptionOption DescriptionDescription
Admin:Security <ALLOW|DENY> Right[ Right] <Utilisateur|Groupe>Admin:Security <ALLOW|DENY> Right[ Right] <User|Group> Autorise ou refuse à l’utilisateur ou au groupe spécifié l’accès aux services de profilage.Allows or denies the specified user or group access to profiling services.

Right peut être :Right can be:

CrossSession : donne à l’utilisateur l’accès au service pour faire du profilage intersession.CrossSession - gives the user access to the service to do cross session profiling.

SampleProfiling : donne à l’utilisateur l’accès au pilote pour activer le profilage par échantillonnage.SampleProfiling - gives the user access to the driver to enable sampling profiling. Également utilisé pour accéder aux informations de transition du noyau lors du profilage de trace.Also used to access kernel transition information during trace profiling.

FullAccess : donne à l’utilisateur l’accès CrossSession et SampleProfiling.FullAccess - gives the user both CrossSession and SampleProfiling access.
Admin:Security, ListAdmin:Security, List Répertorie les états des services de profilage et les autorisations des utilisateurs.Lists the current state of profiling services and lists user permissions.
Admin: <Service|Driver><START|STOP|INSTALL|UNINSTALL>Admin: <Service|Driver><START|STOP|INSTALL|UNINSTALL> Démarre, arrête, installe ou désinstalle le composant du service de profilage (service) ou le pilote de périphérique en mode noyau (driver).Starts, stops, installs, or uninstalls the profiling service component (service) or kernel mode device driver (driver).
Admin: <Service|Driver>AutoStart<ON|OFF>Admin: <Service|Driver>AutoStart<ON|OFF> Active ou désactive automatiquement le démarrage du service de profilage (service) ou du pilote de périphérique en mode noyau (driver) après un redémarrage.Enables or disables automatically starting the profiling service (service) or kernel mode device driver (driver) after a restart.

VSPerfCmd /DriverVSPerfCmd /Driver

L’option VSPerfCmd /Driver est désormais obsolète.The VSPerfCmd /Driver option is now obsolete. Utilisez les options de VsPerfCmdAdmin pour cette fonctionnalité.Use the VsPerfCmdAdmin options for this functionality.

Voir aussiSee also

VSInstr VSInstr
VSPerfMon VSPerfMon
VSPerfReportVSPerfReport