I finally found out the issue why this script was not working for everybody. It was because of the different versions of PowerShell. Now it should also work on PowerShell v2.
Another possible fix to the empty ComputerGroupsMembernames issue.
Last week I saw a request for a PowerShell script which would put all the members of a OM2012 Computer Group in Maintenance Mode, so this could be used with the Task Scheduler.
I know there are quite some alternative when it comes to putting instances in Maintenance Mode, but I thought it would be cool to create the mother-of-all maintenance mode PowerShell scripts for OM2012 :-)
This PowerShell script can be run standalone or scheduled with the Task Scheduler and has the following cool features:
Ok enough about the features, here is the script:
####################################################################################################################### # Puts a OM2012 Computer Group in Maintenance Mode using PowerShell # Author: Stefan Stranger (Microsoft) # Example usage: Run Get-Help Get-SCOMMaintenanceModeForGroups.ps1 -Examples # Disclamer: This program source code is provided "AS IS" without warranty representation or condition of any kind # either express or implied, including but not limited to conditions or other terms of merchantability and/or # fitness for a particular purpose. The user assumes the entire risk as to the accuracy and the use of this # program code. # Tested on PowerShell v3 and OM2012 environment # Date: 03-07-2012 # Name: Get-SCOMMaintenanceModeForGroups.ps1 # v1.000 - 03-07-2012 - Stefan Stranger - initial sstranger's release # v1.001 - 06-07-2012 - Stefan Stranger - Added Eventlog and WhatIf Switch # v1.003 - 07-11-2012 - Stefan Stranger - Fixed issue on PowerShell v2, Now works on v2 and v3 # v1.004 - 16-11-2012 - Stefan Stranger - Fixed issue with empty GroupMembershipNames issue######################################################################################################################## <# .SYNOPSIS Places all members of a SCOM Computer Group in into maintenance mode, and creates new active maintenance mode entries. .DESCRIPTION The Start-MaintenanceModeForGroups script places all members of a SCOM Computer Group into maintenance mode, and creates new active maintenance mode entries. When in maintenance mode, alerts, notifications, rules, monitors, automatic responses, state changes, and new alerts are suppressed for the class instance. .EXAMPLE Start-SCOMMaintenanceModeForGroup.ps1 -ComputerGroup "All Windows Computers" -EndTime 10 -Reason "UnplannedOther" -Comment "Testing Maintenance Mode" -Verbose Puts all Members of the "All Windows Computer" Group in Maintenance Mode for 10 minutes, with Reason "UnplannedOther" and with Comment "Testing Maintenance Mode". Adding Verbose information. .EXAMPLE Start-SCOMMaintenanceModeForGroup.ps1 -ComputerGroup "All Windows Computers" -EndTime 10 -Reason "UnplannedOther" -Comment "Testing Maintenance Mode" -Eventlog Puts all Members of the "All Windows Computer" Group in Maintenance Mode for 10 minutes, with Reason "UnplannedOther" and with Comment "Testing Maintenance Mode". Writing Eventlog information to the "Operations Manager" Eventlog (eventid 998 and eventid 999). Can be used for tracking and debugging when Task Scheduler is being used. .EXAMPLE Start-SCOMMaintenanceModeForGroup.ps1 -ComputerGroup "All Windows Computers" -EndTime 10 -Reason "UnplannedOther" -Comment "Testing Maintenance Mode" -WhatIf Using the WhatIf switch shows which Members of the "All Windows Computer" Group would be put in Maintenance Mode if you had run the script. So the members are not really put into maintenance mode. For testing purposes. .PARAMETER ComputerGroup The SCOM Computer Group name for which members you want to put in Maintenance Mode. .PARAMETER EndTime Specifies the time the maintenance will end. The minimum amount of time a resource can be in maintenance mode is 5 minutes. .PARAMETER Reason Specifies the reason for placing the resource into maintenance mode. Valid values are: UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity .Parameter Comment Allows you to type a comment about the maintenance activity. .Parameter EventLog Writes information to the "Operations Manager" Eventlog to track what is happening. .Link http://blogs.technet.com/stefan_stranger#> #requires -version 2.0 [CmdletBinding(SupportsShouldProcess=$true)] param ( [Parameter(Mandatory=$True, ValueFromPipeline=$True, ValueFromPipelineByPropertyName=$True, HelpMessage='What is the ComputerGroup you want to put in Maintenance Mode?')] [Alias("Group")] [string[]]$ComputerGroup, [Parameter(Mandatory=$True, ValueFromPipeline=$false, ValueFromPipelineByPropertyName=$True, HelpMessage='Specifies the time the maintenance will end. The minimum amount of time a resource can be in maintenance mode is 5 minutes. This is a required parameter')] [int]$EndTime, [Parameter(Mandatory=$False, ValueFromPipeline=$True, ValueFromPipelineByPropertyName=$True, HelpMessage='UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity')] [string]$Reason, [Parameter(Mandatory=$False, ValueFromPipeline=$True, ValueFromPipelineByPropertyName=$True, HelpMessage='Allows you to type a comment about the maintenance activity.')] [string]$Comment, [switch]$EventLog ) set-strictmode -version latest $start=Get-Date $currentlog = $start.ToString() Write-Verbose "Starting $($myinvocation.mycommand)" Write-Verbose "Ready to put ComputerGroup $ComputerGroup in Maintenance Mode" Function Start-SCOMMaintenanceModeForGroup { <# .SYNOPSIS Sets a SCOM Group in Maintenance Mode .DESCRIPTION Sets the members of a SCOM Group in Maintenance Mode .EXAMPLE Start-SCOMMaintenanceModeForGroup -ComputerGroup "All Windows Computers" -EndTime 10 -Reason "UnplannedOther" -Comment "Testing Maintenance Mode" -Verbose .PARAMETER ComputerGroup The SCOM Computer Group name for which members you want to put in Maintenance Mode. .PARAMETER EndTime Specifies the time the maintenance will end. The minimum amount of time a resource can be in maintenance mode is 5 minutes. .PARAMETER Reason Specifies the reason for placing the resource into maintenance mode. Valid values are: UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity .Parameter Comment Allows you to type a comment about the maintenance activity. .Link http://blogs.technet.com/stefan_stranger #> [CmdletBinding(SupportsShouldProcess=$true)] param ( [Parameter(Mandatory=$True, ValueFromPipeline=$True, ValueFromPipelineByPropertyName=$True, HelpMessage='What is the ComputerGroup you want to put in Maintenance Mode?')] [Alias("Group")] [string[]]$ComputerGroup, [Parameter(Mandatory=$True, ValueFromPipeline=$false, ValueFromPipelineByPropertyName=$True, HelpMessage='Specifies the time the maintenance will end. The minimum amount of time a resource can be in maintenance mode is 5 minutes. This is a required parameter')] [int]$EndTime, [Parameter(Mandatory=$False, ValueFromPipeline=$True, ValueFromPipelineByPropertyName=$True, HelpMessage='UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity')] [string]$Reason, [Parameter(Mandatory=$False, ValueFromPipeline=$True, ValueFromPipelineByPropertyName=$True, HelpMessage='Allows you to type a comment about the maintenance activity.')] [string]$Comment, [switch]$EventLog ) Begin { Write-Verbose "Starting Function Start-SCOMMaintenanceModeForGroup Function" #Check for minumum Maintenance mode period of 5 mins. if($endtime -lt 5) { Write-Error "The time span for the maintenance mode should be at least 5 minutes." -ErrorAction Stop } Write-Verbose "Following Group Members will be put in Maintenance Mode:" $ComputerGroupMembers = Get-SCOMMonitoringObject -DisplayName $ComputerGroup if($ComputerGroupMembers) { #$ComputerGroupMemberNames = ($ComputerGroupMembers.getrelatedMonitoringObjects() | select DisplayName).DisplayName $ComputerGroupMemberNames = ($ComputerGroupMembers.getrelatedMonitoringObjects() | select DisplayName) Write-Verbose "$ComputerGroupMemberNames" #Retrieve Management Servers so we can check if we don't put Management Servers in MM. $MSs = Get-SCOMManagementServer } else { Write-Error "No Members of ComputerGroup $ComputerGroup found" -ErrorAction Stop } } #End Begin Process { #Put Agents in Maintenance Mode foreach ($agent in $ComputerGroupMembers.getrelatedMonitoringObjects()) { Write-Verbose "Checking if ComputerGroup Member $agent is not a Management Server" if(($MSs | Select DisplayName) -eq $agent) { Write-Verbose "We don't want to put a Management Server in MM. Skipping" } else { Write-Verbose "Let's put Agent $Agent in Maintenance Mode" $Instance = Get-SCOMClassInstance -Name $Agent if ($PSCmdlet.ShouldProcess("Putting $Agent in Maintenande Mode for $($Endtime) minutes") ) { #Added 5 seconds to EndTime to prevent failing the Start-SCOMMaintenanceMode cmdlet. Min. 5 mins is needed. Start-SCOMMaintenanceMode -Instance $Instance -EndTime ([System.DateTime]::Now).AddSeconds(5).addMinutes($EndTime) -Reason $Reason -Comment $Comment }#End of whatif }#End of else }#End Foreach if ($PSBoundParameters['EventLog']) { write-eventlog -LogName "Operations Manager" -Source "OpsMgr SDK Service" -EventID 999 -message "The following Objects are put into in Maintenance Mode for $($EndTime) minutes: $($ComputerGroupMembers.getrelatedMonitoringObjects())" }#End if } #End Process End { Write-Verbose "Finished Function Start-SCOMMaintenanceModeForGroup Function" } } #Main try { if ($PSBoundParameters['EventLog']) { write-eventlog -LogName "Operations Manager" -Source "OpsMgr SDK Service" -EventID 998 -message "The $($myinvocation.mycommand) is used to put Objects in Maintenance Mode" } Write-Verbose "Checking if OperationsManager Module is loaded" #Check if OperationsManager Module is loaded. if(!(Get-Module OperationsManager)) { Write-Verbose "Importing OperationsManager Module" Import-Module OperationsManager -ErrorAction Stop } Write-Verbose "Checking for OM2012 environment" #Check if OM2012 is being used. if(!(Get-Module OperationsManager).Description -eq "Operations Manager OperationsManagerV10 Module") { Write-Error "This script is only for OM2012" } #Call Function if ($PSBoundParameters['EventLog']) { Start-SCOMMaintenanceModeForGroup -ComputerGroup $ComputerGroup -EndTime $EndTime -Reason $Reason -Comment $Comment -EventLog } else { Start-SCOMMaintenanceModeForGroup -ComputerGroup $ComputerGroup -EndTime $EndTime -Reason $Reason -Comment $Comment } } #End Try catch [System.IO.FileNotFoundException] { "OperationsManager Module not found" $_.Exception.Message } catch { Write-Warning "Oops something went wrong" $_.Exception.Message } $end=Get-Date Write-Debug ("Total processing time {0}" -f ($end-$start).ToString()) Write-Verbose "Ending $($myinvocation.mycommand)"
You can use the Get-Help Get-SCOMMaintenanceModeForGroups.ps1 –full command in PowerShell to see the complete help for this script.
Example using the –WhatIf switch
Let’s do the real deal and put some members of my “Stefan – OM2012 Maintenance Computer Group” in Maintenance Mode for 5 minutes.
Result:
How do use this cool PowerShell script to schedule Maintenance Mode using the Task Scheduler?
Steps:
Save script as: D:\Scripts\OM2012\Start-SCOMMaintenanceModeForGroups.ps1
Open TaskScheduler (on OM2012 Management Server or where you have installed the Operations Manager Console)
Create a new Task
Enter Name and make sure the user account under which the Scheduled Task is running is having enough permissions in SCOM. Select Run with Highest privileges.
Configure Trigger
Add action
Program/script: powershell.exe
Add argument (optional): D:\Scripts\OM2012\Start-SCOMMaintenanceModeForGroups.ps1 -ComputerGroup 'Stefan - OM2012 Maintenance Computer Group' -EndTime 5 -Reason "UnplannedOther" –Comment 'Testing MM' -Eventlog
Remark: Make sure you use single quotes of ComputerGroup, Reason or Comment Parameters if space are being used in the name.
Enter Credentials
If you have scheduled to script using the EventLog Switch toy can look in the Operations Manager Eventlog for auditing info.
You can download the script from the Script Center Repository: http://gallery.technet.microsoft.com/scriptcenter/Put-OM2012-Computer-Group-43902672
Have fun!
I keep getting this error:
PS C:\> C:\!Scripts\Start-SCOMMaintenanceModeForGroups.ps1 -ComputerGroup 'Maintenance Mode - Friday 4AM' -EndTime 5 -Re
ason "UnplannedOther" -Comment 'Testing MM' -Eventlog
WARNING: Oops something went wrong
Property 'DisplayName' cannot be found on this object. Make sure that it exists.
Any idea why?
I get the same error too.
I wonder if this script ever worked.
You have to do some modifications to get it running:
1) $ComputerGroupMembers.getrelatedMonitoringObjects().DisplayName does not work, so use:
$ComputerGroupMemberNames = $ComputerGroupMembers.getrelatedMonitoringObjects()
Write-Verbose "$ComputerGroupMemberNames"
2) If you have more than 1 manager:
...
Write-Verbose "Checking if ComputerGroup Member $agent is not a Management Server"
$IsMS = 0
foreach ($manager in $MSs)
{
if(($manager | Select DisplayName).displayname -eq $agent)
Write-Verbose "We don't want to put a Management Server in MM. Skipping"
$IsMS = 1
}
if ( $IsMS -eq 0 )
Write-Verbose "Let's put Agent $Agent in Maintenance Mode"
....
3) No need for "$Instance = Get-SCOMClassInstance -Name $Agent", because Start-SCOMMaintenanceMode needs $Agent instead of $Instance!
So, modify:
Start-SCOMMaintenanceMode -Instance $Agent -EndTime ([System.DateTime]::Now).AddSeconds(5).addMinutes($EndTime) -Reason $Reason -Comment $Comment
4) Comment and Reason are not defined as mandatory, but are needed!
So add following lines to define defaults:
#Call Function
if ( $Reason -eq "" )
$Reason = "PlannedApplicationMaintenance"
if ( $Comment -eq "" )
$Comment = "Scheduled Maintenance"
Regards, Werner
Hi Guys,
I'm sorry if the script is not working. I've tested the script in my environment and it worked in my environment. But will look at your comments soon.
/Stefan
Hi guys,
Today I tested my script which I downloaded from the Script Center Repository and run the following:
PS D:\Scripts\OM2012\Online> .\Start-SCOMMaintenanceModeForGroups.ps1 -ComputerGroup "All Windows Computers" -EndTime 10-Reason "UnplannedOther" -Comment "Testing" -Verbose
I just put all my agents in my "All Windows Computer" Group in Maintenance mode.
@Rich:
Can you run the same command but with the -Verbose Switch on? And let me know where it fails?
@JW:
@Werner:
When I check the methods and properties of the $ComputerGroupMembers variable I see the following:
[DBG]: PS D:\Scripts\OM2012\Online>> $ComputerGroupMembers.getrelatedMonitoringObjects()
HealthState InMaintenanceMode DisplayName
----------- ----------------- -----------
Error False W2K8R2DC1.DEMO.STRANGER
Success False OM12DMZ01.demo.dmz
Warning False OM12MS02.DEMO.STRANGER
Warning False OM12MS01.DEMO.STRANGER
[DBG]: PS D:\Scripts\OM2012\Online>> $ComputerGroupMembers.getrelatedMonitoringObjects().DisplayName
W2K8R2DC1.DEMO.STRANGER
OM12DMZ01.demo.dmz
OM12MS02.DEMO.STRANGER
OM12MS01.DEMO.STRANGER
So I there is a property DisplayName (in my environment)
And regarding multiple Management Servers, I've multiple Management Servers and with the following PowerShell code I am checking multiple MS if they are not Agents.
if(($MSs | Select DisplayName).displayname -eq $agent)
Try the following in PowerShell:
$testagents = "test1", "test2", "test3"
$testmss = "test1", "test4", "test5"
foreach ($agent in $testagents)
Write-Host "Checking if ComputerGroup Member $agent is not a Management Server"
if($testmss -eq $agent)
Write-Host "We don't want to put a Management Server: $agent in MM"
else
Write-Host "Let's put Agent $Agent in Maintenance Mode"
}#End of else
}#End Foreach
Will look at all your other comments later this week.
When targeted at a Windows Computer object puts only that object into maintenance mode ie does not puts all contained objects into maintenance mode.
Hi Adam,
What is not working correctly? Could you please expand a little bit on what is failing according too you?
I really like the script, but had to do some modifications to get it to work. I debugged the script in PS for the Get-SCOMMonitoringObject which according to the SDK is an alias to the Get-SCOMClassInstance cmdlet. According to that you have to identify the -Group tack in order to pass the intent to work in the Group class. I bypassed that by using the Get-SCOMGroup cmdlet and dropped the .DisplayName from the $ComputerGroupMembers.getrelatedMonitoringObjects() section. I then passed DisplayName through the Write-Verbose portion by tacking it on to "ComputerGroupMemberNames.DisplayName" . I have two management servers and took your advice to statically define them in the $MSs parm. I then dropped the pipe in the loop and just did a ($MSs -eq $agent) which works like a champ.
Thanks again!!
I've tried to get this to work but it just doesn't. I'm still using the old 2007 r2 script for 2012 which works but is uglier.
To those that have made all the changes and claim it now works it would be nice to share the script.
Stefan's out of the box script is not working as written in 2 different 2012 env I've tested.
Appreciate everyone's efforts on this, especially Stefan's!
Same problem here.
PS D:\scripts> .\Start-SCOMMaintenanceModeForGroups.ps1 -ComputerGroup "GTS MM Test Group" -Endtime 10 -reason "Unplanne
dOther" -Comment "Cause" -verbose
VERBOSE: Starting Start-SCOMMaintenanceModeForGroups.ps1
VERBOSE: Ready to put ComputerGroup GTS MM Test Group in Maintenance Mode
VERBOSE: Checking if OperationsManager Module is loaded
VERBOSE: Checking for OM2012 environment
VERBOSE: Starting Function Start-SCOMMaintenanceModeForGroup Function
VERBOSE: Following Group Members will be put in Maintenance Mode:
VERBOSE: Ending Start-SCOMMaintenanceModeForGroups.ps1
Yep, same DisplayName issues as most with the script :(
Yep tested and working correctly :) Will be implementing this in our environment. Thanks!
Nice Post Stefan!
Getting the same error as Matt:
VERBOSE: Starting Start-SCOMMaintenanceModeForGroups_v3.ps1
VERBOSE: Ready to put ComputerGroup ScheduledMM in Maintenance Mode
Property 'displayname' cannot be found on this object. Make sure that it exists.
VERBOSE: Ending Start-SCOMMaintenanceModeForGroups_v3.ps1
PS D:\scripts> .\Start-SCOMMaintenanceModeForGroups_v3.ps1 -ComputerGroup 'ScheduledMM' -EndTime 5 -Reason "UnplannedOth
er" -Comment 'Testing MM' -Eventlog -Debug
DEBUG: Total processing time 00:00:00.1980000
To provide more context, I only have one MS in this environment (2 in prod though) and multiple computers I'm trying to put in maintenance mode in the group ScheduledMM. All computers are of Microsoft.Windows.Computer class.