Attach
Die Attach-Option von "VSPerfCmd.exe" startet die Samplingprofilerstellung des laufenden Prozesses, der von der Prozess-ID (PID) angegeben wurde.
Um die Attach-Option verwenden zu können, müssen Sie die Sample-Methode in der Start-Option angeben.
Tipp
Wenn die Start-Option mit der Crosssession-Option angegeben wurde, müssen alle Aufrufe von VSPerfCmd /Attach oder VSPerfCmd /Detach auch Crosssession angeben.
VSPerfCmd.exe /Attach:ProcessID [Options]
Parameter
- ProcessID
Die Prozess-ID (PID) des laufenden Prozesses. Die PID eines laufenden Prozesses ist auf der Registerkarte "Prozesse" des Windows Task-Managers aufgeführt.
Gültige Optionen
Die folgenden VSPerfCmd-Optionen können mit der Attach-Option in einer einzelnen Befehlszeile kombiniert werden.
Crosssession
Aktiviert Profilerstellungsanwendungen in anderen Sitzungen als in der Anmeldesitzung. Erforderlich, wenn die Start-Option mit der Crosssession-Option angegeben wurde.**Start:**Method
Initialisiert die Befehlszeilen-Profilersitzung und legt die angegebene Profilerstellungsmethode fest.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.GlobalOnGlobalOff
Damit wird die Profilerstellung fortgesetzt (GlobalOn) oder angehalten (GlobalOff), die Profilerstellungssitzung wird jedoch nicht beendet.**ProcessOn:PIDProcessOff:**PID
Damit wird die Profilerstellung für den angegebenen Prozess fortgesetzt (ProcessOn) oder angehalten (ProcessOff).
Intervalloptionen
In der Attach-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]
Gibt die Anzahl und den Typ des Samplingintervalls an.Timer - Führt alle Cycles 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.
Beispiel
In diesem Beispiel wird das Anfügen einer Anwendung an eine laufende Instanz mit der Prozess-ID 12345 veranschaulicht.
VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp
VSPerfCmd.exe /Attach:12345
Siehe auch
Referenz
Konzepte
Profilerstellung für eigenständige Anwendungen über die Befehlszeile
Profilerstellung für ASP.NET-Webanwendungen über die Befehlszeile