![\"\"](\"https:\/\/kevinjustin.com\/blog\/wp-content\/uploads\/2017\/08\/caution-technology-ahead-1-300x208.png\")
<\/p>\n<\/p>\n
My thanks to Matt Taylor and Kevin Holman, Ralph Kyttle, and John Kavanagh\u00a0for their guidance!<\/p>\n
Updated 24 Jun 2022<\/span><\/strong><\/p>\n <\/p>\n <\/p>\n Read on if these apply<\/strong> Get alerts when MM is updated Ran into issues using Set-SCOMMaintenanceMode<\/span>, as the cmdlet doesn’t put ALL the recursive classes under Windows Computer<\/p>\n <\/p>\n <\/p>\n Background<\/strong><\/p>\n Set-SCOMMaintenanceMode<\/span> cmdlet\u00a0is actually \u201cby design.\u201d\u00a0 \u2639<\/p>\n <\/p>\n Start-SCOMMaintenanceMode<\/span> assumes you want recursive action when you start maintenance mode\u2026.<\/p>\n Pick a Windows Computer and it places the Windows Computer object (AND all contained objects) into MM.<\/p>\n <\/p>\n Computer in MM<\/p>\n All contained objects in MM<\/p>\n <\/p>\n <\/p>\n However, the problem is that Set-SCOMMaintenancemode<\/span> does not have an understanding of recursiveness.<\/p>\n Command\u00a0changes the MM entry for the Windows Computer, but NOT all the contained objects.\u00a0 So they retain the original setting.<\/p>\n <\/p>\n Health explorer looks like this, resulting in unwanted alerts<\/p>\n <\/p>\n <\/p>\n <\/p>\n Details<\/strong><\/p>\n NOTE these $Time and DateTime Method are dependent on the delay between running the commands<\/span> <\/p>\n <\/p>\n <\/p>\n # Setup variables for MM<\/strong><\/p>\n # Example\u00a01 Windows Computer<\/p>\n $server = “Servername.FQDN”<\/span><\/p>\n $instance = (get-scomclass -DisplayName “Windows Computer” |Get-SCOMClassInstance | where { $_.DisplayName -eq $server } )<\/span><\/p>\n # Set time for 6 minutes<\/p>\n $Time = (Get-Date).addMinutes(6)<\/span><\/p>\n Start-SCOMMaintenanceMode -Instance $Instance -EndTime $Time -Comment “Starting Maintenance Mode.” -Reason “PlannedOther”<\/span><\/p>\n <\/p>\n # Example\u00a02<\/p>\n # Business needs require Windows Operating System monitoring to occur while Application is in maintenance<\/p>\n # My Example is Defender, could be SQL, MSMQ, Lync, Skype, or your custom class created for your application<\/p>\n $Class = (get-scomclass)<\/span> DisplayName : Protected Endpoint DisplayName : Protected Candidate DisplayName : Unprotected Endpoint DisplayName : Microsoft Windows Defender Class # Choose the\u00a0class needed<\/p>\n $server = “Servername.FQDN”<\/span><\/p>\n $instance = ( $Class | ? { $_.Name -like “Microsoft.Windows.Defender*” } |Get-SCOMClassInstance | ? { $_.DisplayName -eq $server } )<\/span><\/p>\n # Verify Instance variable<\/span><\/p>\n $instance<\/span><\/p>\n PS C:\\Users\\scomadmin> $instance<\/p>\n HealthState\u00a0\u00a0\u00a0\u00a0 InMaintenanceMode\u00a0 DisplayName <\/p>\n # Don’t forget to add time variable<\/span><\/p>\n $Time = (Get-Date).addMinutes(6)<\/span><\/p>\n # Start maintenance mode<\/span> <\/span><\/p>\n Start-S<\/span>COMMaintenanceMode -Instance $Instance -EndTime $Time -Comment “Starting Maintenance Mode.” -Reason “PlannedOther”<\/span><\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n Start-SCOMMaintenanceMode -Instance $Instance -EndTime $Time -Comment “Starting Maintenance Mode.” -Reason “PlannedOther”<\/span><\/p>\n <\/p>\n <\/p>\n Note Recursive in $WCobj.ScheduleMaintenanceMode<\/span><\/p>\n $windowsComment=”PlannedOther”<\/span> $server= “wfm.testlab.net”<\/span> # Drop Recursive if you don’t want it (but can’t imagine why you would!)<\/p>\n <\/p>\n <\/p>\n # Make sure you’ve put object in MM<\/p>\n $server= “wfm.testlab.net”<\/span> # 15 minutes in the future <\/p>\n # Make sure you’ve put object in MM<\/p>\n # Immediate My thanks to Jan Nevaril <\/strong><\/p>\n $server.StopMaintenanceMode([System.DateTime]::Now.ToUniversalTime(),\u201cRecursive\u201d)<\/span><\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n # Verify MM<\/strong><\/p>\n get-scommaintenancemode -ComputerName $instance.Name|fl MonitoringObjectId,StartTime,ScheduledEndTime<\/span><\/p>\n NOTE This will error if you’ve stopped maintenance<\/span><\/p>\n Example<\/p>\n PS C:\\Users\\scomadmin> get-scommaintenancemode -ComputerName $instance.Name <\/p>\n <\/p>\n # Validate MM through\u00a0Operations Manager Event ID\u2019s 1215 and 1216 logged<\/strong><\/p>\n get-eventlog -LogName “Operations Manager” | ? { $_.EventID -eq 1215 -OR $_.EventID -eq 1216 } |fl EventID,TimeGenerated,Message<\/span><\/p>\n # Alternate command to check latest 100 events<\/p>\n get-eventlog -LogName “Operations Manager” -newest 100\u00a0| ? { $_.EventID -eq 1215 -OR $_.EventID -eq 1216 } |fl EventID,TimeGenerated,Message<\/span><\/p>\n <\/p>\n <\/p>\n # Error if object NOT in MM<\/span><\/b><\/p>\n Cannot find an overload for “UpdateMaintenanceMode” and the argument count: “1”.<\/span><\/p>\n At line:1 char:1<\/span><\/p>\n + $WCobj.UpdateMaintenanceMode(([System.datetime]::Now).addminutes(15). …<\/span><\/p>\n + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~<\/span><\/p>\n \u00a0\u00a0\u00a0 + CategoryInfo\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 : NotSpecified: (:) [], MethodException<\/span><\/p>\n \u00a0\u00a0\u00a0 + FullyQualifiedErrorId : MethodCountCouldNotFindBest<\/span><\/p>\n \u00a0<\/span><\/p>\n PS C:\\Windows\\system32><\/span><\/p>\n \u00a0<\/span><\/p>\n Testing System datetime<\/span><\/b><\/p>\n PS C:\\Windows\\system32> [System.datetime]::Now.addminutes(15)<\/span><\/p>\n \u00a0<\/span><\/p>\n Thursday, August 24, 2017 9:18:04 AM<\/span><\/p>\n \u00a0<\/span><\/p>\n \u00a0<\/span><\/p>\n PS C:\\Windows\\system32> ([System.datetime]::Now.addminutes(15)).touniversaltime()<\/span><\/p>\n \u00a0<\/span><\/p>\n Thursday, August 24, 2017 2:18:16 PM<\/span><\/p>\n <\/p>\n <\/p>\n <\/p>\n <\/p>\n References<\/strong><\/p>\n 2012 PowerShell cmdlets https:\/\/docs.microsoft.com\/en-us\/previous-versions\/system-center\/hh920227(v=sc.20)<\/a><\/p>\n 2016 PowerShell cmdlets https:\/\/docs.microsoft.com\/en-us\/powershell\/module\/operationsmanager\/?view=systemcenter-ps-2016<\/a><\/p>\n 2019 PowerShell cmdlets https:\/\/docs.microsoft.com\/en-us\/powershell\/module\/operationsmanager\/?view=systemcenter-ps-2019<\/a><\/p>\n SDK<\/p>\n Ralph Kyttle Blog https:\/\/blogs.technet.microsoft.com\/ralphkyttle\/2014\/11\/10\/scom-2012-r2-use-powershell-to-end-an-active-maintenance-mode\/<\/a><\/p>\n DateTime Methods https:\/\/docs.microsoft.com\/en-us\/dotnet\/api\/system.datetime<\/a><\/p>\n SCOM 2019 Maintenance Mode MSDN MaintenanceModeReason Method\u00a0https:\/\/docs.microsoft.com\/en-us\/previous-versions\/system-center\/developer\/bb465591(v=msdn.10)<\/a><\/p>\n MSDN StopMaintenanceMode Method<\/p>\n UpdateMaintenanceMode Method https:\/\/docs.microsoft.com\/en-us\/previous-versions\/system-center\/developer\/bb424495(v=msdn.10)<\/a><\/p>\n <\/p>\n MM deluxe custom script https:\/\/gist.github.com\/stegenfeldt\/b3f044aa77894ed80d82f8849a48035b<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
\nTrying to start, update, or end SCOM MM<\/p>\n
\nPowerShell only in your shop!
\nSCORCH in play but need to convert runbooks to straight PowerShell<\/p>\n![\"\"](\"https:\/\/kevinjustin.com\/blog\/wp-content\/uploads\/2017\/08\/MMExtended1.PNG\")
<\/p>\n![\"\"](\"https:\/\/kevinjustin.com\/blog\/wp-content\/uploads\/2017\/08\/Still-In-MM1.png\")
<\/p>\n![\"\"](\"https:\/\/kevinjustin.com\/blog\/wp-content\/uploads\/2017\/08\/WindowsComputerINMM.PNG\")
<\/p>\n
\n If you start MM, and wait 5 minutes, then update, the total MM duration will be ~20 minutes<\/span><\/p>\nMaintenance Mode options and examples<\/h1>\n
\n$Class | ? { $_.Name -like “*Defender*” } | fl DisplayName,Name<\/span>
\n$Class | ? { $_.Name -like “*Defender*” } | fl DisplayName,Name<\/span><\/p>\n
\nName\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 : Microsoft.WindowsDefender.ProtectedServer<\/p>\n
\nName\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 : Microsoft.WindowsDefender.ProtectedServerCandidate<\/p>\n
\nName\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 : Microsoft.WindowsDefender.UnprotectedServer<\/p>\n
\nName\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 : Microsoft.Windows.Defender.Class<\/p>\n
\n———–\u00a0\u00a0\u00a0\u00a0 —————–\u00a0 ———–
\nSuccess\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 False\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 WFM.testlab.net<\/p>\nStart, Update,\u00a0End and Verify Maintenance mode syntax<\/h1>\n
# Start MM via PoSH cmdlet<\/strong><\/h2>\n
# Start MM\u00a0using\u00a0method vs. PowerShell cmdlet<\/strong><\/h2>\n
\n$windowReason=”PlannedOther”<\/span>
\n$windowsComment=”Testing Maintenance Mode”<\/span>
\n$windowDuration=15<\/span><\/p>\n
\n$instance = (get-scomclass -DisplayName “Windows Computer” |Get-SCOMClassInstance | ? { $_.DisplayName -eq $server } )<\/span>
\n$instance<\/span>.ScheduleMaintenanceMode([datetime]::Now.touniversaltime(),([datetime]::Now).addminutes($windowDuration).touniversaltime(), “$windowReason”, “$windowsComment” , “Recursive”)<\/span><\/p>\n# Update MM<\/strong><\/h2>\n
\n$instance = (get-scomclass -DisplayName “Windows Computer” |Get-SCOMClassInstance | ? { $_.DisplayName -eq $server } )<\/span><\/p>\n
\n$instance.UpdateMaintenanceMode([System.datetime]::Now.touniversaltime().addminutes(15),[Microsoft.EnterpriseManagement.Monitoring.MaintenanceModeReason]::PlannedOther,[System.string]::”Adding 15 minutes to the end time.”,[Microsoft.EnterpriseManagement.Common.TraversalDepth]::Recursive);<\/span><\/p>\n# Stop MM<\/strong><\/h2>\n
\n$instance.StopMaintenanceMode([System.DateTime]::Now.ToUniversalTime());<\/span><\/p>\n<\/h1>\n
Verification steps<\/h1>\n
\nget-scommaintenancemode : The Data Access service is either not running or not yet initialized. Check the event log
\nfor more information.
\nAt line:1 char:1
\n+ get-scommaintenancemode -ComputerName $instance.Name
\n+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\n+ CategoryInfo\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 : InvalidOperation: (Microsoft.Syste…anceModeCommand:GetSCMaintenanceModeCommand) [Get-S
\nCOMMaintenanceMode], ServiceNotRunningException
\n+ FullyQualifiedErrorId : ExecutionError,Microsoft.SystemCenter.OperationsManagerV10.Commands.GetSCMaintenanceMode
\nCommand<\/p>\n
\nhttps:\/\/docs.microsoft.com\/en-us\/system-center\/scom\/manage-maintenance-mode-overview?view=sc-om-2019<\/a><\/p>\n