Partager via


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 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.

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.

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).

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 à VSPerfCmd GlobalOff.

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 à VSPerfCmd ProcessOff.

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 à VSPerfCmd ThreadOff. 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 VSPerfCmd Launch.

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 VsPerfCmd Admin.

Voir aussi

Référence

VSInstr

VSPerfMon

VSPerfReport