VSPerfCmd
Narzędzie VSPerfCmd.exe jest używane do uruchamiania i zatrzymywania zbierania danych wydajności.Używa ono następującej składni:
VSPerfCmd [/U] [/options]
W poniższych tabelach opisano opcje narzędzia VSPerfCmd.exe.
Opcja |
Opis |
|---|---|
U |
Przekierowane dane wyjściowe z konsoli są zapisywane jako Unicode.Ta opcja musi zostać określona jako pierwsza. |
Uruchamianie:mode |
Uruchamia usługę profilowania w określonym trybie. |
Dane wyjściowe:filename |
Określa nazwę pliku wyjściowego.Należy używać wyłącznie z Start. |
Włącza profilowanie wszystkich sesji systemu Windows.Należy używać wyłącznie z Start, Attach, or Launch. |
|
User:[domain\]username |
Włącza dostęp określonego konta do usługi profilera.Należy używać wyłącznie z Start. |
WaitStart[:n] |
Czeka na zainicjowanie rejestratora zbierania danych.Jeśli parametr n jest określony, VSPerfCmd będzie czekać najwyżej n sekund.Jeśli parametr n nie jest określony, VSPerfCmd będzie czekać w nieskończoność.Ułatwia to wykorzystanie VSPerfCmd jako części procesu wsadowego. |
Licznik:cfg |
W przypadku używania metody próbkowania, określa licznika procesora i liczbę zdarzeń używanych jako interwał próbkowania.Możesz pobrać jako próbkę tylko jedną wartość licznika. W przypadku profilowania przy użyciu metody instrumentacji, określa licznik procesora do zebrania w każdym punkcie instrumentacji.Należy używać wyłącznie z Start:Trace, Attach,lub Launch. |
Wyświetla listę prawidłowych liczników procesora dla bieżącego komputera. |
|
WinCounter:path |
Określa licznik zdarzenia wydajności systemu Windows, dołączany ze znacznikiem profilowania danych.Należy używać wyłącznie z Start. |
AutoMark:n |
Określa interwał (w milisekundach) pomiędzy zdarzenia zbierania danych licznika wydajności systemu Windows.Należy używać wyłącznie z WinCounter. |
Zdarzenia:option |
Kontroluje zbieranie określonych zdarzeń śledzenia dla systemu Windows (ETW).Dane ETW są gromadzone w pliku .itl, który nie jest plikiem profilowania danych (.vsp). |
Wyświetla stan profilera, informacje dotyczące procesów, które są aktualnie profilowane i kont, które mogą kontrolować profiler. |
|
Shutdown[:n] |
Zamyka plik danych profilowania i wyłącza profiler. |
Wznawia zbieranie danych po wywołaniu VSPerfCmdGlobalOff. |
|
Zatrzymuje wszystkie zbierania danych, ale nie kończy sesji profilowania. |
|
ProcessOn:pid |
Wznawia zbieranie danych dla określonego procesu, po tym jak profilowanie zostało wstrzymane przez wywołanie VSPerfCmdProcessOff. |
ProcessOff:pid |
Zatrzymuje zbieranie danych dla określonego procesu. |
Wznawia profilowanie dla określonego procesu, po tym jak profilowanie zostało wstrzymane przez wywołanie VSPerfCmdThreadOff.Użyj ThreadOn tylko wtedy, gdy profilowanie odbywa się metodą instrumentacji. |
|
Wstrzymuje profilowania dla określonego wątku.Użyj ThreadOff tylko wtedy, gdy profilowanie odbywa się metodą instrumentacji. |
|
Znacznik:MarkNum[,MarkText] |
Wstawia znacznik do pliku danych profilowania, z opcjonalnym tekstem. |
Opcje metody próbkowania
Następujące opcje są dostępne tylko podczas korzystania z profilowania metodą próbkowania.
Opcja |
Opis |
|---|---|
Uruchom:Executable |
Uruchamia określoną aplikację i rozpoczyna profilowanie. |
Args:Arguments |
Określa argumenty wiersza polecenia przekazywane do uruchomionej aplikacji. |
Uruchamia określone polecenie w nowym oknie wiersza polecenia. |
|
Dołącz:PID[,PID] |
Rozpoczyna profilowanie określonego procesu.Procesy można zidentyfikować przez identyfikator procesu lub nazwę procesu. |
Odłącz[:PID[,PID]] |
Zatrzymuje profilowanie określonego procesuProcesy można zidentyfikować przez identyfikator procesu lub nazwę procesu.Jeśli proces nie jest określony, profilowanie jest zatrzymane dla wszystkich procesów. |
GC[:{Allocation|Lifetime}] |
Zbiera dane alokacji pamięci .NET i okresu istnienia obiektu.Należy używać tylko z opcją VSPerfCmdLaunch. |
Opcje interwału próbkowania
Następujące opcje określają typ i długość trwania interwałów próbkowania.Wartość domyślna to Timer.Jako interwał możesz także określić licznik procesora, używając opcji Counter.Te opcje mogą zostać określone tylko z Launch lub z pierwszym Attach sesji profilowania.
Opcja |
Opis |
|---|---|
PF[:n] |
Próbkuje na każdym n-tym błędzie strony (domyślnie=10). |
Sys (VSPerfCmd)[:n] |
Próbuje na każdym n-tym wywołaniu systemowym (domyślnie=10). |
Timer[:n] |
Próbkuje na każdym n-tym cyklu procesora (domyślnie=10000000). |
Opcje składnika usługi i sterownika trybu jądra
Następujące opcje administracyjne obsługują profilowanie składników usługi lub sterowników trybu jądra.Opcje administratora ustawiają uprawnienia profilowania i kontrolują profilowaną usługę lub sterownik urządzenia.
Opcje administracyjne muszą być wykonane w wierszu polecenia, który działa z poświadczeniami administracyjnymi.
Opcja |
Opis |
|---|---|
Admin:Security <ALLOW|DENY> Right[ Right] <User|Group> |
Udziela lub odmawia określonemu użytkownikowi lub grupie dostępu do usług profilowania. Right może być: CrossSession - zapewnia użytkownikowi dostęp do usługi profilowania między sesjami. SampleProfiling - daje użytkownikowi dostęp do sterownika, aby włączyć profilowanie metodą próbkowania.Używane także do uzyskania dostępu do informacji o przejściach jądra, podczas śledzenia profilowania. FullAccess - daje użytkownikowi dostęp zarówno do CrossSession, jak i SampleProfiling. |
Admin:Security, List |
Wyświetla listę aktualnych stanów usług profilowania oraz listę uprawnień użytkownika. |
Admin:<Service|Driver><START|STOP|INSTALL|UNINSTALL> |
Uruchamia, zatrzymuje, instaluje lub odinstalowuje składnik (service) usługi profilowania lub sterownik (driver) trybu jądra. |
Admin:<Service|Driver>AutoStart<ON|OFF> |
Włącza lub wyłącza automatyczne uruchamianie usługi (service) profilowania lub sterownik (driver) trybu jądra po ponownym uruchomieniu komputera. |
VSPerfCmd /Driver
Opcja VSPerfCmd /Driver jest obecnie przestarzała.Użyj opcji VsPerfCmdAdmin dla tej funkcji.