Icinga/icinga-powershell-framework v1.2.0

Icinga for Windows v1.2.0

on GitHub

1.2.0 (2020-08-28)

Issue and PRs

Upgrading Notes

Breaking change with non-equal versions

Check Command configuration generated by Icinga for Windows 1.2.0 require Icinga for Windows 1.2.0 or later deployed on all systems, otherwise you will run into issues with an unknown command Exit-IcingaPluginNotInstalled error.

• To properly catch errors on check execution you will have to import check commands as Director basket again by using Get-IcingaCheckCommandConfig. Further details can be found in the upgrading docs

Notes

• Improved documentation for plenty of Cmdlets and functionality
• We have updated the handling for plugin outputs which will now only print non Ok values by using verbosity 0 on check plugin configuration and include Ok checks for packages with non Ok checks on verbosity 1. Additional details can be found on issue #99
• #80 Adds wrapper function Get-IcingaWindowsInformation for WMI and CIM calls to properly handle config/permission errors
• #93 Adds PSScriptAnalyzer for improved and identical code quality

Enhancements

• Adds configuration for Windows Terminal integration
• Adds new Cmdlet Show-IcingaPerformanceCounterInstances to display all available instances for Performance Counters
• #76 Adds support to test for required .NET Framework Version 4.6.0 or above before trying to install the Icinga Agent
• #87 Adds wrapper command to test new code or functionality of Framework and/or plugins
• #88 Adds Start/Stop timer functionality for performance analysis
• #94 Adds Namespace argument for Get-IcingaWindowsInformation for additional filtering
• #95 Improves error handling for issues by using Use-Icinga initialising or by calling plugins which are not installed
• #98 Adds support for SecureString as password argument on config generation
• #99 Improves plugin output with different verbosity settings
• #100, #107 Adds help for each Performance Counter Cmdlet, separates Cmdlets into single files, adds Filter option for Show-IcingaPerformanceCounterCategories and adds Test-IcingaPerformanceCounterCategory to test if a category exists on a system
• #108 Adds function Show-IcingaPerformanceCounterHelp to fetch the help of a specific Performance Counter
• #111 Improves error message on permission problems while accessing CIM/WMI objects including details on how to resolve them

Bugfixes

• #78 Fix Icinga Agent package fetching for x86 architecture
• #79 Fix ConvertTo-Seconds to output valid numeric data with multiple digits
• #81, #82 Fix error on EventLog initialising in case Icinga for Windows application is not registered on new machines and throws proper error message on plugin execution on how to resolve it
• #83 Fix error on Icinga Config basket renderer for illegal ValidateSet while $null values were allowed values
• #84 Fix conversion of ConvertTo-Seconds and ConvertTo-SecondsFromIcingaThresholds while the input value is $null
• #85 Fix incorrect handling to empty service user password which was configured as empty String instead of $null SecureString object
• #89 Fix file type question during Get-IcingaCheckCommandConfig generation in Windows 2012 R2 and older
• #90 Fix file type question during Icinga Agent installation on Windows 2012 R2 while using a custom installation target
• #91 Fix wrong default values being set for installer arguments by using the Icinga Director Self-Service API
• #92 Fix Set-IcingaAcl which fails on older Windows systems with a security id error and not at all/not properly setting required permissions for directories
• #96 Re-Implements caching for Performance Counters and fixes an issue with counters sometimes returning value 0 instead of the correct value
• #97, #101, #104 Fix value digit count for Performance Counters