PowerShell: Schedule a URL into Maintenance Mode

.\URLMaintenanceModeV4.ps1 -rootMS 'scom-rms.example.com' -urlName 'MSN Website Checker' -minutes 45 -comment 'My Comment' -reason 'PlannedOther'

C:\WINDOWS\system32\WindowsPowerShell\v1.0\powershell.exe .\URLMaintenanceModeV4.ps1 -rootMS 'scom-rms.example.com' -urlName 'MSN Website Checker' -minutes 45 -comment 'My Comment' -reason 'PlannedOther'

<#
.SYNOPSIS
    Puts a SCOM URL (web application) watcher into maintenance mode for a number of minutes.
.DESCRIPTION
    Loads the Operations Manager snap-in, connects to the root management server, finds every
    web application watcher whose display name matches urlName and starts a maintenance window
    on each one, beginning now and lasting the given number of minutes.
.PARAMETER rootMS
    Root management server used for the management group connection.
.PARAMETER urlName
    Display name of the URL (web application) watcher, exactly as shown in SCOM. Every object with this name is put into maintenance mode.
.PARAMETER minutes
    Length of the maintenance window in minutes, starting now.
.PARAMETER comment
    Comment stored on the maintenance window.
.PARAMETER reason
    Maintenance mode reason, for example PlannedOther.
.EXAMPLE
    .\URLMaintenanceModeV4.ps1 -rootMS 'scom-rms.example.com' -urlName 'MSN Website Checker' -minutes 45 -comment 'My Comment' -reason 'PlannedOther'
.NOTES
    Author  : Thomas Lasswell (https://www.techcolumnist.com)
    Version : 1.1 (2026-09-20)
    History : 1.0 2010-07-07 Initial version.
              1.1 2026-09-20 Stops with an error when no URL watcher matches the name.
    Requires: SCOM 2007 R2 snap-in Microsoft.EnterpriseManagement.OperationsManager.Client
    Adapted from the original script published at scom2k7.com, modified to loop over multiple watcher hosts.
.LINK
    http://www.scom2k7.com/schedule-a-into-url-maintenance-mode/
#>
param($rootMS, $urlName, $minutes, $comment, $reason)

# Load the snap-in and connect to the management group.
Add-PSSnapin "Microsoft.EnterpriseManagement.OperationsManager.Client" -ErrorVariable errSnapin

Set-Location "OperationsManagerMonitoring::" -ErrorVariable errSnapin
New-ManagementGroupConnection -ConnectionString:$rootMS -ErrorVariable errSnapin
Set-Location $rootMS -ErrorVariable errSnapin

# Find the URL watcher objects by display name.
$URLWatcher = (Get-MonitoringClass -Name Microsoft.SystemCenter.WebApplication.Perspective) | Get-MonitoringObject | Where-Object { $_.DisplayName -eq $urlName }

# Stop if nothing matched, so the script does not report success without doing anything.
if (-not $URLWatcher) {
    Write-Error "No URL watcher found with the display name '$urlName'."
    exit 1
}

# Build the maintenance window.
$startTime = [System.DateTime]::Now
$endTime = $startTime.AddMinutes($minutes)

"Putting URL into maintenance mode"
foreach ($name in $URLWatcher) {
    New-MaintenanceWindow -StartTime:$startTime -EndTime:$endTime -MonitoringObject:$name -Comment:$comment -Reason:$reason
}