TraceUrl クラス

特定の要求パスに対して失敗した要求トレースを構成します。

構文

class TraceUrl : CollectionElement  

メソッド

このクラスにはメソッドが含まれていません。

プロパティ

次の表は、TraceUrl クラスによって公開されるプロパティの一覧です。

名前	説明
CustomActionExe	エラー状態に達したときに実行する実行可能ファイルを指定する読み取り/書き込み string 値 (たとえば、VBScript ファイルを実行するには、"cscript.exe" を指定します)。 すべてのコマンド ライン変数が展開されます。 たとえば、"%windir%" は Windows ディレクトリのパスに展開されます。 注: 実行可能ファイルは、ワーカー プロセスで CustomActionTriggerLimit プロパティで指定された制限に達していない場合にのみ実行されます。
CustomActionParams	CustomActionExe プロパティで指定された実行可能ファイルに渡すパラメーターを含む読み取り/書き込み string 値。 "%windir%" などのコマンド ライン変数が展開されます。 指定した文字列に "%1" や "%2" などのパラメーター変数を使用することもできます (例: "MyScript.vbs %1 %2")。
CustomActionTriggerLimit	読み取り/書き込み可能な uint32 値。失敗したリクエスト定義のワーカー プロセスの存続期間中に、CustomActionExe プロパティで指定されたプログラムが実行される最大回数を指定します。 この値は、ワーカー プロセスがリサイクルされるたびにリセットされます。 許容される値は 0 から 10000 です。 既定値は 1 です。 この機能は、たとえば、次の障害の後にメモリ ダンプを作成するために使用できますが、後続の障害後には作成できません。 注: ワーカー プロセスの CustomActionTriggerLimit 実行時に指定した値に達した場合、後続の失敗した要求はログに記録されますが、CustomActionExe で指定されたプログラムは実行されません。 failed-requests ログのエントリは、CustomActionTriggerLimit 値に達したことを示します。
FailureDefinitions	要求トレースが生成される条件を指定する読み取り/書き込み FailureDefinition オブジェクト。
Path	トレースする要求のパスを含む必要な一意の読み取り/書き込み string 値 (例: "*.aspx")。 このパスは仮想ディレクトリに対する相対パスであり、サブパスは許可されず、ワイルドカード (*) を 1 つだけ含めることができます。 Path プロパティは、ApplicationHost.config ファイルの <handlers> セクションの path 属性に似ています。 キー プロパティ。
TraceAreas	リクエストがトレースされるエリアを指定する TraceUrlAreaSettings 値。

サブクラス

このクラスにはサブクラスが含まれていません。

解説

このクラスのインスタンスは、TraceFailedRequestsSection クラスの TraceFailedRequests 配列プロパティに含まれています。

継承階層

CollectionElement

TraceUrl

要件

型	説明
クライアント	- Windows Vista 上の IIS 7.0 - Windows 7 上の IIS 7.5 - Windows 8 上の IIS 8.0 - Windows 10 上の IIS 10.0
[サーバー]	- Windows Server 2008 上の IIS 7.0 - Windows Server 2008 R2 上の IIS 7.5 - Windows Server 2012 上の IIS 8.0 - Windows Server 2012 R2 上の IIS 8.5 - Windows Server 2016 上の IIS 10.0
Product	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF ファイル	WebAdministration.mof

参照

CollectionElement クラス
FailureDefinition クラス
HttpTracingSection クラス
TraceAreaDefinition クラス
TraceAreaSettings クラス
TraceFailedRequestsSection クラス
TraceProviderDefinition クラス
TraceProviderDefinitionsSection クラス
TraceUrlAreaSettings クラス
失敗した要求のトレース ルールを作成する