Putting a computer into maintenance mode

  • Article

Putting a computer into maintenance mode is what users do when they know a particular computer will be offline for a while (security update, known network issues, hardware installation, other things). This is done so that OpsMgr does not generate any alerts about this computer. The interesting part is that OpsMgr will still generate one particular alert. This has to do with the fact that the management server is not getting heart beats from the agent. In order to avoid the alert, you need to put the instances of HealthService and HealthServiceWatcher that are associated with that computer into maintenance mode as well.

 Here is a script that based on a computer name, number of hours to be in maintenance mode and a comment will put all the right pieces into maintenance mode:

 

param($computerPrincipalName,$numberOfHoursInMaintenanceMode,$comment)

$computerClass = get-monitoringclass -name:Microsoft.Windows.Computer

$healthServiceClass = get-monitoringclass -name:Microsoft.SystemCenter.HealthService

$healthServiceWatcherClass = get-monitoringclass -name:Microsoft.SystemCenter.HealthServiceWatcher

$computerCriteria = "PrincipalName='" + $computerPrincipalName + "'"

$computer = get-monitoringobject -monitoringclass:$computerClass -criteria:$computerCriteria

$healthServices = $computer.GetRelatedMonitoringObjects($healthServiceClass)

$healthService = $healthServices[0]

$healthServiceCriteria = "HealthServiceName='" + $computerPrincipalName + "'"

$healthServiceWatcher = get-monitoringobject -monitoringclass:$healthServiceWatcherClass -criteria:$healthServiceCriteria

$startTime = [System.DateTime]::Now

$endTime = $startTime.AddHours($numberOfHoursInMaintenanceMode)

"Putting " + $computerPrincipalName + " into maintenance mode"

New-MaintenanceWindow -startTime:$startTime -endTime:$endTime -monitoringObject:$computer -comment:$comment

"Putting the associated health service into maintenance mode"

New-MaintenanceWindow -startTime:$startTime -endTime:$endTime -monitoringObject:$healthService -comment:$comment

"Putting the associated health service watcher into maintenance mode"

New-MaintenanceWindow -startTime:$startTime -endTime:$endTime -monitoringObject:$healthServiceWatcher -comment:$comment

In order to run this script you will need to do the following:

1 - Save to a a file (C:\MaintenanceMode.ps1)

2 - Open up the OpsMgr Command Shell

3 - Type the following:

C:\MaintenanceMode.ps1 -computerPrincipalName:"dc.contoso.com" -numberOfHoursInMaintenanceMode:4 -comment:"test"

The computerPrincipalName should contain the FQDN of the computer (for computers that are domain members) which you wish to put into maintenance mode.

Comments

  • Anonymous
    September 26, 2007
    Is there a similar way to put all computers in a group into maintenance mode?
  • Anonymous
    November 01, 2007
    Hello,i like just to notify that this script work not by me...I don´t know why..
  • Anonymous
    November 05, 2007
    Hi Boris,After i put a computer in maintenance mode for one hour using the script. the computer isn't go out, and in the console it appears in maintenance mode until i manually stop it . any idea ???
  • Anonymous
    January 04, 2008
    Maintenance mode expired, monitored server is still down, but there is no alert in the alert view of
  • Anonymous
    January 04, 2008
    Maintenance mode expired, monitored server is still down, but there is no alert in the alert view of
  • Anonymous
    January 05, 2008
    Maintenance mode expired, monitored server is still down, but there is no alert in the alert view of
  • Anonymous
    January 05, 2008
    Maintenance mode expired, monitored server is still down, but there is no alert in the alert view of
  • Anonymous
    February 20, 2008
    HiI get an errorGet-MonitoringClass : The 'Path' parameter is empty or the required provider location is not set."I don't know what the "Path" param should be.BR.Leif
  • Anonymous
    February 29, 2008
    There are many articles that talk about maintenance mode in System Center Operations Manager 2007. Topics
  • Anonymous
    April 20, 2008
    http://www.ezedir.com/Article/Computers/
  • Anonymous
    July 12, 2008
    Check out Boris Yanushpolsky's blog ( http://blogs.msdn.com/boris_yanushpolsky ). Boris is an SCOM
  • Anonymous
    November 01, 2008
    i like just to notify that this script work not by me...I don´t know why..
  • Anonymous
    November 12, 2008
    Interesting post, thanks for a good read!
  • Anonymous
    December 09, 2008
    It is a major problem, glad to of found a solution. Thanks.
  • Anonymous
    May 13, 2009
    Our servicedesk is using an adapted version of the GroupMaintenancemode -script from Boris Yanushpolski
  • Anonymous
    June 05, 2009
    Is there a way to place a computer in maintenance via an asp.net page, instead of a powershell script ?
  • Anonymous
    July 06, 2009
    i was having same issue thnx for solving the problem.
  • Anonymous
    October 22, 2009
    How can I disable all 2740 alerts on SCOM 2007 that monitor Exchange 2007?