Start-Trace

启动事件跟踪日志记录会话。

语法

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

说明

此 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
Position:Named
默认值:0
必需:False
接受管道输入:False
接受通配符:False

-ETS

直接将命令发送到事件跟踪会话,而无需保存或计划。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Format

指定数据收集器的日志格式。 对于 SQL 数据库格式,必须使用命令行中的 OutputFilePath 选项和 dsn!log 值。 默认值为二进制(bin)。 可能的值包括:

  • bin - binary
  • bincirc - 带循环日志记录的二进制文件
  • csv - 逗号分隔值
  • tsv - 制表符分隔的值
  • sql - SQL 数据库
类型:Object
接受的值:bin, bincirc, csv, tsv, sql
Position:Named
默认值:bin
必需:False
接受管道输入:False
接受通配符:False

-MaxBuffers

设置事件跟踪会话缓冲区的最大数目。

类型:Int32
Position:Named
默认值:256
必需:False
接受管道输入:False
接受通配符:False

-MaxLogFileSizeInMB

设置 SQL 日志的最大日志文件大小(MB)或记录数。

类型:Int32
Position:Named
默认值:0 (no limit)
必需:False
接受管道输入:False
接受通配符:False

-MinBuffers

设置事件跟踪会话缓冲区的最小数目。

类型:Int32
Position:Named
默认值:0
必需:False
接受管道输入:False
接受通配符:False

-OutputFilePath

输出日志文件的路径或 SQL 数据库中的 DSN 和日志集名称。 默认路径为 $env:systemdrive\PerfLogs\Admin

类型:String
Position:1
默认值:$env:systemdrive\PerfLogs\Admin
必需:False
接受管道输入:False
接受通配符:False

-ProviderFilePath

列出要启用的多个事件跟踪提供程序的文件。

类型:String
Position:2
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SessionName

事件跟踪会话的名称。 若要停止跟踪会话,必须知道会话名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。