Skip to main content
Version: v3

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
NameTypeDescriptionRequired
CommandString 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.  
IdString Unique identifier for this service configuration. This value will default to the ServiceName attribute if not specified.  
OnInstallYesNoType Specifies whether to configure the service when the parent Component is installed. This attribute may be combined with OnReinstall and OnUninstall.  
OnReinstallYesNoType Specifies whether to configure the service when the parent Component is reinstalled. This attribute may be combined with OnInstall and OnUninstall.  
OnUninstallYesNoType Specifies whether to configure the service when the parent Component is uninstalled. This attribute may be combined with OnInstall and OnReinstall.  
RebootMessageString 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.  
ResetPeriodString Specifies the time in seconds to reset the failure count. If this attribute is not present the failure count will not be reset.  
ServiceNameString 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