MrANagios

1.1

Invoke-NagiosRequest.ps1

<#
.Synopsis
   This script allows the user execute cgi commands to a Nagios site by using
   the Invoke-WebRequest cmdlet.
.DESCRIPTION
   The purpose of the script is to automate the process of disabling/enabling
   nagios notifications and/or checks for Nagios hosts and their services.
    
   The script utilizes Invoke-WebRequest to post to the nagios cmd.cgi.
 
   Paramaters:
        $computername - what nagios refers to as host for which you wish to
        enable/disable checks and notifications. Hosts are case-sensitive.
 
        $action - integer of nagios cmd.cgi for the action you wish to take
 
            Disable checks of all services on this host
            $action=16
 
            Enable checks of all services on this host
            $action=15
 
            Disable notifications for all services on this host
            $action=29
 
            Enable notifications for all services on this host
            $action=28
 
            Acknowledge service problem
            $action=34
 
            Force service check
            $action=7
 
        $NagiosCoreUrl - the base url of your nagios installation (i.e. http://nagios.domain.com/nagios)
 
        $username - the htaccess username
 
        $password - the htaccess password
 
.NOTES
    Author: Jason Wasser
    Modified: 5/19/2015
    Version: 1.8
    Currently the script only supports enabling/disabling of active checks and
    notifications.
     
    Changelog:
    version 1.8
        * Added Disable-NagiosServiceNotifications and Enable-NagiosServiceNotifications
        * Added Disable-NagiosGlobalNotifications and Enable-NagiosGlobalNotifications
    version 1.7
        * Added logic for hostgroups and service groups
    version 1.6
        * Converted to Functions and script module
    version 1.52
        * Added host problem acknowledgement.
    version 1.51
        * Added logic for user not entering a password.
    version 1.5
        * Added service problem acknowledgement.
        * Added force service check.
        * Added disabling/enabling service checks for host groups
        * Added disabling/enabling service checks for service groups.
    version 1.0
        * Initial re-write of Set-NagiosCLI.ps1 now using Invoke-WebRequest.
 
      
    Future developments could include scheduled downtimes.
     
    Known Issues:
        * To run the script as a scheduled task as a service account will require running
        Internet Explorer once as the user.
     
.EXAMPLE
   .\Invoke-NagiosRequest.ps1 -computername server1 -action 29 -NagiosCoreUrl http://nagios.domain.com/nagios -username nagiosadmin
   This will disable notifications for all services on host server1 including the host.
.EXAMPLE
   .\Invoke-NagiosRequest.ps1 -computername server1 -action 28 -NagiosCoreUrl http://nagios.domain.com/nagios -username nagiosadmin
   This will enable notifications for all services on host server1 including the host.
.EXAMPLE
   .\Invoke-NagiosRequest.ps1 -computername server1 -action 16 -NagiosCoreUrl http://nagios.domain.com/nagios -username nagiosadmin
   This will disable checks for all services on host server1 including the host.
.EXAMPLE
   .\Invoke-NagiosRequest.ps1 -computername server1 -action 15 -NagiosCoreUrl http://nagios.domain.com/nagios -username nagiosadmin
   This will enable checks for all services on host server1 including the host.
.EXAMPLE
   .\Invoke-NagiosRequest.ps1 -computername (get-content c:\temp\computerlist.txt) -action 29 -NagiosCoreUrl http://nagios.domain.com/nagios -username nagiosadmin
   This will disable notifications for a list of computers found in the c:\temp\computerlist.txt file.
 
#>
#requires -version 3.0
Function Invoke-NagiosRequest {
    [CmdletBinding(DefaultParameterSetName='ByHost')]
    Param
    (
        # Nagios Host
        [Parameter(Mandatory=$false,
                    ValueFromPipeline=$true,
                    ValueFromPipelineByPropertyName=$true,
                    Position=0,
                    HelpMessage = "What nagios refers to host(s) for which you wish to enable/disable checks and notifications.
                    Nagios is case-sensitive for hosts (i.e. server01 != SERVER01).",
                    ParameterSetName='ByHost')]
        [alias('host')]
        [string[]]$ComputerName,

        # Nagios cmd.cgi action by number
        [Parameter(Mandatory=$true,Position=1,
            HelpMessage = "Integer of nagios cmd.cgi for the action you wish to take
 
                Disable checks of all services on this host
                action=16
 
                Enable checks of all services on this host
                action=15
 
                Disable notifications for a service on this host
                action=23
 
                Enable notifications for a service on this host
                action=22
 
                Disable notifications for all services on this host
                action=29
 
                Enable notifications for all services on this host
                action=28
             
                Acknowledge host alert
                action=33
             
                Acknowledge service alert
                action=34
             
                Force service check
                action=7
 
                Disable checks of all services on host group
                action=68
 
                Enable checks of all services on host group
                action=67
 
                Disable checks of all services in a service group
                action=114
 
                Enable checks of all services in a service group
                action=113
                ")]
        [ValidateSet(7,11,12,15,16,22,23,28,29,33,34,67,68,113,114)]
        [int]$action,

        [Parameter(Mandatory=$false)]
        [string]$service,

        [Parameter(Mandatory=$false)]
        [string]$servicegroup,

        [Parameter(Mandatory=$false)]
        [string]$comment,

        [Parameter(Mandatory=$false)]
        [string]$hostgroup,

        # Nagios base url
        [Parameter(Mandatory=$false,Position=2,HelpMessage="The base url of your nagios installation (i.e. http://nagios.domain.com/nagios)")]
        [string]$NagiosCoreUrl,

        # Nagios username
        [Parameter(Mandatory=$false,Position=3)]
        [string]$username,

        # Nagios password
        [Parameter(Mandatory=$false,Position=4)]
        [string]$password

    )

    Begin
    {
        # Function for making the actual CGI POST command.
        Function Submit-NagiosRequest {
            Param (
                [string]$NagiosObject
                )
            Write-Output "###########################################################################"
            Write-Output "Submitting cgi command to Nagios for $NagiosObject"
            $WebRequest = Invoke-WebRequest -Uri $uri -Credential $Credential -Body $formFields -Method POST -ContentType 'application/x-www-form-urlencoded'
        
            # If there was a problem with the hostname or other problem the errorMessage DIV field will be displayed. If not display the infoMessage of success.
            $Message = $WebRequest.ParsedHtml.getElementsByTagName("div") | Where-Object "classname" -Match "errorMessage|infoMessage" | select -ExpandProperty innerText
            if ($Message) {
                $Message 
                }     
            Write-Output "###########################################################################"
            }
        
        # Building URI for Nagios CGI
        $cgiurl="/cgi-bin/cmd.cgi"
        $uri = $NagiosCoreUrl + $cgiurl
        
        # Credential verification
        if (!$Credential) {
            $Credential = Get-UserLogin -username $username -Password $password
            }
    }

    Process
    {
        # Here we need to separate out the Nagios commands that potential
        # loop through a list of nagios hosts for the enabling/disabling
        # of checks and notifications from the other commands such as host
        # groups, service groups, acknowledgements, and future development.

        switch -Regex ($action) {
             # List of action integers that are not computer/host based
            "67|68" {
                foreach ($hg in $hostgroup) {
                    switch ($action) {
                        # Enable checks of all services on host group
                        67 {
                            if (!$hg) {
                                $hg = Read-Host "Please enter the hostgroup (case-sensitive)"
                                }
                            $formFields = @{cmd_typ=$action;hostgroup=$hg;ahas=$true;cmd_mod=2}
                            }
                        # Disable checks of all services on host group
                        68 {
                            if (!$hg) {
                                $hg = Read-Host "Please enter the hostgroup (case-sensitive)"
                                }
                            $formFields = @{cmd_typ=$action;hostgroup=$hg;ahas=$true;cmd_mod=2}
                            }
                        }
                        Submit-NagiosRequest -NagiosObject $hg
                    }
                }
            "^113$|^114$" {
                foreach ($sg in $servicegroup) {
                    switch ($action) {
                        # Enable checks of all services in a service group
                        113 {
                            if (!$sg) {
                                $sg = Read-Host "Please enter the service group (case-sensitive)"
                                }
                            $formFields = @{cmd_typ=$action;servicegroup=$sg;ahas=$false;cmd_mod=2}
                            }
                        # Disable checks of all services in a service group
                        114 {
                            if (!$sg) {
                                $sg = Read-Host "Please enter the service group (case-sensitive)"
                                }
                            $formFields = @{cmd_typ=$action;servicegroup=$sg;ahas=$false;cmd_mod=2}
                            }
                        }
                        Submit-NagiosRequest -NagiosObject $sg
                    }
                }
            "^11$|^12$" {
                    Write-Verbose "Enabling/Disabling Global Nagios Notifications"
                    $formFields = @{cmd_typ=$action;cmd_mod=2}
                    Submit-NagiosRequest -NagiosObject 'GlobalNotifications'
                }
            default {
                # For all other host/computer commands.
                if (!$ComputerName) {
                    $ComputerName = Read-Host "Please enter a Nagios host name (case-sensitive)"
                    }
                foreach ($computer in $ComputerName) {
                    $computer = $computer.ToUpper()
                    switch -Regex ($action) {
                        # Acknowledge Host Problesm
                        33 {
                            if (!$comment){
                                $comment = Read-Host "Please enter a comment for acknowledgement"
                                }
                            $formFields = @{cmd_typ=$action;host=$computer;service=$service;cmd_mod=2;com_data=$comment;sticky_ack=$true;send_notification=$true}
                            }
                        # Acknowledge Service Problem
                        34 {
                            if (!$service) {
                                $service = Read-Host "Please enter the service name (case-sensitive)"
                                }
                            if (!$comment){
                                $comment = Read-Host "Please enter a comment for acknowledgement"
                                }
                            $formFields = @{cmd_typ=$action;host=$computer;service=$service;cmd_mod=2;com_data=$comment;sticky_ack=$true;send_notification=$true}
                            }
                        # Force service check
                        7 {
                            if (!$service) {
                                $service = Read-Host "Please enter the service name (case-sensitive)"
                                }
                            $formFields = @{cmd_typ=$action;host=$computer;service=$service;cmd_mod=2;start_time=(Get-Date -Format "MM-dd-yyyy HH:mm:ss");force_check=$true}
                            }
                        "22|23" {
                            if (!$service) {
                                $service = Read-Host "Please enter the service name (case-sensitive)"
                                }
                            $formFields = @{cmd_typ=$action;host=$computer;service=$service;cmd_mod=2}
                            }
                
                        # All other commands for enabling/disabling checks or notifications for hosts
                        default {
                            $formFields = @{cmd_typ=$action;host=$computer;ahas=$true;cmd_mod=2}
                            }
                        }
                    Submit-NagiosRequest -NagiosObject $computer
                    }
                }
            }
        }
    End
    {
    }
}
# End of Invoke-NagiosRequest Function
########################################################################################################