VSPerfCmd
Mit dem Tool VSPerfCmd.exe wird die Sammlung von Leistungsdaten gestartet und beendet. Es verwendet die folgende Syntax:
VSPerfCmd [/U] [/options]
In der folgenden Tabelle werden die Optionen des Tools VSPerfCmd.exe beschrieben:
Option |
Beschreibungen |
|---|---|
U |
Umgeleitete Konsolenausgaben sind als Unicode geschrieben. Muss die erste angegebene Option sein. |
Starten:mode |
Startet den Profilerstellungsdienst im angegebenen Modus. |
Ausgabe:filename |
Legt den Namen der Ausgabedatei fest. Nur zusammen mit Start. |
Aktiviert die Profilerstellung über Windows-Sitzungen hinweg. Nur zusammen mit Start, Attach, or Launch. |
|
Benutzer:[domain\]username |
Gewährt dem angegebenen Konto Zugriff auf den Profilerdienst. Nur zusammen mit Start. |
WaitStart[:n] |
Wartet darauf, dass die Protokollierung für die Datenerfassung initialisiert wird. Wenn n angegeben ist, wartet VSPerfCmd höchstens n Sekunden. Wenn n nicht angegeben wird, wartet VSPerfCmd unendlich lange. Dies vereinfacht die Verwendung von VSPerfCmd in einem Batchprozess. |
Zähler:cfg |
Wenn die Samplingmethode für die Profilerstellung verwendet wird, wird ein CPU-Indikator angegeben sowie die Anzahl der als Samplingintervall zu verwendenden Ereignisse. Sie können nur für einen Zählerwert ein Sampling ausführen. Wenn die Instrumentationsmethode für die Profilerstellung verwendet wird, gibt diese einen CPU-Indikator an, der an jedem Instrumentationspunkt aufzulisten ist. Nur zusammen mit Start:Trace, Attachoder Launch. |
Zeigt eine Liste gültiger CPU-Leistungsindikatoren für den aktuellen Computer an. |
|
WinCounter:path |
Gibt ein Windows-Leistungsindikatorereignis an, das in die Profilmarkierungsdaten aufgenommen werden soll. Nur zusammen mit Start. |
AutoMark:n |
Gibt das Zeitintervall (in Millisekunden) für die Sammlung der Werte von Windows-Leistungsindikatordaten an. Mit WinCounter zu verwenden. |
Ereignisse:option |
Steuert die Sammlung der angegebenen Ereignisse der Ereignisablaufverfolgung für Windows (ETW). ETW-Daten werden in einer ITL-Datei getrennt von der Profilerstellungs-Datendatei (.vsp) gesammelt. |
Zeigt den Zustand des Profilers, Informationen zu Prozessen, für die gerade ein Profil erstellt wird, und die Konten an, die berechtigt sind, den Profiler zu steuern. |
|
Shutdown[:n] |
Schließt die Profilerstellungs-Datendatei und deaktiviert den Profiler. |
Setzt nach einem Aufruf von VSPerfCmdGlobalOff die Datensammlung fort. |
|
Beendet die gesamte Datensammlung, beendet aber nicht die Profilerstellungssitzung. |
|
ProcessOn:pid |
Setzt die Datensammlung für den angegebenen Prozess fort, nachdem die Profilerstellung durch einen Aufruf von VSPerfCmdProcessOff angehalten wurde. |
ProcessOff:pid |
Beendet die Datensammlung für den angegebenen Prozess. |
Setzt Profilerstellung für den angegebenen Prozess fort, nachdem die Profilerstellung durch einen Aufruf von VSPerfCmdThreadOff angehalten wurde. Verwenden Sie ThreadOn nur, wenn Sie Profile mit der Instrumentationsmethode erstellen. |
|
Hält die Profilerstellung für den angegebenen Thread an. Verwenden Sie ThreadOff nur, wenn Sie Profile mit der Instrumentationsmethode erstellen. |
|
Mark:MarkNum[,MarkText] |
Fügt eine Markierung mit einem optionalen Text in die Profilerstellungs-Datendatei ein. |
Optionen der Samplingmethode
Die folgenden Optionen sind nur beim Verwenden der Samplingmethode für die Profilerstellung verfügbar.
Option |
Beschreibungen |
|---|---|
Starten:Executable |
Startet die angegebene Anwendung und beginnt mit der Profilerstellung. |
Args:Argumente |
Gibt Befehlszeilenargumente an, die an die Anwendung übergeben werden sollen. |
Startet den angegebenen Befehl in einem neuen Eingabeaufforderungsfenster. |
|
Attach:PID[,PID] |
Startet die Profilerstellung für die angegebenen Prozesse. Prozesse können über die Prozess-ID oder den Prozessnamen identifiziert werden. |
Detach[:PID[,PID]] |
Beendet die Profilerstellung für die angegebenen Prozesse. Prozesse können über die Prozess-ID oder den Prozessnamen identifiziert werden. Wenn kein Prozess angegeben wird, wird die Profilerstellung für alle Prozesse angehalten. |
GC[:{Allocation|Lifetime}] |
Sammelt .NET-Speicherbelegungsinformationen und Daten zur Objektlebensdauer. Nur zusammen mit der VSPerfCmd Launch-Option verwenden. |
Samplingintervalloptionen
Die folgenden Optionen geben den Typ und die Dauer von Samplingintervallen an. Der Standardwert ist Timer. Mit der Counter-Option können Sie auch einen CPU-Leistungsindikator als Intervall angeben. Diese Optionen können nur mit Launch oder dem ersten Attach einer Profilerstellungssitzung angegeben werden.
Option |
Beschreibungen |
|---|---|
PF[:n] |
Führt ein Sampling bei jedem x-ten Seitenfehler durch (Standard=10). |
Sys (VSPerfCmd)[:n] |
Führt ein Sampling bei jedem x-ten Systemaufruf durch (Standard=10). |
Zeitgeber[:n] |
Führt ein Sampling bei jedem n-ten Prozessorzyklus durch (Standard=10000000). |
Optionen der Dienstkomponente und Gerätetreiber für den Kernelmodus
Die folgenden Administratoroptionen unterstützen Komponenten für Profilerstellungsdienste oder Gerätetreiber für den Kernelmodus. Die Administratoroptionen legen Profilerstellungsberechtigungen fest und steuern den Dienst für die Profilerstellung oder den Gerätetreiber.
Administratoroptionen müssen an einer Eingabeaufforderung ausgeführt werden, die mit Administratorrechten ausgeführt wird.
Option |
Beschreibungen |
|---|---|
Admin:Security <ALLOW|DENY> Recht[ Recht] <Benutzer|Gruppe> |
Gewährt oder verweigert dem angegebenen Benutzer oder der angegebenen Gruppe den Zugriff auf die Profilerstellungsdienste. Right kann Folgendes sein: CrossSession: Gewährt dem Benutzer Zugriff auf den Dienst für die sitzungsübergreifende Profilerstellung. SampleProfiling: Gewährt dem Benutzer Zugriff auf den Treiber für die Sampling-Profilerstellung. Wird auch für den Zugriff auf Kernelübergangsinformationen während der Erstellung von Ablaufverfolgungsprofilen verwendet. FullAccess: Gewährt dem Benutzer Zugriff sowohl auf CrossSession als auch auf SampleProfiling. |
Admin:Security, List |
Listet den aktuellen Zustand von Profilerstellungsdiensten und Benutzerberechtigungen auf. |
Admin:<Dienst|Treiber><START|STOP|INSTALL|UNINSTALL> |
Startet, beendet, installiert oder deinstalliert die Komponente (Dienst) für den Profilerstellungsdienst oder den Gerätetreiber (Treiber) für den Kernelmodus. |
Admin:<Dienst|Treiber>AutoStart<ON|OFF> |
Aktiviert oder deaktiviert den automatischen Start des Profilerstellungsdienstes (Dienst) oder des Gerätetreibers (Treiber) für den Kernelmodus nach einem Neustart. |
VSPerfCmd /Driver
Die VSPerfCmd /Driver-Option ist veraltet. Verwenden Sie die Admin-Optionen von VsPerfCmd für diese Funktionalität.