Get-NagiosXiHostStatus.ps1

<#
.SYNOPSIS
Get a list of host status from Nagios XI.

.DESCRIPTION
Get a list of host status from Nagios XI using Invoke-NagiosXiApi.


All parameters have default values, but you should change your NagiosXiApiUrl and NagiosXiApiKey to match
your environment. See the documentation for Invoke-NagiosXiApi.

.PARAMETER HostName
Provide the name of a monitored host. You can also provide multiple host names. Additionally
you can use a matching keyword "lk" to search for hosts matching a specific string.

.EXAMPLE
Get-NagiosXiHostStatus

Returns the status for all hosts in Nagios.

.EXAMPLE
Get-NagiosXiHostStatus -HostName SERVER01

Returns the host status for server named server01.

.EXAMPLE
Get-NagiosXiHostStatus -HostName SERVER01,SERVER02

Returns the host status for server named server01 and server02.

.EXAMPLE
Get-NagiosXiHostStatus -Query 'lk:server'

Returns the host status for any Nagios hosts with the string server in the name.
#>
function Get-NagiosXiHostStatus {
    [CmdletBinding()]
    [Alias()]
    Param
    (
        [string]$NagiosXiApiUrl,
        [string]$NagiosXiApiKey,
        [string]$Resource = 'objects/hoststatus',
        [string]$Method = 'Get',
        [string[]]$HostName,
        [switch]$Summary
    )

    Begin {}
    Process {
        
        # Build Hostname list into Query
        if ($HostName) {
            if ($HostName.Count -gt 1) {
                
                $Query = "name=in:"
                foreach ($Host in $HostName) {
                    $Query += "$Host,"
                }
            }
            else {
                $Query = "name=$HostName"
            }
        }
        else {
            $Query = $null
        }   
        Write-Verbose "Query $Query"
        $HostStatus = Invoke-NagiosXIApi -NagiosXiApiUrl $NagiosXiApiUrl -Resource $Resource -Method $Method -Query $Query -NagiosXiApiKey $NagiosXiApiKey
        if ($Summary) {
            $HostStatus.hoststatus | Select-Object -Property name, status_text, last_check
        }
        else {
            $HostStatus.hoststatus
        }
        
    }
    End {}
}