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

Start-Trace -SessionName 'wsmlog' -ETS -OutputFilePath "$env:windir\system32\wsmtraces.log" -Format 'bincirc' -MinBuffers 16 -MaxBuffers 256 -BufferSizeInKb 64 -MaxLogFileSizeInMB 256 -ProviderFilePath "$env:windir\system32\wsmtraceproviders.txt"

Parametry

-BufferSizeInKB

Rozmiar buforu sesji śledzenia zdarzeń w kilobajtach (KB).

Type:Int32
Position:Named
Default value:0
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
Accept pipeline input:False
Accept wildcard characters:False

-Format

Określa format dziennika 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 są następujące:

  • bin — dane binarne
  • 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
Accept pipeline input:False
Accept wildcard characters:False

-MaxBuffers

Ustawia maksymalną liczbę buforów sesji śledzenia zdarzeń.

Type:Int32
Position:Named
Default value:256
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)
Accept pipeline input:False
Accept wildcard characters:False

-MinBuffers

Ustawia minimalną liczbę buforów sesji śledzenia zdarzeń.

Type:Int32
Position:Named
Default value:0
Accept pipeline input:False
Accept wildcard characters:False

-OutputFilePath

Ścieżka pliku dziennika wyjściowego lub nazwy DSN i 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
Accept pipeline input:False
Accept wildcard characters:False

-ProviderFilePath

Plik zawierający listę wielu dostawców śledzenia zdarzeń do włączenia.

Type:String
Position:2
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Dane wyjściowe

None