Trace-Command

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

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

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

此示例开始跟踪元数据处理、参数绑定和 cmdlet 创建和销毁 Get-Process Notepad 表达式。

Trace-Command -Name Metadata, ParameterBinding, Cmdlet -Expression {Get-Process Notepad} -PSHost

它使用 Name 参数来指定跟踪源、表达式 参数来指定命令，PSHost 参数将输出发送到控制台。 由于它未指定任何跟踪选项或侦听器选项，因此该命令使用默认值：

• 所有跟踪选项
• 侦听器选项无

本示例跟踪 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。

PowerShell 7.3 添加了跟踪本机命令的参数绑定的功能。 以下示例演示 PowerShell 如何分析本机命令 TestExe的命令行参数。

$a = 'a" "b'
Trace-Command -PSHOST -Name ParameterBinding { TestExe -echoargs $a 'c" "d' e" "f }

DEBUG: 2023-02-27 14:20:45.3975 ParameterBinding Information: 0 : BIND NAMED native application line args [C:\Public\Toolbox\TestExe\testexe.exe]
DEBUG: 2023-02-27 14:20:45.3978 ParameterBinding Information: 0 :     BIND cmd line arg [-echoargs] to position [0]
DEBUG: 2023-02-27 14:20:45.3979 ParameterBinding Information: 0 :     BIND cmd line arg [a" "b] to position [1]
DEBUG: 2023-02-27 14:20:45.3980 ParameterBinding Information: 0 :     BIND cmd line arg [c" "d] to position [2]
DEBUG: 2023-02-27 14:20:45.3982 ParameterBinding Information: 0 :     BIND cmd line arg [e f] to position [3]
DEBUG: 2023-02-27 14:20:47.6092 ParameterBinding Information: 0 : CALLING BeginProcessing

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

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

此 cmdlet 不返回自己的输出。 跟踪的命令可能会返回输出。 此 cmdlet 将命令跟踪写入调试流。

跟踪是开发人员用于调试和优化程序的方法。 跟踪时，程序会生成有关其内部处理中每个步骤的详细消息。 PowerShell 跟踪 cmdlet 旨在帮助 PowerShell 开发人员，但可供所有用户使用。 它们允许你监视 shell 功能的几乎所有方面。

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

使用 Get-TraceSource 查看已启用跟踪的 PowerShell 组件列表。

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