TraceUrl 类
配置特定请求路径的失败请求跟踪。
语法
class TraceUrl : CollectionElement
方法
此类不包含任何方法。
属性
下表列出了 TraceUrl 类公开的属性。
| 名称 | 描述 |
|---|---|
CustomActionExe |
一个读/写 string 值，指定达到失败条件时要运行的可执行文件（例如，若要运行 VBScript 文件，请指定“cscript.exe”）。 将扩展所有命令行变量。 例如，“%windir%”将扩展为 Windows 目录的路径。 注意：仅当工作进程未达到 CustomActionTriggerLimit 属性中指定的限制时，可执行文件才会运行。 |
CustomActionParams |
一个读/写 string 值，包含要传递给 CustomActionExe 属性中指定的可执行文件的参数。 将扩展“%windir%”之类的命令行变量。 还可以在指定的字符串中使用“%1”和“%2”之类的参数变量（例如“MyScript.vbs %1 %2”）。 |
CustomActionTriggerLimit |
一个读/写 uint32 值，指定由 CustomActionExe 属性指定的程序在失败请求定义的工作进程生存内执行的最大次数。 每次工作进程回收时，该值都会重置。 允许的值为 0 到 10000。 默认值为 1。 例如，此功能可用于在下一次失败后创建内存转储，但不能在发生后续失败后创建内存转储。 注意：如果在工作进程运行时达到指定的 CustomActionTriggerLimit 值，则会记录后续失败的请求，但 CustomActionExe 中指定的程序将不会运行。 失败请求日志中的条目将指示已达到 CustomActionTriggerLimit 值。 |
FailureDefinitions |
一个读/写 FailureDefinition 对象，指定生成请求跟踪的条件。 |
Path |
必需的唯一读/写 string 值，包含要跟踪的请求的路径（例如“*.aspx”）。 此路径相对于虚拟目录，不允许使用子路径，并且只能包含一个通配符 (*)。 Path 属性与 ApplicationHost.config 文件的 <handlers> 部分中的 path 特性类似。 键属性。 |
TraceAreas |
一个 TraceUrlAreaSettings 值，指定要跟踪其请求的区域。 |
子类
此类不包含子类。
注解
此类的实例包含在 TraceFailedRequestsSection 类的 TraceFailedRequests 数组属性中。
继承层次结构
TraceUrl
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上） |
| 服务器 | - IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上） |
| 产品 | - 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 类
为失败的请求创建跟踪规则