Sdílet prostřednictvím

Start-Trace

Modul:
PSDiagnostics Module

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

Syntaxe

Default (Výchozí) 

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

Vlastnosti parametru

Typ:Int32
Default value:0
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ETS

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Format

Určuje formát protokolu pro kolekci dat. Pro formát databáze SQL je nutné použít možnost OutputFilePath na příkazovém řádku s hodnotou dsn!log. 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

Vlastnosti parametru

Typ:Object
Default value:bin
Přípustné hodnoty:bin, bincirc, csv, tsv, sql
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaxBuffers

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

Vlastnosti parametru

Typ:Int32
Default value:256
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaxLogFileSizeInMB

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

Vlastnosti parametru

Typ:Int32
Default value:0 (no limit)
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MinBuffers

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

Vlastnosti parametru

Typ:Int32
Default value:0
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:$Env:SystemDrive\PerfLogs\Admin
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ProviderFilePath

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:2
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SessionName

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

None

Tento cmdlet nevrátí žádný výstup.