Starten

Die Launch-Option startet den Profiler mithilfe der Samplingmethode. Darüber hinaus startet sie auch die angegebene Anwendung.

Um die Launch-Option verwenden zu können, müssen Sie die Sample-Methode in der Start-Option angeben.

VSPerfCmd.exe /Launch:AppName [Options]

Parameter

• AppName
  Der Name der Anwendung, die gestartet werden soll. Vollständige Pfade und Teilpfade vom aktuellen Verzeichnis werden unterstützt.

Gültige Optionen

Die folgenden VSPerfCmd-Optionen können in Verbindung mit der Launch-Option in einer einzelnen Befehlszeile kombiniert werden.

• **Start:**Method
  Initialisiert die Befehlszeilen-Profilersitzung und legt die angegebene Profilerstellungsmethode fest.

• GlobalOnundGlobalOff
  Damit wird die Profilerstellung fortgesetzt (GlobalOn) oder angehalten (GlobalOff), die Profilerstellungssitzung wird jedoch nicht beendet.

• **ProcessOn:**PID und ProcessOff:PID
  Damit wird die Profilerstellung für den angegebenen Prozess fortgesetzt (ProcessOn) oder angehalten (ProcessOff).

• TargetCLR
  Gibt die Version der .NET Framework-CLR (Common Language Runtime) an, für die ein Profil erstellt werden soll, wenn in einer Profilerstellungssitzung mehr als eine Version geladen wurde. Standardmäßig wird die zuerst geladene Version für die Profilerstellung verwendet.

Exklusive Optionen

Die folgenden Optionen können nur in Verbindung mit der Launch-Option verwendet werden.

• Console
  Startet die angegebene Befehlszeilenanwendung in einem neuen Fenster.

• **Args:**ArgList
  Gibt die Liste der an die Anwendung zu übergebenden Argumente an.

• LineOff
  Deaktiviert der Auflistung von Profilerstellungsdaten auf Zeilenebene.

Samplingoptionen

In der Launch-Befehlszeile kann eine der folgenden Samplingintervalloptionen angegeben werden. Das Standardsamplingintervall beträgt 10.000.000 Prozessortaktzyklen.

• Timer[**:Cycles]PF[:Events]Sys[:Events]Counter[:**Name,Reload,FriendlyName]GC[:allocation|lifetime]
  Gibt die Anzahl und den Typ des Samplingintervalls an.

  • Timer - Führt alle Cycles nicht angehaltene Prozessortaktzyklen ein Sampling durch. Wenn Cycles nicht angegeben ist, werden 10.000.000 Zyklen verwendet.

  • PF - Führt alle Events Seitenfehler ein Sampling durch. Wenn Events nicht angegeben ist, werden 10 Seitenfehler verwendet.

  • Sys - Führt alle Events Aufrufe des Betriebssystems ein Sampling durch. Wenn Events nicht angegeben ist, werden 10 Systemaufrufe verwendet.

  • Counter - Führt alle Reload CPU-Leistungsindikatoren, die mit Name angegeben sind, ein Sampling durch. Optional kann FriendlyName eine Zeichenfolge angeben, die in Profilerberichten als Spaltenüberschrift verwendet werden soll.

  • GC - Sammelt .NET-Arbeitsspeicherdaten. Standardmäßig (allocation) werden Daten bei jeder Speicherbelegung gesammelt. Wenn der lifetime-Parameter angegeben wird, werden Daten auch bei jedem Garbage Collection-Ereignis erfasst.

Beispiel

In diesem Beispiel wird die Verwendung der Launch-Option zum Starten einer Anwendung veranschaulicht.

VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp
VSPerfCmd.exe /Launch:TestApp.exe

Siehe auch

Referenz

VSPerfCmd

Konzepte

Profilerstellung für eigenständige Anwendungen über die Befehlszeile

Profilerstellung für ASP.NET-Webanwendungen über die Befehlszeile

Profilerstellung für Dienste über die Befehlszeile