Component Uninstall-only Steps

This section lists steps that may only be used within an uninstall block of a component.

uninstall Step

A step used to uninstall a component from a target host. It causes the steps of the named uninstall block of the targeted component to be executed.

The syntax of this step is as specified for the simple plan <uninstall> step, except that the component targeter may be omitted, in which case <thisComponent> is assumed.

When used within a component, this step is often used to call into another existing uninstall block in the same component. In this case, the component is not considered uninstalled until the outermost uninstall block has completed its execution. Furthermore, the component is only considered uninstalled on the host on which the uninstall step was initially targeted, even if calls to other local uninstall blocks were retargeted to other hosts.

This step can also be used within composite components to uninstall referenced components. Note that when a composite component is uninstalled, all of its nested referenced components are that were not explicitly uninstalled are implicitly uninstalled by the system without running an uninstall block. However, toplevel referenced components that were not explicitly uninstalled remain installed.