Start-Trace
Uruchom sesję rejestrowania śledzenia zdarzeń.
Składnia
Start-Trace
[-SessionName] <String>
[[-OutputFilePath] <String>]
[[-ProviderFilePath] <String>]
[-ETS]
[-Format <String>]
[-MinBuffers <Int32>]
[-MaxBuffers <Int32>]
[-BufferSizeInKB <Int32>]
[-MaxLogFileSizeInMB <Int32>]
[<CommonParameters>]
Opis
To polecenie cmdlet jest dostępne tylko na platformie Windows.
To polecenie cmdlet uruchamia sesję rejestrowania śledzenia zdarzeń systemu Windows.
To polecenie cmdlet jest używane przez następujące polecenia cmdlet:
Enable-PSWSManCombinedTrace
Enable-WSManTrace
To polecenie cmdlet należy uruchomić z sesji programu PowerShell z podwyższonym poziomem uprawnień.
Przykłady
Przykład 1. Uruchamianie sesji rejestrowania śledzenia programu WSMan
$parameters = @{
SessionName = 'wsmlog'
ETS = $true
OutputFilePath = "$env:windir\system32\wsmtraces.log"
Format = 'bincirc'
MinBuffers = 16
MaxBuffers = 256
BufferSizeInKb = 64
MaxLogFileSizeInMB = 256
ProviderFilePath = "$env:windir\system32\wsmtraceproviders.txt"
}
Start-Trace @parameters
Parametry
-BufferSizeInKB
Rozmiar buforu sesji śledzenia zdarzeń w kilobajtach (KB).
Type: | Int32 |
Position: | Named |
Default value: | 0 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ETS
Wysyłanie poleceń do sesji śledzenia zdarzeń bezpośrednio bez zapisywania ani planowania.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Format
Określa format dziennika dla modułu zbierającego dane. W przypadku formatu bazy danych SQL należy użyć opcji OutputFilePath w wierszu polecenia z wartością dsn!log
. Wartość domyślna to bin (bin). Możliwe wartości to:
- bin — bin
- bincirc — dane binarne z rejestrowaniem okrągłym
- csv — wartości rozdzielane przecinkami
- tsv — wartości rozdzielane tabulatorami
- sql — baza danych SQL
Type: | Object |
Accepted values: | bin, bincirc, csv, tsv, sql |
Position: | Named |
Default value: | bin |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxBuffers
Ustawia maksymalną liczbę buforów sesji śledzenia zdarzeń.
Type: | Int32 |
Position: | Named |
Default value: | 256 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxLogFileSizeInMB
Ustawia maksymalny rozmiar pliku dziennika w megabajtach (MB) lub liczbie rekordów dla dzienników SQL.
Type: | Int32 |
Position: | Named |
Default value: | 0 (no limit) |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinBuffers
Ustawia minimalną liczbę buforów sesji śledzenia zdarzeń.
Type: | Int32 |
Position: | Named |
Default value: | 0 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputFilePath
Ścieżka pliku dziennika wyjściowego lub nazwy DSN i nazwy zestawu dzienników w bazie danych SQL. Domyślna ścieżka to $env:systemdrive\PerfLogs\Admin
.
Type: | String |
Position: | 1 |
Default value: | $env:systemdrive\PerfLogs\Admin |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProviderFilePath
Plik zawierający listę wielu dostawców śledzenia zdarzeń w celu włączenia.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SessionName
Nazwa sesji śledzenia zdarzeń. Aby zatrzymać sesję śledzenia, musisz znać nazwę sesji.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
None
Nie można potokować obiektów do tego polecenia cmdlet.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla