Megosztás a következőn keresztül:

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

Típus:Int32
Position:Named
Alapértelmezett érték:0
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ETS

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

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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
Típus:Object
Elfogadott értékek:bin, bincirc, csv, tsv, sql
Position:Named
Alapértelmezett érték:bin
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxBuffers

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

Típus:Int32
Position:Named
Alapértelmezett érték:256
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxLogFileSizeInMB

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

Típus:Int32
Position:Named
Alapértelmezett érték:0 (no limit)
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MinBuffers

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

Típus:Int32
Position:Named
Alapértelmezett érték:0
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:String
Position:1
Alapértelmezett érték:$env:systemdrive\PerfLogs\Admin
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ProviderFilePath

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

Típus:String
Position:2
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.