Start-Trace

模組:
PSDiagnostics Module

啟動事件追蹤記錄會話。

語法

Default (預設值) 

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

Description

此 Cmdlet 只能在 Windows 平臺上使用。

此 Cmdlet 會啟動 Windows 事件追蹤記錄會話。

下列 Cmdlet 會使用此 Cmdlet：

  • Enable-PSWSManCombinedTrace
  • Enable-WSManTrace

您必須從具有管理員權限的 PowerShell 工作階段執行此 cmdlet。

範例

範例 1：啟動 WSMan 追蹤記錄工作階段

$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

參數

-BufferSizeInKB

事件追蹤會話緩衝區大小以 KB 為單位。

參數屬性

類型:Int32
預設值:0
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ETS

直接將命令傳送至事件追蹤會話，而不儲存或排程。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Format

指定資料收集器的記錄格式。 針對 SQL 資料庫格式，您必須在命令行中使用 OutputFilePath 選項搭配 dsn!log 值。 預設值為 binary （bin）。 可能的值為：

  • bin - 二進位
  • bincirc - 具有循環記錄的二進位
  • csv - 逗號分隔值
  • tsv - Tab 分隔值
  • sql - SQL Database

參數屬性

類型:Object
預設值:bin
接受的值:bin, bincirc, csv, tsv, sql
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MaxBuffers

設定事件追蹤會話緩衝區的最大數目。

參數屬性

類型:Int32
預設值:256
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MaxLogFileSizeInMB

設定 SQL 記錄的記錄檔大小上限，以 MB 為單位或記錄數目。

參數屬性

類型:Int32
預設值:0 (no limit)
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MinBuffers

設定事件追蹤會話緩衝區的最小數目。

參數屬性

類型:Int32
預設值:0
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-OutputFilePath

輸出記錄檔的路徑，或 SQL 資料庫中的 DSN 和記錄集名稱。 預設路徑為 $Env:SystemDrive\PerfLogs\Admin。

參數屬性

類型:String
預設值:$Env:SystemDrive\PerfLogs\Admin
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ProviderFilePath

列出要啟用的多個事件追蹤提供者的檔案。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:2
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SessionName

事件追蹤會話的名稱。 若要停止追蹤會話，您必須知道會話名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

None

您不能將物件透過管道傳送到此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。