VSPerfCmd

U

La sortie de console redirigée est écrite sous Unicode. Doit être la première option spécifiée.

Output:filename

Spécifie le nom du fichier de sortie.

User:[domain\]username

Utilisé avec l'option START. Autorise l'accès client à l'analyseur à partir du compte spécifié.

Counter: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. Vous pouvez collecter les données de plusieurs compteurs en spécifiant plusieurs options Counter (instrumentation uniquement).

Pour spécifier les données du compteur (cfg), utilisez la syntaxe suivante :

CounterName[,Reload[,FriendlyName]]

• CounterName correspond au nom d'un compteur retourné par la commande VSPerfCmd /QueryCounters.

• Reload correspond à l'intervalle d'échantillonnage des événements de compteur. Le paramètre Reload est ignoré lorsque vous utilisez la méthode d'instrumentation.

• FriendlyName (facultatif). Si elle est spécifiée, chaîne qui remplace la valeur CounterName dans les vues et les rapports des outils de profilage.

WinCounter:chemin

Spécifie un compteur de performance Windows à inclure avec les données de marque. path est une chaîne du compteur de performance Windows au format de chemin d'accès PDH. Par exemple :

\Processor(0)\% Temps processeur

\System\Changements de contexte/sec

Events:option

L'option EVENTS contrôle la collecte d'événements ETW (Event Trace Window). Les données collectées sont fournies par le fournisseur ETW. Le format option est :

<activé | désactivé>, <guid>[,flags[,level]]

<activé | désactivé>, <NomFournisseur>[,flags[,level]]

guid - GUID de contrôle du fournisseur. Un nom de fournisseur peut également être spécifié à la place du GUID s'il est enregistré avec WMI.

flags - valeur d'indicateurs hexadécimale préfixée '0x'. Elle est définie par le fournisseur d'événements. Pour plus d'informations, consultez la documentation du fournisseur d'ETW.

level- détermine la quantité d'informations collectée. Elle est définie par le fournisseur d'événements. Pour plus d'informations, consultez la documentation du fournisseur d'ETW.

Remarque importante :

Lorsque les événements ETW du CLR sont activés, des données de démarrage supplémentaires sont également rassemblées dans le rapport Trace View. Pour empêcher que des événements de démarrage apparaissent dans le rapport, utilisez la commande suivante : C:\<chemin>VSPerfCmd -events on, \".NET Common Language Runtime\", 0x7fffffff, 5 Si vous n'excluez pas les événements de démarrage, parce que ces événements ne sont pas répertoriés dans le fichier au format MOF (Managed Object Format), ils apparaissent sous forme de GUID dans le rapport. Pour plus d'informations, consultez Exemple de fichier au format MOF (Managed Object Format).

En outre, l'option EVENTS peut comprendre les options de noyau communes suivantes :

on, option[,option]

où option représente un des éléments suivants :

Process - Événements de processus

Thread - Événements de thread

Image - Événements de chargement et de déchargement d'images

Disk - Événements d'E/S de disque

File - Événements d'E/S de fichier

Hardfault- Erreurs de page matérielles

Pagefault- Erreurs de page logicielles

Network - Événements de réseau

Registry - Événements d'accès au Registre

Notez que le fournisseur de noyau peut uniquement être activé. Il n'est pas désactivé, ses indicateurs ne peuvent pas non plus être modifiés, tant que le gestionnaire ne s'est pas arrêté.

ShutDown[:n]

Attend que les applications surveillées s'arrêtent ou se détachent, puis arrête l'outil VSPerfMon.exe et attend la fin de la procédure d'arrêt. 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.

GlobalOff

L'option GLOBALOFF désactive tout le profilage et aucune donnée n'est collectée. Cette option n'arrête pas la session de performance. Vous pouvez utiliser cette option pour éviter la collecte de données pendant le démarrage de l'application ou la phase d'initialisation.

Pour éviter la collecte de données sans objet :

ProcessOff:pid

L'option PROCESSOFF arrête le profilage et la collecte de données d'un processus spécifique à l'aide de son ID de processus (pid). D'autres processus ou threads continuent à rassembler des données. Cela est utile si vous souhaitez éviter de rassembler des données avant que le processus n'atteigne un certain état. Vous pouvez utiliser l'option PROCESSON, après que le processus a atteint un certain état, pour commencer la collecte de données. En interne, PROCESSOFF affecte au nombre de Start/Stop la valeur zéro pour le processus spécifié.

ThreadOff:TID

L'option THREADOFF arrête le profilage et la collecte de données d'un thread spécifique à l'aide de son ID de thread (tid).

D'autres processus ou threads continuent à rassembler des données. Cela est utile si vous ne voulez pas rassembler des données avant que le thread n'atteigne un certain état. Vous pouvez utiliser l'option THREADON, après que le thread a atteint un certain état, pour commencer la collecte de données. En interne, THREADOFF affecte au nombre de Start/Stop la valeur zéro pour le thread spécifié.

Cette option est uniquement valide en mode TRACE.

Args:Arguments

Arguments de l'application lancée.

Attach:PID[,PID]

Attache l'exemple de profileur aux ID du processus spécifié - identificateur de processus (pid) ou nom de processus.

Detach

Détache l'exemple de profileur de tous les processus.

PF[:n]

Exemples sur chaque numéro d'erreur de page (valeur par défaut=10).

Timer[:n]

Exemples sur chaque numéro de cycle (valeur par défaut=10000000).

Admin:Security, List

Répertorie l'état actuel des services de profilage ainsi que les autorisations utilisateur.

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.