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. |
Active le profilage dans les sessions Windows.À n'utiliser qu'avec Start, Attach ou 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. |
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. |
AutoMark:n |
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). |
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. |
Reprend la collecte des données après un appel à VSPerfCmdGlobalOff. |
|
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é. |
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. |
|
Suspend le profilage pour le thread spécifié.Utilisez ThreadOff seulement en cas de profilage avec la méthode d'instrumentation. |
|
Marque:MarkNum[,MarkText] |
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. |
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> Right[ Right] <User|Group> |
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|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 de mode noyau (pilote). |
Admin:<Service|Driver>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.