Dela via

Start-Trace

Modul:
PSDiagnostics Module

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

Syntax

Default (Standard) 

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

Beskrivning

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

Parameteregenskaper

Typ:Int32
Standardvärde:0
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-ETS

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-Format

Anger loggformatet för datainsamlaren. För SQL-databasformat måste du använda alternativet OutputFilePath på kommandoraden med värdet dsn!log. 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

Parameteregenskaper

Typ:Object
Standardvärde:bin
Godkända värden:bin, bincirc, csv, tsv, sql
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-MaxBuffers

Anger det maximala antalet händelsespårningssessionsbuffertar.

Parameteregenskaper

Typ:Int32
Standardvärde:256
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-MaxLogFileSizeInMB

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

Parameteregenskaper

Typ:Int32
Standardvärde:0 (no limit)
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-MinBuffers

Anger det minsta antalet händelsespårningssessionsbuffertar.

Parameteregenskaper

Typ:Int32
Standardvärde:0
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:$Env:SystemDrive\PerfLogs\Admin
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:1
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-ProviderFilePath

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:2
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-SessionName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Ingångar

None

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

Utgångar

None

Den här cmdleten returnerar inga utdata.