Disable-CMAlert

Disable-CMAlert

Disables alerts in Configuration Manager.

Syntax

Parameter Set: SearchByIdMandatory
Disable-CMAlert -Id <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNameMandatory
Disable-CMAlert -Name <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Disable-CMAlert -InputObject <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Disable-CMAlert cmdlet disables one or more alerts in Microsoft System Center 2012 SP1 Configuration Manager.

System Center 2012 Configuration Manager does not evaluate the condition for a disabled alert and does not update a disabled alert, even if the state of the alert changes.

Parameters

-Id<String>

Specifies an alert ID. You can obtain the ID of an alert by using the Get-CMAlert cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

Specifies a CMAlert object. To obtain a CMAlert object, use Get-CMAlert.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of an alert. You can obtain the name of an alert by using Get-CMAlert.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Disable an alert by using alert ID

This command disables an alert that has the ID 16777218.

PS C:\> Disable-CMAlert -Id "16777218"

Example 2: Disable an alert by using alert object variable

The first command gets an alert object that has the ID 16777221, and then stores it in the $AlertObj variable.

The second command disables the alert stored in the $AlertObj variable.

PS C:\> $AlertObj = Get-CMAlert -Id "16777221"
PS C:\> Disable-CMAlert -InputObject $AlertObj

Enable-CMAlert

Get-CMAlert

Remove-CMAlert

Set-CMAlert

Suspend-CMAlert