Trace-Command

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，只是它仅适用于指定的命令。

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

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

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。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

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

返回调试流中的命令跟踪。

• 跟踪是开发人员用于调试和优化程序的方法。 跟踪时，程序会生成有关其内部处理中每个步骤的详细消息。

• Windows PowerShell 跟踪 cmdlet 旨在帮助 Windows PowerShell 开发人员，但可供所有用户使用。 它们允许你监视 shell 功能的几乎所有方面。

• 若要查找为跟踪启用的 Windows PowerShell 组件，请键入 Get-Help Get-TraceSource。

  跟踪源是管理跟踪和生成组件跟踪消息的每个 Windows PowerShell 组件的一部分。 若要跟踪组件，请标识其跟踪源。

  跟踪侦听器接收跟踪的输出并将其显示给用户。 可以选择将跟踪数据发送到用户模式或内核模式调试器、主机或控制台、文件或派生自 System.Diagnostics.TraceListener 类的自定义侦听器。

• 使用 commandSet 参数集时，Windows PowerShell 会像在管道中处理一样处理命令。 例如，不会为每个传入对象重复命令发现。

• 名称、表达式、Option和 Command 参数的名称是可选的。 如果省略参数名称，则未命名的参数值必须按以下顺序显示：Name、Expression、Option 或 Name、Command、Option。 如果包括参数名称，参数可以按任意顺序显示。