Maintenance Mode is an important concept to suppress alerts for planned maintenance windows. SCOM allows you to put all discovered in maintenance mode. This could be a Windows Computer, a SQL database or a distributed application. Depending on the activation of the maintenance mode, for a specific object, child objects are also put into maintenance mode automatically. For instance if a distributed application is put into maintenance mode, all components that belong to that DA are also put into maintenance mode. One of my customers had the requirement that when a computer is put into maintenance mode and this computer belongs to a cluster, the cluster object and therefore all the child objects (e.g. all cluster nodes) should be places into maintenance mode as well. I solved this with a PowerShell script.

The script can be used to put a computer into maintenance mode. The script checks if that computer is a cluster node. If true, the complete cluster with all nodes should be places into maintenance mode. If it’s a computer that does not belong to a cluster, only the computer itself is put into maintenance mode.

The script accepts different parameters, for instance the SCOM server name, the computer name to put into maintenance mode, the duration and a comment.

#
# System Center 2012 – Operations Manager
#
# Start Maintenance Mode Script For Computer Objects. If the Computer
# belongs to a Cluster, Maintenance Mode is started for the complete Cluster
# 2013, Marcel Zehner/itnetx
#

param(
[Parameter(Position=1,mandatory=$true)][string]$scomservername,
[Parameter(Position=2,mandatory=$true)][string]$computername,
[Parameter(Position=3,mandatory=$true)][int]$hours,
[Parameter(Position=4,mandatory=$true)][string]$comment
)

$error.clear()

import-module operationsmanager

# Connect to SCOM Server
new-scommanagementgroupconnection -computername $scomservername

# Preparation
$start = get-date
$end = $start.addhours($hours)

$class_wincomputer = Get-SCOMClass -name System.Computer
$class_wincluster = Get-SCOMClass -name Microsoft.Windows.Cluster
$relID = (Get-SCOMRelationship -name Microsoft.Windows.Cluster.Contains.Microsoft.Windows.Cluster.Node).id

#Get Computer Object
$mmcomputerobject = get-scommonitoringobject -Class $class_wincomputer | where{$_.displayname -eq $computername}

# Check If Object Exists
if(!$mmcomputerobject)
{
$output = “The computer was not found in SCOM”
Write-Host $output -foregroundcolor yellow
exit
}

#Check if Computer belongs to a cluster
$clustername = $null
$clustername = (Get-SCOMRelationshipInstance -TargetInstance $mmcomputerobject | where{$_.relationshipid -eq $relID}).Sourceobject.name

#Enable Maintenance Mode for the whole Cluster if it does belong to a Windows Cluster
if($clustername)
{
$mmclusterobject = Get-SCOMClassInstance -class $class_wincluster | where{$_.displayname -eq $clustername}

# Check If the Cluster is already In Maintenance Mode
if($mmclusterobject.inmaintenancemode -eq $true)
{
$output = “The computer belongs to a cluster. The cluster is already in maintenance mode”
Write-Host $output -foregroundcolor yellow
}

# Start Maintenance Mode For Cluster
if($mmclusterobject.inmaintenancemode -eq $false)
{
Start-SCOMMaintenanceMode -Instance $mmclusterobject -EndTime $end -Comment $comment

# Check If Maintenance Mode Activation Was Successful
$mmclusterobject = Get-SCOMClassInstance -class $class_wincluster | where{$_.displayname -eq $clustername}
if($mmclusterobject.inmaintenancemode){$output = “The computer belongs to a cluster. The cluster is now in maintenance mode”}
else{$output = “The computer belongs to a cluster. An error occured while starting maintenance mode for the cluster”}
Write-Host $output -foregroundcolor yellow
}
}

#Enable Maintenance Mode only for the Computer if it does not belong to a Windows Cluster
else{

# Check If the Computer os already In Maintenance Mode
if($mmcomputerobject.inmaintenancemode -eq $true)
{
$output = “The computer does not belong to a cluster. The computer is already in maintenance mode”
Write-Host $output -foregroundcolor yellow
}

if($mmcomputerobject.inmaintenancemode -eq $false)
{
Start-SCOMMaintenanceMode -Instance $mmcomputerobject -EndTime $end -Comment $comment

# Check If Maintenance Mode Activation Was Successful
$mmcomputerobject = get-scommonitoringobject -Class $class_wincomputer | where{$_.displayname -eq $computername}
if($mmcomputerobject.inmaintenancemode){$output = “The computer does not belong to a cluster. The computer is now in maintenance mode”}
else{$output = “The computer does not belong to a cluster. An error occured while starting maintenance mode for the computer”}

Write-Host $output -foregroundcolor yellow
}
}

Have fun with the script!

Cheers
Marcel