failure Element for add for applicationPools [IIS Settings Schema]
Note
For more information about the failure element, see the following topic on the Microsoft IIS.net Web site: Failure Settings for an Application Pool <failure>.
Defines the actions to take when an application pool fails.
Syntax
Attributes and Elements
The following sections describe attributes, child elements, and parent elements for this section.
Attributes
Attribute |
Description |
||||||
|---|---|---|---|---|---|---|---|
autoShutdownExe |
Optional string attribute. Specifies an executable to run when the WWW service shuts down an application pool. You can use the autoShutdownParams attribute to send parameters to the executable. |
||||||
autoShutdownParams |
Optional string attribute. Specifies command-line parameters for the executable that is specified in the autoShutdownExe attribute. |
||||||
loadBalancerCapabilities |
Optional enum attribute. Specifies behavior when a worker process cannot be started, such as when the request queue is full or an application pool is in rapid-fail protection. The loadBalancerCapabilities attribute can be one of the following possible values. The default value is HttpLevel.
|
||||||
orphanActionExe |
Optional string attribute. Specifies an executable to run when the WWW service orphans a worker process (if the orphanWorkerProcess attribute is set to true). You can use the orphanActionParams attribute to send parameters to the executable. |
||||||
orphanActionParams |
Optional string attribute. Indicates command-line parameters for the executable named by the orphanActionExe attribute. To specify the process ID of the orphaned process, use %1%. |
||||||
orphanWorkerProcess |
Optional Boolean attribute. Specifies whether to assign a worker process to an orphan state instead of terminating it when an application pool fails. The default value is false. |
||||||
rapidFailProtection |
Optional Boolean attribute. Setting to true instructs the WWW service to remove from service all applications that are in an application pool when:
The default value is true. |
||||||
rapidFailProtectionInterval |
Optional timeSpan attribute. Specifies the number of minutes before the failure count for a process is reset. The default value is 00:05:00 (five minutes). |
||||||
rapidFailProtectionMaxCrashes |
Optional uint attribute. Specifies the maximum number of failures allowed within the number of minutes specified by the rapidFailProtectionInterval attribute. The default value is 5. |
Child Elements
None.
Parent Elements
Element |
Description |
|---|---|
configuration |
Specifies the root element in every configuration file that is used by IIS 7. |
system.applicationHost |
Specifies the root element for configuring Web process settings. |
applicationPools |
Contains default configuration settings for all application pools on the server and defines configuration settings for specific application pools. |
add |
Configures an application pool in the server configuration. |
Remarks
For more information about the failure element, see the following topic on the Microsoft IIS.net Web site: Failure Settings for an Application Pool <failure>.
This element can be declared in ApplicationHost.config only. Any attempt to declare it in a configuration file at a different level in the hierarchy causes an error and a resultant error message.
Default Configuration
None.
Element Information
Configuration locations |
ApplicationHost.config |
Requirements |
Microsoft Internet Information Services (IIS) version 7.0 |