Udostępnij za pośrednictwem

Start-Trace

Moduł:
PSDiagnostics Module

Uruchom sesję rejestrowania śledzenia zdarzeń.

Składnia

Default (domyślnie) 

Start-Trace
    [-SessionName] <String>
    [[-OutputFilePath] <String>]
    [[-ProviderFilePath] <String>]
    [-ETS]
    [-Format <String>]
    [-MinBuffers <Int32>]
    [-MaxBuffers <Int32>]
    [-BufferSizeInKB <Int32>]
    [-MaxLogFileSizeInMB <Int32>]
    [<CommonParameters>]

Opis

Ten cmdlet jest dostępny tylko na platformie Windows.

To polecenie cmdlet uruchamia sesję rejestrowania śledzenia zdarzeń systemu Windows.

To polecenie cmdlet jest używane przez następujące cmdlety:

  • Enable-PSWSManCombinedTrace
  • Enable-WSManTrace

Cmdlet należy uruchomić z podwyższonej sesji PowerShell.

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).

Właściwości parametru

Typ:Int32
Domyślna wartość:0
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ETS

Wysyłaj polecenia bezpośrednio do sesji śledzenia zdarzeń bez zapisywania ani planowania.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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

Właściwości parametru

Typ:Object
Domyślna wartość:bin
Dopuszczalne wartości:bin, bincirc, csv, tsv, sql
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MaxBuffers

Ustawia maksymalną liczbę sesji śledzenia zdarzeń.

Właściwości parametru

Typ:Int32
Domyślna wartość:256
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MaxLogFileSizeInMB

Ustawia maksymalny rozmiar pliku dziennika w megabajtach (MB) lub liczbie rekordów dla dzienników SQL.

Właściwości parametru

Typ:Int32
Domyślna wartość:0 (no limit)
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MinBuffers

Ustawia minimalną liczbę sesji śledzenia zdarzeń.

Właściwości parametru

Typ:Int32
Domyślna wartość:0
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:String
Domyślna wartość:$Env:SystemDrive\PerfLogs\Admin
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ProviderFilePath

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

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:2
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SessionName

Nazwa sesji śledzenia zdarzeń. Aby zatrzymać sesję śledzenia, musisz znać nazwę sesji.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Nie można przekazywać obiektów do tego cmdletu.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.