Set-TraceSource
PowerShell コンポーネントのトレースを構成、開始、および停止します。
構文
Set-TraceSource
[-Name] <String[]>
[[-Option] <PSTraceSourceOptions>]
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[-PassThru]
[<CommonParameters>] Set-TraceSource
[-Name] <String[]>
[-RemoveListener <String[]>]
[<CommonParameters>] Set-TraceSource
[-Name] <String[]>
[-RemoveFileListener <String[]>]
[<CommonParameters>] 説明
Set-TraceSource コマンドレットは、PowerShell コンポーネントのトレースを構成、開始、および停止します。 これを使用して、トレースするコンポーネントとトレース出力の送信先を指定できます。
例
例 1: ParameterBinding コンポーネントをトレースする
PS C:\> Set-TraceSource -Name "ParameterBinding" -Option ExecutionFlow -PSHost -ListenerOption "ProcessId,TimeStamp"このコマンドは、PowerShell の ParameterBinding コンポーネントのトレースを開始します。 Name パラメーターを使用してトレース ソースを指定し、Option パラメーターを使用して ExecutionFlow トレース イベントを選択し、PSHost パラメーターを使用して PowerShell ホスト リスナーを選択し、出力をコンソールに送信します。 ListenerOption パラメーターは、ProcessID と TimeStamp の値をトレース メッセージ プレフィックスに追加します。
例 2: トレースを停止する
PS C:\> Set-TraceSource -Name "ParameterBinding" -RemoveListener "Host"このコマンドは、PowerShell の ParameterBinding コンポーネントのトレースを停止します。 Name パラメーターを使用して、トレース対象のコンポーネントを識別し、RemoveListener パラメーターを使用してトレース リスナーを識別します。
パラメーター
-Debugger
コマンドレットがデバッガーにトレース出力を送信することを示します。 出力は、任意のユーザー モードデバッガーまたはカーネル モード デバッガーまたは Microsoft Visual Studio で表示できます。 このパラメーターは、既定のトレース リスナーも選択します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FilePath
このコマンドレットがトレース出力を送信するファイルを指定します。 このパラメーターは、ファイル トレース リスナーも選択します。 このパラメーターを使用してトレースを開始する場合は、RemoveFileListener パラメーターを使用してトレースを停止します。
| 型: | String |
| Aliases: | PSPath |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
コマンドレットが読み取り専用ファイルを上書きすることを示します。 FilePath パラメーターと共に使用します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ListenerOption
出力内の各トレース メッセージのプレフィックスに省略可能なデータを指定します。 このパラメーターに使用できる値は次のとおりです。
- 無し
- 論理演算スタック
- 日付と時間
- タイムスタンプ
- ProcessId
- ThreadId
- コールスタック
デフォルトは None です。
複数のオプションを指定するには、スペースは含めずにコンマで区切り、"ProcessID,ThreadID" のように引用符で囲みます。
| 型: | TraceOptions |
| 指定可能な値: | None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
トレースするコンポーネントを指定します。 各コンポーネントのトレース ソースの名前を入力します。 ワイルドカードを使用できます。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | True |
-Option
トレースされるイベントの種類を指定します。 このパラメーターに使用できる値は次のとおりです。
- 無し
- コンストラクタ
- 廃棄
- ファイナライザー
- メソッド
- プロパティ
- デリゲート
- イベント
- 例外
- ロック
- エラー
- エラー
- Warnung
- 詳細
- ライトライン
- データ
- 範囲
- 実行フロー
- 主張する
- 全て
ALL が既定値です。
次の値は、他の値の組み合わせです。
- ExecutionFlow: (コンストラクタ、Dispose、ファイナライザ、メソッド、デリゲート、イベント、およびスコープ)
- データ: (コンストラクタ、Dispose、ファイナライザ、プロパティ、詳細、および書き込みライン)
- エラー: (エラーと例外)。
複数のオプションを指定するには、オプションをカンマで区切り、スペースは使用せず、引用符で囲みます (例: "Constructor,Dispose")。
| 型: | PSTraceSourceOptions |
| 指定可能な値: | None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All |
| 配置: | 1 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PassThru
作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PSHost
nは、このコマンドレットがトレース出力を PowerShell ホストに送信することを示します。 このパラメーターは、PSHost トレース リスナーも選択します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveFileListener
指定したファイルに関連付けられているファイル トレース リスナーを削除して、トレースを停止します。 トレース出力ファイルのパスとファイル名を入力します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveListener
トレース リスナーを削除してトレースを停止します。
RemoveListener 次の値を使用します。
- PSHost (コンソール) を削除するには、「
Host」と入力します。 - デバッガーを削除するには、「
Debug」と入力します。 - すべてのトレース リスナーを削除するには、「
*」と入力します。
ファイル トレース リスナーを削除するには、RemoveFileListener パラメーターを使用します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
名前を含む文字列を Set-TraceSource にパイプ処理できます。
出力
None or System.Management.Automation.PSTraceSource
PassThru パラメーターを使用すると、Set-TraceSource はトレース セッションを表す System.Management.Automation.PSTraceSource オブジェクトを生成します。 それ以外の場合、このコマンドレットは出力を生成しません。
メモ
トレースは、開発者がプログラムをデバッグおよび調整するために使用するメソッドです。 トレース時に、プログラムは内部処理の各ステップに関する詳細なメッセージを生成します。
PowerShell トレース コマンドレットは、PowerShell 開発者を支援するように設計されていますが、すべてのユーザーが使用できます。 PowerShell の機能のほぼすべての側面を監視できます。
トレース ソースは、トレースを管理し、コンポーネントのトレース メッセージを生成する各 PowerShell コンポーネントの一部です。 コンポーネントをトレースするには、そのトレース ソースを識別します。
トレース リスナーは、トレースの出力を受け取り、ユーザーに表示します。 トレース データは、ユーザー モードデバッガーまたはカーネル モード デバッガー、コンソール、ファイル、または System.Diagnostics.TraceListener クラスから派生したカスタム リスナーに送信できます。
トレースを開始するには、Name パラメーターを使用して、トレース ソースと FilePath、デバッガー、または PSHost パラメーターを してリスナー (出力の宛先) を指定します。 Options パラメーターを使用して、トレースされるイベントの種類と、トレース出力を構成する ListenerOption パラメーターを決定します。
トレースの構成を変更するには、トレースを開始する場合と同様に Set-TraceSource コマンドを入力します。 PowerShell は、トレース ソースが既にトレースされていることを認識します。 トレースを停止し、新しい構成を追加して、トレースを開始または再起動します。
トレースを停止するには、RemoveListener パラメーターを使用します。 ファイル リスナーを使用するトレース (FilePath パラメーターを使用して開始されたトレース) を停止するには、RemoveFileListener パラメーターを使用します。 リスナーを削除すると、トレースは停止します。
トレースできるコンポーネントを特定するには、Get-TraceSource を使用します。 各モジュールのトレース ソースは、コンポーネントの使用中に自動的に読み込まれ、 Get-TraceSource の出力に表示されます。