Trace-Command

Trace-Command [-Command] <string> [-ArgumentList <Object[]>] [-Name] <string[]> [[-Option] {<None> | <Constructor> | <Dispose> | <Finalizer> | <Method> | <Property> | <Delegates> | <Events> | <Exception> | <Lock> | <Error> | <Errors> | <Warning> | <Verbose> | <WriteLine> | <Data> | <Scope> | <ExecutionFlow> | <Assert> | <All>}] [-Debugger] [-FilePath <string>] [-Force] [-InputObject <psobject>] [-ListenerOption {<None> | <LogicalOperationStack> | <DateTime> | <Timestamp> | <ProcessId> | <ThreadId> | <Callstack>}] [-PSHost] [<CommonParameters>]

Trace-Command [-Expression] <scriptblock> [-Name] <string[]> [[-Option] {<None> | <Constructor> | <Dispose> | <Finalizer> | <Method> | <Property> | <Delegates> | <Events> | <Exception> | <Lock> | <Error> | <Errors> | <Warning> | <Verbose> | <WriteLine> | <Data> | <Scope> | <ExecutionFlow> | <Assert> | <All>}] [-Debugger] [-FilePath <string>] [-Force] [-InputObject <psobject>] [-ListenerOption {<None> | <LogicalOperationStack> | <DateTime> | <Timestamp> | <ProcessId> | <ThreadId> | <Callstack>}] [-PSHost] [<CommonParameters>]

C:\PS>trace-command -name metadata,parameterbinding,cmdlet -expression {get-process notepad} -pshost

説明
-----------
このコマンドは "get-process notepad" という式に対するメタデータ処理、パラメーター バインド、コマンドレットの作成および破壊のトレースを開始します。Name パラメーターを使用してトレース ソースを指定し、Expression パラメーターを使用してコマンドを指定し、PSHost パラメーターを使用して出力をコンソールに送ります。トレース オプションもリスナー オプションも指定されていないため、トレース オプションには "All"、リスナー オプションには "None" という、それぞれの既定値が使用されます。

C:\PS>trace-command -name commandprocessor,pipelineprocessor -command get-alias -argumentlist "ghy" -option executionflow -listenerOption "timestamp,callstack" -filepath c:\test\debug.txt

説明
-----------
このコマンドは、"get-alias cd" コマンドの処理中にコマンド プロセッサとパイプライン プロセッサのトレースを開始します。

このコマンドは、Name パラメーターにトレース ソースを指定し、Command パラメーターにコマンドを指定し、ArgumentList パラメーターに Get-Alias コマンドのパラメーターを指定し、Option パラメーターにトレース オプションを指定し、ListenerOption パラメーターにはトレース メッセージ プレフィックスのフィールドを指定しています。FilePath パラメーターを使用して、C:\Test\Debug.txt ファイルに出力を送っています。

C:\PS>$a = "i*"

C:\PS> trace-command parameterbinding {get-alias $input} -pshost -inputobject $a

説明
-----------
これらのコマンドは、パイプラインから入力を受け取る Get-Alias の式を処理する間に、Windows PowerShell の ParameterBinding 操作のアクションをトレースします。

Trace-Command 内の InputObject パラメーターによって、トレース中に処理される式にオブジェクトが渡されます。

最初のコマンドは、"i*" という文字列を $a 変数に保存します。2 番目のコマンドは、ParameterBinding トレース ソースと Trace-Command コマンドレットを使用しています。PSHost パラメーターを使用して、コンソールに出力を送っています。

処理される式は "get-alias $input" です。ここで、$input 変数は InputObject パラメーターと関連付けられています。InputObject パラメーターを使用して、変数 $a を式に渡しています。実質的に、トレース中に処理されるコマンドは、"get-alias -inputobject $a" または "$a | get-alias" となります。