ServiceConfigFailureActions Element

WiX Toolset

ServiceConfigFailureActions Element

Description
Configures the failure actions for a service being installed or one that already exists. This element's functionality is available starting with MSI 5.0.
Windows Installer references
MsiServiceConfigFailureActions Table
Parents
Component, ServiceInstall
Inner Text
None
Children
Choice of elements (min: 0, max: unbounded)
  • Failure (min: 0, max: unbounded): Ordered list of failure actions to apply to service.
Attributes
Name Type Description Required
Command String This attribute specifies command to execute when a "runCommand" failure action hit. If an empty string is provided it clears the existing command. If this attribute is not present the setting is not changed.  
Id String Unique identifier for this service configuration. This value will default to the ServiceName attribute if not specified.  
OnInstall YesNoType Specifies whether to configure the service when the parent Component is installed. This attribute may be combined with OnReinstall and OnUninstall.  
OnReinstall YesNoType Specifies whether to configure the service when the parent Component is reinstalled. This attribute may be combined with OnInstall and OnUninstall.  
OnUninstall YesNoType Specifies whether to configure the service when the parent Component is uninstalled. This attribute may be combined with OnInstall and OnReinstall.  
RebootMessage String Specifies the message to show for a reboot failure action. If an empty string is provided it clears any existing reboot message. If this attribute is not present the setting is not changed.  
ResetPeriod String Specifies the time in seconds to reset the failure count. If this attribute is not present the failure count will not be reset.  
ServiceName String Specifies the name of the service to configure. This value will default to the ServiceInstall/@Name attribute when nested under a ServiceInstall element.  
See Also
Wix Schema