Skip to content

Uninstall Icinga for Windows Components

If you no longer require certain components on your system, you can uninstall them directly with the build-in command Uninstall-IcingaComponent. It includes the following arguments:

Argument Type Description
Name String The name of the component to uninstall
RemovePackageFiles Switch This argument will ensure that remaining files which are not PowerShell related will be removed as well. This includes for example the ProgramData folder of the Icinga Agent and the service binary for the Icinga for Windows service

Uninstall component

To uninstall a component, you simply specify the name and run the uninstall command:

Uninstall-IcingaComponent -Name 'plugins';

The component will then be removed from the system. For the Icinga Agent for example, you can use the -RemovePackageFiles argument, to also remove the ProgramData folder which includes the certificates as example:

Uninstall-IcingaComponent -Name 'agent' -RemovePackageFiles;

Uninstall Icinga for Windows

To remove Icinga for Windows entirely from your system, you can run the command

Uninstall-IcingaForWindows;

If you are using JEA and used a different user as managed user then icinga, you can specify this user with the -IcingaUser argument:

Uninstall-IcingaForWindows -IcingaUser 'MyCustomUser';

Otherwise it will lookup the default user icinga and remove it, in case it is managed by Icinga for Windows.

To get rid of the confirmation message, simply add the -Force argument:

Uninstall-IcingaForWindows -Force;

Note: This command will uninstall every single Icinga for Windows component, including the service, the Icinga Agent and the Icinga PowerShell Framework itself.