VSPerfCmd

U

Umgeleitete Konsolenausgaben sind als Unicode geschrieben. Muss erste angegebene Option sein.

Output:filename

Legt den Namen der Ausgabedatei fest.

User:[domain\]username

Wird mit START-Option verwendet. Ermöglicht Clientzugriff auf den Monitor über das angegebene Konto.

Counter: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. Sie können mehrere Indikatordaten sammeln, indem Sie mehrere Indikatoroptionen angeben (nur Instrumentation).

Verwenden Sie die folgende Syntax, um die Indikatordaten (cfg) anzugeben:

CounterName[,Reload[,FriendlyName]]

• CounterName ist der Name eines Zählers, der durch den VSPerfCmd /QueryCounters-Befehl zurückgegeben wird.

• Reload ist das Samplingintervall des Zählerereignisses. Erneut laden wird ignoriert, wenn Sie die Instrumentationsmethode verwenden.

• FriendlyName Optional. Wenn angegeben, eine Zeichenfolge, die den CounterName-Wert in Profilerstellungstools-Ansichten und -Berichten ersetzt.

WinCounter:path

Gibt einen Windows-Leistungsindikator an, der in den Markierungsdaten enthalten sein soll. path ist eine Windows-Leistungsindikator-Zeichenfolge im PDH-Zählerpfadformat. Beispiele:

\Processor(0)\% Processor Time

\System\Context Switches/sec

Events:option

EVENTS-Option steuert die Event Trace Window-Ereignissammlung (ETW). Die erfassten Daten werden vom ETW-Anbieter bereitgestellt. Das option Format lautet folgendermaßen:

<on | off>, <guid>[,flags[,level]]

<on | off>, <Anbietername>[,flags[,level]]

guid – die GUID des Steuerelements des Anbieters. Alternativ kann auch der Name eines Anbieters anstatt der GUID angegeben werden, wenn dieser bei WMI registriert ist.

flags – ein mit dem Präfix '0x' versehener hexadezimaler Flagwert. Dieser Wert wird vom Ereignisanbieter definiert. Weitere Informationen finden Sie in der Dokumentation zum ETW-Anbieter.

level – bestimmt die Menge der zu erfassenden Informationen. Dieser Wert wird vom Ereignisanbieter definiert. Weitere Informationen finden Sie in der Dokumentation zum ETW-Anbieter.

Wichtiger Hinweis:

Wenn CLR-ETW-Ereignisse aktiviert sind, werden zusätzliche Startdaten auch im Ablaufverfolgungsansichtsbericht erfasst. Verwenden Sie den folgenden Befehl, um Startereignisse von der Anzeige im Bericht auszuschließen:C:\<Pfad>VSPerfCmd -events on, \".NET Common Language Runtime\", 0x7fffffff, 5 Wenn Sie die Startereignisse nicht ausschließen, da diese Ereignisse nicht in der MOF-Datei (Managed Object Format) angezeigt werden, werden sie im Bericht als GUIDS angezeigt. Weitere Informationen hierzu finden Sie unter Sample Managed Object Format (MOF) File.

Zudem kann die EVENTS-Option mit folgenden allgemeinen Kerneloptionen verwendet werden:

on, option[,option]

wobei option einen der folgenden Werte aufweisen kann:

Process – Prozessereignisse

Thread – Threadereignisse

Image – Abbildlad- und Abbildentladereignisse

Disk – Datenträger-E/A-Ereignisse

File – Datei-E/A-Ereignisse

Hardfault – Hardwareseitenfehler

Pagefault – Softwareseitenfehler

Network – Netzwerkereignisse

Registry - Registrierungszugriffsereignisse

Beachten Sie, dass der Kernelprovider nur aktiviert werden kann. Er ist erst deaktiviert, und seine Flags können erst bearbeitet werden, wenn der Monitor heruntergefahren ist.

ShutDown[:n]

Wartet darauf, dass überwachte Anwendungen heruntergefahren oder getrennt werden, und beendet VSPerfMon.exe und wartet dann darauf, dass der Prozess des Herunterfahrens abgeschlossen wird. Wenn n angegeben ist, wartet VSPerfCmd mindestens n Sekunden. Wenn n nicht angegeben wird, wartet VSPerfCmd endlos lange. Dies vereinfacht die Verwendung von VSPerfCmd im Rahmen eines Batchprozesses.

GlobalOff

Die GLOBALOFF-Option deaktiviert alle Profilerstellungen, und es werden keine Daten erfasst. Durch diese Option wird die Leistungssitzung nicht heruntergefahren. Sie können diese Option verwenden, damit während des Anwendungsstarts oder der Initialisierungsphase keine Daten erfasst werden.

So vermeiden Sie das Erfassen irrelevanter Daten

ProcessOff:pid

Die PROCESSOFF-Option beendet die Profilerstellung und die Datenerfassung eines bestimmten Prozesses mithilfe der zugehörigen Prozess-ID (pid). Andere Prozesse oder Threads setzen die Datenerfassung fort. Dies ist hilfreich, wenn Sie vermeiden möchten, dass Daten erfasst werden, bevor der Prozess einen bestimmten Zustand erreicht. Mithilfe der PROCESSON-Option können Sie die Datenerfassung starten, sobald der Prozess einen bestimmten Zustand erreicht hat. Intern legt PROCESSOFF die Start/Stop-Anzahl für den angegebenen Prozess auf 0 (null) fest.

ThreadOff:tid

Die THREADOFF-Option beendet die Profilerstellung und Datenerfassung eines bestimmten Threads mithilfe der zugehörigen Thread-ID (tid).

Andere Prozesse oder Threads setzen die Datenerfassung fort. Dies ist hilfreich, wenn Sie vermeiden möchten, dass Daten erfasst werden, bevor der Thread einen bestimmten Zustand erreicht. Mithilfe der THREADON-Option können Sie die Datenerfassung starten, sobald der Thread einen bestimmten Zustand erreicht hat. Intern legt THREADOFF die Start/Stop-Anzahl für den angegebenen Thread auf 0 (null) fest.

Diese Option ist nur im TRACE-Modus gültig.

Args:Arguments

Argumente für die gestartete Anwendung.

Attach:PID[,PID]

Fügt den samplingbasierten Profiler an die angegebenen Prozess-IDs an – PID oder Prozessname.

Detach

Trennt den samplingbasierten Profiler von allen Prozessen.

PF[:n]

Führt ein Sampling bei jedem x-ten Seitenfehler durch (Standard=10).

Timer[:n]

Führt ein Sampling bei jedem x-ten Zyklus durch (Standard=10000000).

Admin:Security, List

Listet den aktuellen Zustand von Profilerstellungsdiensten und Benutzerberechtigungen auf.

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.