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 不返回任何输出。