PowerShellコマンドレット虎の巻

Trace-Command

Trace-Commandは、コマンドのトレースを開始するコマンドです。

エイリアスtrcm

解説

指定されたコマンドやスクリプトブロックの実行をトレースし、デバッグ情報を取得します。

構文

(構文)
Trace-Command [-Name] <string[]> [-Expression] <scriptblock> [[-Option] <値>] [<CommonParameters>] Trace-Command [-Name] <string[]> [-Command] <string> [[-Option] <値>] [<CommonParameters>]
【主要パラメータ】
パラメータ説明
-InputObject オブジェクトトレース中に処理される式にオブジェクトを渡す
-Name コンポーネント名トレースするPowerShellコンポーネントの名前を指定する
-Option 値トレースするイベントの種類を指定する
・None
・Constructor
・Dispose
・Finalizer
・Method
・Property
・Delegates
・Events
・Exception
・Lock
・Error
・Errors
・Warning
・Verbose
・WriteLine
・Data
・Scope
・ExecutionFlow
・Assert
・All
-Expression スクリプトブロックトレース中に実行するスクリプトブロックを指定する
-Commandトレース中に実行するコマンドを文字列として指定する
-ArgumentList 配列トレースするコマンドのパラメーターと値を指定する
-ListenerOption出力内の各トレースメッセージのプレフィックスに追加するデータを指定する
-FilePath パストレース出力を保存するファイルのパスを指定する
-Force通常の操作では実行できないコマンドや操作を強制的に実行する
-Debuggerトレース出力をデバッガーに送信することを指定する
-PSHostトレース出力をPowerShellホストに送信することを指定する

共通的なパラメータは「共通パラメータ」をご覧ください。

サンプル

Get-Process Notepadコマンドのメタデータ処理、パラメータバインディング、コマンドレットの作成と破棄をトレースし、結果をコンソールに表示する

Trace-Command -Name metadata,parameterbinding,cmdlet -Expression { Get-Process Notepad } -PSHost

トレース結果をファイルに出力する

Trace-Command -Name ParameterBinding -Expression { Get-Process Notepad } -FilePath "C:\temp\trace_output.txt"

コマンドのヘルプを表示する

Get-Help Trace-Command

備考

  • トレースソースの名前はGet-TraceSourceコマンドレットを使用して確認できます。

関連項目