Sdílet prostřednictvím


Start-Trace

Spusťte relaci protokolování trasování událostí.

Syntax

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Tato rutina spustí relaci protokolování trasování událostí systému Windows.

Tuto rutinu používají následující rutiny:

  • Enable-PSWSManCombinedTrace
  • Enable-WSManTrace

Tuto rutinu musíte spustit z relace PowerShellu se zvýšenými oprávněními.

Příklady

Příklad 1: Spuštění relace protokolování trasování 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

Velikost vyrovnávací paměti relace trasování událostí v kilobajtech (KB).

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

-ETS

Odesílání příkazů do relací trasování událostí přímo bez uložení nebo plánování

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Format

Určuje formát protokolu pro kolekci dat. Pro formát databáze SQL je nutné použít outputFilePath možnost na příkazovém řádku s dsn!log hodnotou. Výchozí hodnota je binární (bin). Možné hodnoty:

  • bin – binární
  • bincirc – binární soubor s kruhovým protokolováním
  • csv – hodnoty oddělené čárkami
  • tsv – hodnoty oddělené tabulátorem
  • SQL – Databáze 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

Nastaví maximální počet vyrovnávacích pamětí relace trasování událostí.

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

-MaxLogFileSizeInMB

Nastaví maximální velikost souboru protokolu v megabajtech (MB) nebo počtu záznamů pro protokoly SQL.

Type:Int32
Position:Named
Default value:0 (no limit)
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinBuffers

Nastaví minimální počet vyrovnávacích pamětí relace trasování událostí.

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

-OutputFilePath

Cesta k výstupnímu souboru protokolu nebo dsN a názvu sady protokolů v databázi SQL Výchozí cesta je $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

Soubor se seznamem několika zprostředkovatelů trasování událostí, které chcete povolit.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SessionName

Název relace trasování událostí. Pokud chcete zastavit relaci trasování, musíte znát název relace.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

None

Tato rutina nevrátí žádný výstup.