Trace-Command

参考

模块:: Microsoft.PowerShell.Utility

配置并启动指定表达式或命令的跟踪。

语法

Trace-Command
     [-Name] <String[]>
     [-Expression] <ScriptBlock>
     [[-Option] <PSTraceSourceOptions>]
     [-InputObject <PSObject>]
     [-ListenerOption <TraceOptions>]
     [-FilePath <String>]
     [-Force]
     [-Debugger]
     [-PSHost]
     [<CommonParameters>]

Trace-Command
     [-Name] <String[]>
     [-Command] <String>
     [[-Option] <PSTraceSourceOptions>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [-ListenerOption <TraceOptions>]
     [-FilePath <String>]
     [-Force]
     [-Debugger]
     [-PSHost]
     [<CommonParameters>]

说明

Trace-Command cmdlet 配置并启动指定表达式或命令的跟踪。它的工作方式类似于 Set-TraceSource，只是它仅适用于指定的命令。

示例

示例 1：跟踪元数据处理、参数绑定和表达式

PS C:\> Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-Process Notepad} -PSHost

此命令开始跟踪元数据处理、参数绑定和 cmdlet 创建和销毁 Get-Process Notepad 表达式。它使用 Name 参数来指定跟踪源、表达式 参数来指定命令，PSHost 参数将输出发送到控制台。由于它未指定任何跟踪选项或侦听器选项，因此该命令使用默认值--“全部”用于跟踪选项，而“无”用于侦听器选项。

示例 2：跟踪 ParameterBinding 操作的操作

PS C:\> $A = "i*"
PS C:\> Trace-Command ParameterBinding {Get-Alias $Input} -PSHost -InputObject $A

这些命令跟踪 Windows PowerShell 的 ParameterBinding 操作的操作，同时处理从管道获取输入的 Get-Alias 表达式。

在 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。此功能特别适用于调试动态参数。

类型:	Object[]
别名:	Args
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Command

指定在跟踪期间正在处理的命令。

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

-Debugger

指示 cmdlet 将跟踪输出发送到调试器。可以在任何用户模式或内核模式调试器或 Visual Studio 中查看输出。此参数还会选择默认跟踪侦听器。

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

-Expression

指定在跟踪期间正在处理的表达式。将表达式括在大括号（{}）。

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

-FilePath

指定 cmdlet 将跟踪输出发送到的文件。此参数还会选择文件跟踪侦听器。

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

-Force

强制命令运行而不要求用户确认。与 FilePath 参数一起使用。即使使用 Force 参数，cmdlet 也无法替代安全限制。

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

-InputObject

指定在跟踪期间正在处理的表达式的输入。

可以输入一个代表表达式接受的输入的变量，也可以通过管道传递对象。

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

-ListenerOption

指定输出中每个跟踪消息的前缀的可选数据。此参数的可接受值为：

没有
LogicalOperationStack
DateTime
时间戳
ProcessId
ThreadId
Callstack

无为默认值。

若要指定多个选项，请使用逗号分隔它们，但没有空格，并将它们括在引号中，例如“ProcessID，ThreadID”。

类型:	TraceOptions
接受的值:	None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定跟踪的 Windows PowerShell 组件的数组。输入每个组件的跟踪源的名称。允许通配符。若要在计算机上查找跟踪源，请键入 Get-TraceSource。

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

-Option

指定跟踪的事件的类型。此参数的可接受值为：

没有
构造函数
处理
终结器
方法
财产
代表
事件
例外
锁
错误
错误
警告
详细
WriteLine
数据
范围
ExecutionFlow
断言
都

全部为默认值。

以下值是其他值的组合：

ExecutionFlow：（构造函数、释放、终结器、方法、委托、事件和范围）
数据：（构造函数、释放、终结器、属性、详细和 WriteLine）
错误：（错误和异常）。

若要指定多个选项，请用逗号分隔它们，但没有空格，并用引号括起来，如“构造函数，释放”。

类型:	PSTraceSourceOptions
接受的值:	None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PSHost

指示 cmdlet 将跟踪输出发送到 Windows PowerShell 主机。此参数还会选择 PSHost 跟踪侦听器。

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

输入

PSObject

可以通过管道将表示表达式的输入的对象传递给 Trace-Command。

输出