Disable-SCOMMaintenanceSchedule

Reference

Module:: OperationsManager

Disables an existing maintenance schedule.

Syntax

Disable-SCOMMaintenanceSchedule
       [-IDs] <Guid[]>
       [-SCSession <Connection[]>]
       [-ComputerName <String[]>]
       [-Credential <PSCredential>]
       [<CommonParameters>]

Description

The Disable-SCOMMaintenanceSchedule cmdlet disables an existing maintenance schedule. If the existing schedule is active, this cmdlet returns an error.

When a resource is in maintenance mode, Operations Manager suppresses alerts, notifications, rules, monitors, automatic responses, state changes, and new alerts. Use a maintenance schedule to schedule a set of resources to go into maintenance mode.

By default, this cmdlet uses the active persistent connection to a management group. Use the SCSession parameter to specify a different persistent connection. You can create a temporary connection to a management group by using the ComputerName and Credential parameters. For more information, type Get-Help about_OpsMgr_Connections.

Examples

1: Disable a System Center Operations Manager maintenance mode schedule using its ID

PS C:\>Disable-SCOMMaintenanceSchedule -IDs "32AAB279-3670-ED11-9626-00155D012405"

2: Disable multiple System Center Operations Manager maintenance mode schedules using its ID

PS C:\>Disable-SCOMMaintenanceSchedule -IDs d52f957d-c361-ed11-bf99-000d3aae5ce4,e4f4ca88-417e-ed11-bf9a-000d3aae5ce4

In this example the Maintenance Schedules with ID of d52f957d-c361-ed11-bf99-000d3aae5ce4 and e4f4ca88-417e-ed11-bf9a-000d3aae5ce48 are being disabled.

3: Disable a System Center Operations Manager maintenance mode schedule with a pipeline

PS C:\>Get-SCOMMaintenanceSchedule -Id 5299606e-1e41-ee11-98ae-0022482492d1 | % { $_.ScheduleId } | Disable-SCOMMaintenanceSchedule

Disables a specific System Center Operations Manager maintenance mode schedule using a pipeline from Get-SCOMMaintenanceSchedule.

4: Disable all System Center Operations Manager maintenance mode schedules with a pipeline

PS C:\>Get-SCOMMaintenanceScheduleList | % { $_.ScheduleId } | Disable-SCOMMaintenanceSchedule

Disables all System Center Operations Manager maintenance mode schedule using a pipeline from Get-SCOMMaintenanceScheduleList.

Parameters

-ComputerName

Specifies an array computer names. The cmdlet establishes temporary connections with management groups for these computers. You can use NetBIOS names, IP addresses, or fully qualified ___domain names (FQDNs). To specify the local computer, type the computer name, localhost, or a dot (.).

The System Center Data Access service must be active on the computer. If you do not specify a computer, the cmdlet uses the computer for the current management group connection.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Specifies a PSCredential object for the management group connection. To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.If you specify a computer in the ComputerName parameter, use an account that has access to that computer. The default is the current user.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IDs

Specifies an array of schedule IDs for the schedule that this cmdlet disables.

Type:	Guid[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Specifies an array of Connection objects.

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Share via