FailureDefinition 类

指定生成请求跟踪的条件。

语法

class FailureDefinition : EmbeddedObject

此类不包含任何方法。

下表列出了 FailureDefinition 类公开的属性。

名称	描述
`StatusCodes`	一个读/写 `string` 值，包含致使请求被跟踪的 HTTP 状态代码的逗号分隔列表（不带空格）。如果未指定子状态代码，则会跟踪给定状态代码的所有子状态代码。例如，如果指定“404”，则还将返回 404.1、404.2 和 404.5 的跟踪。状态代码必须为 100 到 999，子状态代码必须为 1 到 999。注意：可以指定一系列状态代码（例如“400-599”）。第二个数字必须大于或等于第一个数字。该范围不能包含子状态值。
`TimeTaken`	一个只读 `datetime` 值，指定请求在被标记为失败并被跟踪之前可能花费的处理时间。默认值为 0。一个键属性。
`Verbosity`	一个读/写 `sint32` 枚举值，指定跟踪事件的阈值。后文的“注解”部分列出了可能的值。

此类不包含子类。

此类的实例包含在 TraceUrl 类的 FailureDefinitions 属性中。

如果请求的持续时间超出了 TimeTaken 属性的值或其状态代码位于 StatusCodes 属性包含的列表中，则将跟踪其事件。如果同时指定了 StatusCodes 和 TimeTaken，则计算结果为 true 的第一个条件将导致生成请求跟踪。

下表列出了 Verbosity 属性的可能值。默认值为 0 (Ignore)。

对于要标记为失败的请求，引发的事件的级别必须小于或等于 Verbosity 中的值。

值	关键字	说明
0	`Ignore`	不提供有关请求活动的信息。
1	`CriticalError`	提供有关可能导致进程退出或即将导致进程退出的操作的信息。
2	`Error`	提供有关遇到错误后无法继续处理请求的组件的信息。这些错误通常表明服务器端存在问题。默认值。
3	`Warning`	提供有关遇到错误后仍可继续处理请求的组件的信息。

FailureDefinition

类型	描述
客户端	- 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