Icinga PowerShell Plugins

A collection of Windows check plugins for the Icinga PowerShell Framework

Release Icinga PowerShell Plugins v1.4.0 latest

1.4.0 (2021-03-02)

Issue and PRs

Breaking changes

If you are going to install this plugin release, please have a look on the upgrading docs before!


  • #134 Adds autoloading for plugin information to standardize the development and projects and fixes plenty of spelling/code styling errors
  • #135 Adds new check plugin Invoke-IcingaCheckTCP
  • #137 Adds new configuration for Icinga for Windows v1.4.0 to make future configuration changes unnecessary. Please read the upgrading docs before upgrading!
  • #139 Adds check note for the last boot time for Invoke-IcingaCheckUptime which is being displayed by using -Verbosity 2 on the check configuration
  • #140 Adds new plugin Invoke-IcingaCheckUNCPath to test for network share paths or other volumes to fetch the size and free space from them
  • #141 Update Icinga Director and Icinga 2 conf files with new DSL parser for array elements to properly escape string values with single quotes. Please read the upgrading docs


  • #136 Improves Invoke-IcingaCheckEventLog time filter by allowing simple input like -After 5h and fixes issue on filtering by formatting the time data into required format yyyy/MM/dd HH:mm:ss


Release tarball
application/gzip 2021-03-01 Download from Github

Release Icinga PowerShell Plugins v1.3.1

1.3.1 (2021-02-04)

Issue and PRs


  • #123 Fixes wrong documented user group for accessing Performance Counter objects which should be Performance Monitor Users
  • #124 Fixes crash on Invoke-IcingaCheckService if an automatic service is not running
  • #126 Fixes code base for Invoke-IcingaCheckService by preferring to fetch the startup type of services by using WMI instead of Get-Services, as the result of Get-Services might be empty in some cases
  • #128 Fixes invalid Icinga 2 configuration files due to special characters, invalid attributes and wrong boolean values


Release tarball
application/gzip 2021-02-03 Download from Github

Release Icinga PowerShell Plugins v1.3.0

1.3.0 (2020-12-01)

Issue and PRs

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.

New Plugins

This release adds the following new plugin:

Breaking changes

If you are going to install this plugin release, please have a look on the upgrading docs to not run into issues!


  • #61 Adds exception handling in case permissions to access Windows Updates are missing on the system
  • #73 Improves plugin creation Cmdlet to write a new permission section and to create the plugins doc folder in case it does not exist
  • #74 Adds avg. disk queue length metric for monitoring and performance data to Invoke-IcingaCheckDiskHealth
  • #78 Improves the documentation and output for Invoke-IcingaCheckService by adding metrics for all found services configured to run Automatic and adds service output on Verbosity 1 to show a list of all found services including their current state
  • #85 Adds support on Invoke-IcingaCheckUsedPartitionSpace to ignore a Unknown in case all checks are filtered out. This will then return Ok instead if argument -IgnoreEmptyChecks is set. In addition you can now use -SkipUnknown which will transform an Unknown of partitions without data to Ok. Reworks #84
  • #90 Adds support to ignore read only/offline disks on Invoke-IcingaCheckDiskHealth
  • #101 Improves Invoke-IcingaCheckScheduledTask by changing the State argument from String to Array, allowing the comparison against multiple states. Important: Please have a look on the upgrading docs!
  • #104 Adds plugin configuration files for Icinga Director and Icinga 2 within the config directory
  • #109 Adds exception handling in case -Path argument is not set or not directing a file (including invalid path)


  • #75 Fixes unhandled arguments FileSizeGreaterThan and FileSizeSmallerThan for Invoke-IcingaCheckDirectory
  • #77 Fix wrong filtering for EventIds for Invoke-IcingaCheckEventLog and improve the output by adding the EventLog messages on severity 1. In addition we now allow the filtering for message sources and increase performance by fetching EventLog data for new checks from the last 2 hours only
  • #79 Fixes service check to exclude provided service names in case they contain the wildcard symbol '*' which causes the check to always return unknown
  • #86 Fixes Get-IcingaCPUCount returns wrong count on empty arguments
  • #97, #98 Fixes invalid performance data output for Invoke-IcingaCheckScheduledTask
  • #102, #103 Fixes Invoke-IcingaCheckNetworkInterface plugins arguments being too long for Icinga Director
  • #110 Fixes Invoke-IcingaCheckEventLog plugin throwing an unknown for valid arguments


Release tarball
application/gzip 2020-11-30 Download from Github
Newer Older