Skip to content

Upgrading Icinga PowerShell Plugins

Upgrading Icinga PowerShell Plugins is usually quite straightforward.

Specific version upgrades are described below. Please note that version updates are incremental.

For upgrading plugins, please have a look on the installation docs.

Upgrading to v1.4.0 (2021-03-02)

Plugin Configuration (Breaking Changes)

The new package of the Icinga PowerShell Plugins is shipping with pre-compiled configuration for the Icinga Director and Icinga 2, which only work with Icinga PowerShell Framework v1.4.0 or later. Please update your entire infrastructure to Icinga for Windows v1.4.0 before using the pre-compiled configuration or configuration files created by the new Icinga for Windows v1.4.0 config generator.


We made some slight adjustments to Invoke-IcingaCheckEventLog for the -After and -Before argument, which will now not only allow a fixed time stamp, like 2021/01/30, but also threshold inputs like 5h (to go back 5 hours), 1d (to go back 1 day), and so on. There should be no impact on current implementations but you might wanna have a look on your checks and results after uprading.

Upgrading to v1.3.0 (2020-12-01)

Plugin Argument Changes (Breaking Changes)

The following plugins received modifications to their existing arguments. Please keep in mind that updating to this version of the Icinga PowerShell Plugins, you must update your configuration to ensure everything is running properly and update all plugins on all systems. As for the Icinga Director, you have to import the new basket for these plugins to apply the configuration. How ever, current values assigned to these arguments will no longer apply and have to be reconfigured!


The State argument for Invoke-IcingaCheckScheduledTask has been changed from String to Array, which will now support providing multiple states a task can be into. In addition we modified the Icinga PowerShell Framework to properly support ValidateSet for array arguments, fixed in #152. Please ensure to upgrade to v1.3.0 before generating the new configuration and importing it, as the fix ensures that array arguments still can only contain fixed values.


The arguments used before were too long for importing into the Icinga Director. For that reason many arguments have been shorted with their name. Please ensure to import the latest version of the configuration file for this plugin and update your Icinga and check configuration to use the new arguments instead. Only applies if you used this plugin from previous snapshots.

Upgrading to v1.2.0 (2020-08-28)

No special steps required

Upgrading to v1.1.0 (2020-06-02)

Icinga PowerShell Framework dependency

To use the Icinga PowerShell Plugins v1.1.0 you will require to upgrade the Icinga PowerShell Framework to v1.1.0 first. This new plugin release will not work with older Framework versions.

New Plugins

We have added two new plugins you can add into your Icinga 2 configuration by creating a basket configuration for the Icinga Director. The new plugins are