This article applies to PRTG Network Monitor 16 or later.

Disclaimer: This script is a proof-of-concept and comes as-is. It comes without support. Using it happens at your own risk.

Introduction

This script will give you a list of configured maintenance windows within PRTG, including the object ID, name, type, start/end of the maintenance and its duration. Here's what it looks like:

All configured maintenance windows in PRTG

Installation

Remarks

The script needs to be run on the PRTG server itself as it reads the configuration file.

Setup

1. Create a new PowerShell script on the desktop of the PRTG server
2. Paste the script, save it and start it

Script

## PRTG configuration 
[string] $ConfigurationFilePath = ((Get-ItemProperty -Path "hklm:SOFTWARE\Wow6432Node\Paessler\PRTG Network Monitor\Server\Core" -Name "Datapath").DataPath) + "PRTG Configuration.dat"
   [xml] $configuration = New-Object -TypeName XML;
         $configuration.Load($ConfigurationFilePath)

## PRTGs internal start date
$Start = Get-Date -Date "1899-12-30 23:00:00Z"

## nodes 
$prtgGroups  = $configuration.SelectNodes("//group")
$prtgDevices = $configuration.SelectNodes("//device")
$prtgSensors = $configuration.SelectNodes("//sensor")
#endregion

#region function
<# Function Section
#################################
All functions of the script are defined here. 
############################### #>

<# Function Name: This-GetXMLValue
#################################
Used For: Retrieving XML values. Returns inherited if the trim fails (i.e. if there's nothing to trim
#################################
Parameters: 
# [xml]    object - the object that should have it's node extracted
# [string] node   - the node you want retrieved
################################# #>
function This-GetXMLValue($object,[string]$node){

    try   { $value = $object.data.$node.trim(); }
    catch { $value = "Inherited" }

    return $value;

}
#endregion

$MaintenanceList = @(); 

foreach($prtgGroup in $prtgGroups){

    if((($prtgGroup.data.maintenable).ToString().Trim() -eq 1)){
        $maintenanceStart = $start.AddDays($prtggroup.data.maintstart)
        $maintenanceEnd   = $Start.AddDays($prtggroup.data.maintend)
        $maintenanceEnabled = "Yes"

        $Days = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Days
        $Hour = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Hours
        $Min  = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Minutes

        $duration = [string]::Format("{0} Days, {1} Hours, {2} Minutes", $Days, $Hour, $Min)
    
    $Group = [pscustomobject]@{
            ID   = $prtgGroup.ID
            Name = $prtgGroup.data.name.Trim()
            Type = "Group"
            "Maintenance Start" = $maintenanceStart
            "Maintenance End"   = $maintenanceEnd
            Duration            = $duration
           
           }
     $MaintenanceList += $Group 
    }
}

foreach($prtgDevice in $prtgDevices){

    if((($prtgDevice.data.maintenable).ToString().Trim() -eq 1)){
        $maintenanceStart = $start.AddDays($prtgDevice.data.maintstart)
        $maintenanceEnd   = $Start.AddDays($prtgDevice.data.maintend)
      

        $Days = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Days
        $Hour = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Hours
        $Min  = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Minutes

        $duration = [string]::Format("{0} Days, {1} Hours, {2} Minutes", $Days, $Hour, $Min)
    
        $Device = [pscustomobject]@{
                ID   = $prtgDevice.ID
                Name = $prtgDevice.data.name.Trim()
                Type = "Device"
            
                "Maintenance Start" = $maintenanceStart
                "Maintenance End"   = $maintenanceEnd
                Duration            = $duration
           
        }
        $MaintenanceList += $Device;
    }
}

foreach($prtgSensor in $prtgSensors){

    if((($prtgSensor.data.maintenable).ToString().Trim() -eq 1)){
        $maintenanceStart = $start.AddDays($prtgSensor.data.maintstart)
        $maintenanceEnd   = $Start.AddDays($prtgSensor.data.maintend)
        $maintenanceEnabled = "Yes"

        $Days = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Days
        $Hour = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Hours
        $Min  = (New-TimeSpan -Start $maintenanceStart -End $maintenanceEnd).Minutes

        $duration = [string]::Format("{0} Days, {1} Hours, {2} Minutes", $Days, $Hour, $Min)
   
        $Sensor = [pscustomobject]@{
                ID   = $prtgSensor.ID
                Name = $prtgSensor.data.name.Trim()
                Type = "Sensor"
                "Has Maintenance Configured" = $maintenanceEnabled
                "Maintenance Start" = $maintenanceStart
                "Maintenance End"   = $maintenanceEnd
                 Duration            = $duration
               }
         $MaintenanceList += $Sensor; 
        }
}

$MaintenanceList | Out-GridView -Title "Maintenance List"