Start-Trace

  • Odwołanie
Moduł:
PSDiagnostics

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.