Trace-Command
配置并启动对指定表达式或命令的跟踪。
语法
Trace-Command
[-InputObject <PSObject>]
[-Name] <String[]>
[[-Option] <PSTraceSourceOptions>]
[-Expression] <ScriptBlock>
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[<CommonParameters>]
Trace-Command
[-InputObject <PSObject>]
[-Name] <String[]>
[[-Option] <PSTraceSourceOptions>]
[-Command] <String>
[-ArgumentList <Object[]>]
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[<CommonParameters>]
说明
cmdlet Trace-Command
配置并启动指定表达式或命令的跟踪。
其工作方式与 Set-TraceSource 相似,但仅适用于指定的命令。
示例
示例 1:跟踪元数据处理、参数绑定和表达式
此示例开始跟踪元数据处理、参数绑定以及创建和销毁表达式的 Get-Process Notepad
cmdlet。
Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-Process Notepad} -PSHost
它使用 Name 参数指定跟踪源, 使用 Expression 参数指定命令,并使用 PSHost 参数将输出发送到控制台。 由于它未指定任何跟踪选项或侦听器选项,因此该命令使用默认值:
- 全部用于跟踪选项
- 对于侦听器选项,无
示例 2:跟踪 ParameterBinding 操作
此示例跟踪 PowerShell 的 ParameterBinding 操作的操作,同时处理 Get-Alias
从管道获取输入的表达式。
$A = "i*"
Trace-Command ParameterBinding {Get-Alias $Input} -PSHost -InputObject $A
在 Trace-Command
中, InputObject 参数将对象传递给跟踪期间正在处理的表达式。
第一个命令将字符串 i*
存储在 变量中 $A
。 第二个命令将 Trace-Command
cmdlet 与 ParameterBinding 跟踪源一起使用。 PSHost 参数将输出发送到控制台。
正在处理的表达式是 Get-Alias $Input
,其中变量 $Input
与 InputObject 参数相关联。 InputObject 参数将变量$A
传递给表达式。 实际上,在跟踪期间处理的命令是 Get-Alias -InputObject $A" or "$A | Get-Alias
。
参数
-ArgumentList
为要跟踪的命令指定参数和参数值。 ArgumentList 的别名是 Args。 对于调试动态参数,此功能尤其有用。
有关 ArgumentList 行为的详细信息,请参阅 about_Splatting。
Type: | Object[] |
Aliases: | Args |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Command
指定要在跟踪期间处理的命令。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Debugger
指示 cmdlet 将跟踪输出发送到调试程序。 可以在任何用户模式或内核模式调试程序或者 Visual Studio 中查看输出。 此参数还将选择默认的跟踪侦听器。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Expression
指定要在跟踪期间处理的表达式。 将表达式括在大括号 ({}
) 。
Type: | ScriptBlock |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilePath
指定 cmdlet 将跟踪输出发送到的文件。 此参数还将选择文件跟踪侦听器。
Type: | String |
Aliases: | PSPath, Path |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
强制运行命令而不要求用户确认。 与 FilePath 参数一起使用。 即使使用 Force 参数,cmdlet 也无法替代安全限制。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
为要在跟踪期间处理的表达式指定输入。 可以输入表示表达式接受的输入的变量,或通过管道传递对象。
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ListenerOption
向输出中的每条跟踪消息的前缀指定可选数据。 此参数的可接受值为:
None
LogicalOperationStack
DateTime
Timestamp
ProcessId
ThreadId
Callstack
None
是默认值。
这些值定义为基于标志的枚举。 可以使用此参数将多个值组合在一起以设置多个标志。 这些值可以作为值的数组或这些值的逗号分隔字符串传递给 ListenerOption 参数。 该 cmdlet 将使用二进制 OR 操作合并值。 将值作为数组传递是最简单的选项,还允许对值使用 Tab 自动补全。
Type: | TraceOptions |
Accepted values: | None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定跟踪的 PowerShell 组件的数组。 请输入各个组件的跟踪源的名称。 允许使用通配符。 若要在计算机上查找跟踪源,请键入 Get-TraceSource
。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Option
确定要跟踪的事件的类型。 此参数的可接受值为:
None
Constructor
Dispose
Finalizer
Method
Property
Delegates
Events
Exception
Lock
Error
Errors
Warning
Verbose
WriteLine
Data
Scope
ExecutionFlow
Assert
All
All
是默认值。
以下值是其他值的组合:
ExecutionFlow
:Constructor
,Dispose
,Finalizer
,Method
,Delegates
,Events
,Scope
Data
:Constructor
,Dispose
,Finalizer
,Property
,Verbose
,WriteLine
Errors
:Error
,Exception
这些值定义为基于标志的枚举。 可以使用此参数将多个值组合在一起以设置多个标志。 这些值可以作为值的数组或这些值的逗号分隔字符串传递给 Option 参数。 该 cmdlet 将使用二进制 OR 操作合并值。 将值作为数组传递是最简单的选项,还允许对值使用 Tab 自动补全。
Type: | PSTraceSourceOptions |
Accepted values: | None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PSHost
指示 cmdlet 将跟踪输出发送到 PowerShell 主机。 此参数还将选择 PSHost 跟踪侦听器。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将表示表达式输入的对象传递给 Trace-Command
。
输出
在调试流中返回命令跟踪。
备注
跟踪是开发人员用于调试和优化程序的一种方法。 在跟踪过程中,程序将生成有关其内部处理过程中每个步骤的详细消息。
PowerShell 跟踪 cmdlet 旨在帮助 PowerShell 开发人员,但它们可供所有用户使用。 使用这些 cmdlet,你可以监视 shell 功能的几乎每个方面。
若要查找为跟踪启用的 PowerShell 组件,请键入
Get-Help Get-TraceSource
。跟踪源是管理跟踪并为组件生成跟踪消息的每个 PowerShell 组件的一部分。 若要跟踪某个组件,你应标识其跟踪源。
跟踪侦听器接收跟踪的输出并将其显示给用户。 可以选择将跟踪数据发送到用户模式或内核模式调试器、主机或控制台、文件或派生自 System.Diagnostics.TraceListener 类的自定义侦听器。
使用 commandSet 参数集时,PowerShell 会像在管道中处理命令一样处理命令。 例如,不对每个传入对象重复执行命令发现。
Name、Expression、Option 和 Command 参数的名称是可选的。 如果省略参数名称,则未命名参数值必须按以下顺序出现:Name、Expression、Option 或 Name、Command、Option。 如果包括参数名称,则参数能够以任何顺序出现。