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.