Start-Trace

  • Referencia
Modul:
PSDiagnostics

Esemény nyomkövetési naplózási munkamenetének indítása.

Syntax

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

Description

Ez a parancsmag csak a Windows platformon érhető el.

Ez a parancsmag elindít egy Windows-eseménykövetési naplózási munkamenetet.

Ezt a parancsmagot a következő parancsmagok használják:

  • Enable-PSWSManCombinedTrace
  • Enable-WSManTrace

Ezt a parancsmagot emelt szintű PowerShell-munkamenetből kell futtatnia.

Példák

1. példa: WSMan-nyomkövetési naplózási munkamenet indítása

$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

Paraméterek

-BufferSizeInKB

Eseménykövetési munkamenet puffermérete kilobájtban (KB).

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

-ETS

Parancsok küldése közvetlenül az Eseménykövetési munkamenetekbe mentés és ütemezés nélkül.

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

-Format

Megadja az adatgyűjtő naplóformátumát. AZ SQL-adatbázis formátuma esetén az OutputFilePath lehetőséget kell használnia a parancssorban az dsn!log értékkel. Az alapértelmezett bináris (bin). A lehetséges értékek a következők:

  • bin – bináris
  • bincirc – bináris körkörös naplózással
  • csv – Vesszővel tagolt értékek
  • tsv – Tabulátorral elválasztott értékek
  • sql – SQL-adatbázis
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

Az eseménykövetési munkamenet puffereinek maximális számát állítja be.

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

-MaxLogFileSizeInMB

Megabájtban (MB) vagy az SQL-naplók rekordjainak számában megadott maximális naplófájlméretet adja meg.

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

-MinBuffers

Az eseménykövetési munkamenet puffereinek minimális számát állítja be.

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

-OutputFilePath

A kimeneti naplófájl vagy a DSN és a naplókészlet nevének elérési útja egy SQL-adatbázisban. Az alapértelmezett elérési út a következő $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

Több eseménykövetési szolgáltatót tartalmazó fájl, amely engedélyezhető.

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

-SessionName

Az eseménykövetési munkamenet neve. A nyomkövetési munkamenet leállításához ismernie kell a munkamenet nevét.

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

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.