VSPerfCmd

L'outil VSPerfCmd.exe permet de démarrer et d'arrêter la collecte de données de performance.Il utilise la syntaxe suivante :

VSPerfCmd [/U] [/options]

Les tableaux ci-dessous décrivent les options de l'outil VSPerfCmd.exe.

Option	Description
U	La sortie de console redirigée est écrite sous Unicode.Doit être la première option spécifiée.
Start:mode	Démarre le service de profilage dans le mode spécifié.
Output:filename	Spécifie le nom du fichier de sortie.À n'utiliser qu'avec Start.
CrossSession|CS	Active le profilage dans les sessions Windows.À n'utiliser qu'avec Start, Attach, or Launch.
Utilisateur:[domain\]username	Active l'accès du compte spécifié au service du profileur.À n'utiliser qu'avec Start.
WaitStart[:n]	Attend l'initialisation du journal de collecte de données.Si n est spécifié, VSPerfCmd attendra au plus n secondes.Si n n'est pas spécifié, VSPerfCmd attendra indéfiniment.Cela facilite l'utilisation de VSPerfCmd dans le cadre d'un processus par lots.
Compteur:cfg	En cas d'utilisation de la méthode de profilage par échantillonnage, spécifie un compteur UC et le nombre d'événements à utiliser comme intervalle d'échantillonnage.Vous ne pouvez échantillonner qu'une seule valeur de compteur à la fois. En cas d'utilisation de la méthode de profilage par instrumentation, spécifie un compteur UC à collecter à chaque point d'instrumentation.À n'utiliser qu'avec Start:Trace, Attach,ou Launch.
QueryCounters	Affiche une liste des compteurs UC valides pour l'ordinateur actuel.
WinCounter:path	Spécifie un événement de compteur de performance Windows à inclure avec les données de marquage du profil.À n'utiliser qu'avec Start.
AutoMarkn:	Spécifie l'intervalle (en millisecondes) entre les événements de collecte de données du compteur de performance Windows.Utilisez avec WinCounter.
Événements:option	Contrôle la collecte des événements ETW (Event Tracing for Windows) spécifiés.Les données ETW sont collectées dans un fichier .itl différent du fichier de données de profilage (.vsp).
Status	Affiche l'état du profileur, des informations sur les processus en cours de profilage et les comptes habilités à contrôler le profileur.
Shutdown[:n]	Ferme le fichier de données de profilage et désactive le profileur.
GlobalOn	Reprend la collecte des données après un appel à VSPerfCmdGlobalOff.
GlobalOff	Arrête toute la collecte de données, mais ne termine pas la session de profilage.
ProcessOn:pid	Reprend la collecte de données pour le processus spécifié après la suspension du profilage via un appel à VSPerfCmdProcessOff.
ProcessOff:pid	Arrête la collecte de données pour le processus spécifié.
ThreadOn et ThreadOff:TID	Reprend le profilage du processus spécifié après la suspension du profilage via un appel à VSPerfCmdThreadOff.Utilisez ThreadOn seulement en cas de profilage avec la méthode d'instrumentation.
ThreadOn et ThreadOff:TID	Suspend le profilage pour le thread spécifié.Utilisez ThreadOff seulement en cas de profilage avec la méthode d'instrumentation.
Marque:NuméroMarque[,TexteMarque]	Insère une marque dans le fichier de données de profilage, avec un texte facultatif.

Options de la méthode d'échantillonnage

Les options suivantes sont disponibles uniquement lorsque vous utilisez la méthode de profilage par échantillonnage.

Option	Description
Lancer:Executable	Démarre l'application spécifiée et commence le profilage.
Args:Arguments	Spécifie les arguments de la ligne de commande à passer à l'application lancée.
Console	Démarre la commande spécifiée dans une nouvelle fenêtre d'invite de commandes.
Attach:PID[,PID]	Commence le profilage des processus spécifiés.Les processus peuvent être identifiés par l'ID de processus ou par le nom de processus.
Detach[:PID[,PID]]	Arrête le profilage des processus spécifiés.Les processus peuvent être identifiés par l'ID de processus ou par le nom de processus.Si aucun processus n'est spécifié, le profilage est interrompu pour tous les processus.
GC[:{Allocation|Lifetime}]	Collecte les données liées à l'allocation de la mémoire .NET et à la durée de vie des objets.À n'utiliser qu'avec l'option VSPerfCmdLaunch.

Options d'intervalle d'échantillonnage

Les options suivantes spécifient le type et la durée des intervalles d'échantillonnage.La valeur par défaut est Timer.Vous pouvez également spécifier un compteur UC comme intervalle à l'aide de la Counter option.Ces options peuvent uniquement être spécifiées avec Launch ou avec la première occurrence Attach d'une session de profilage.

Option	Description
PF[:n]	Exemples sur chaque numéro d'erreur de page (valeur par défaut=10).
Sys (VSPerfCmd)[:n]	Exemples sur chaque numéro d'appel système (valeur par défaut=10).
Timer[:n]	Échantillonnage tous les n cycles de processeur (valeur par défaut=10000000).

Options des composants du service et des périphériques en mode noyau

Les options Admin suivantes prennent en charge les composants du service de profilage ou les pilotes de périphériques en mode noyau.Les options Admin définissent les autorisations de profilage et contrôlent le pilote de périphérique ou le service profilé.

Les options Admin doivent être exécutées dans une invite de commandes qui s'exécute avec les informations d'identification d'administration.

Option	Description
Admin:Security <ALLOW|DENY> Droit[ Droit] <Utilisateur|Groupe>	Autorise ou refuse à l'utilisateur ou au groupe spécifié l'accès aux services de profilage. Right peut être : CrossSession - accorde à l'utilisateur l'accès au service pour faire du profilage intersession. SampleProfiling - accorde à l'utilisateur l'accès au pilote pour activer le profilage d'échantillonnage.Également utilisé pour accéder aux informations de transition du noyau au cours du profilage de trace. FullAccess - accorde à l'utilisateur l'accès à CrossSession et à SampleProfiling.
Admin:Security, List	Répertorie l'état actuel des services de profilage ainsi que les autorisations utilisateur.
Admin:<Service|Pilote><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 de mode noyau (pilote).
Admin:<Service|Pilote>AutoStart<ON|OFF>	Active ou désactive automatiquement le démarrage du service de profilage (service) ou le pilote de périphérique de mode noyau (pilote) après un redémarrage.

VSPerfCmd /Driver

L'option VSPerfCmd /Driver est désormais obsolète.Pour assurer cette fonctionnalité, utilisez les options VsPerfCmdAdmin.

Voir aussi

Référence

VSInstr

VSPerfMon

VSPerfReport