Dela via


Start-Trace

Starta en loggningssession för händelsespårning.

Syntax

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

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Den här cmdleten startar en windows-händelsespårningsloggningssession.

Den här cmdleten används av följande cmdletar:

  • Enable-PSWSManCombinedTrace
  • Enable-WSManTrace

Du måste köra den här cmdleten från en upphöjd PowerShell-session.

Exempel

Exempel 1: Starta en WSMan-spårningsloggningssession

$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

Parametrar

-BufferSizeInKB

Buffertstorlek för händelsespårningssession i kilobyte (KB).

Typ:Int32
Position:Named
Standardvärde:0
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ETS

Skicka kommandon till händelsespårningssessioner direkt utan att spara eller schemalägga.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Format

Anger loggformatet för datainsamlaren. För SQL-databasformat måste du använda alternativet OutputFilePath på kommandoraden dsn!log med värdet . Standardvärdet är binärt (bin). Möjliga värden är:

  • bin - binär
  • bincirc – binär med cirkelloggning
  • csv – Kommaavgränsade värden
  • tsv – Tabbavgränsade värden
  • sql – SQL-databas
Typ:Object
Godkända värden:bin, bincirc, csv, tsv, sql
Position:Named
Standardvärde:bin
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxBuffers

Anger det maximala antalet händelsespårningssessionsbuffertar.

Typ:Int32
Position:Named
Standardvärde:256
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxLogFileSizeInMB

Anger den maximala loggfilsstorleken i mb eller antal poster för SQL-loggar.

Typ:Int32
Position:Named
Standardvärde:0 (no limit)
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinBuffers

Anger det minsta antalet händelsespårningssessionsbuffertar.

Typ:Int32
Position:Named
Standardvärde:0
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-OutputFilePath

Sökväg till utdataloggfilen eller namnet på DSN och logguppsättningen i en SQL-databas. Standardsökvägen är $env:systemdrive\PerfLogs\Admin.

Typ:String
Position:1
Standardvärde:$env:systemdrive\PerfLogs\Admin
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ProviderFilePath

Fil som visar flera händelsespårningsproviders som ska aktiveras.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SessionName

Namnet på händelsespårningssessionen. Om du vill stoppa en spårningssession måste du känna till sessionsnamnet.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.