Set-CMAlert

Changes properties of Configuration Manager alerts.

Syntax

Set-CMAlert
   [-Comment <String>]
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Id <String>
   [-NewName <String>]
   [-ParameterValue <String>]
   [-Severity <Severities>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMAlert [-Comment ] [-Confirm] [-DisableWildcardHandling] [-ForceWildcardHandling]
 -InputObject  [-NewName ] [-ParameterValue ] [-Severity ] [-WhatIf]
 []
Set-CMAlert [-Comment ] [-Confirm] [-DisableWildcardHandling] [-ForceWildcardHandling] -Name 
 [-NewName ] [-ParameterValue ] [-Severity ] [-WhatIf] []

Description

The Set-CMAlert cmdlet changes the properties of one or more Microsoft System Center Configuration Manager alerts.

Examples

Example 1: Set alert properties

PS C:\> Set-CMAlert -Id "16777223" -Comments "Editing severity" -Severity 2

This command changes the values of the Comments and Severity properties for an alert that has the ID 16777223.

Example 2: Set alert properties by using alert object variable

PS C:\> $AlertObj = Get-CMAlert -Id "16777221"
PS C:\> Set-CMAlert -InputObject $AlertObj -Comments "Updating alert"

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

The second command changes the Comments property of the alert stored in the $AlertObj variable.

Required Parameters

-Id

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

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

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

Type:IResultObject
Aliases:Alert
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

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

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

Optional Parameters

-Comment
Type:String
Aliases:Comments
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

Specifies a new name for the alert.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ParameterValue
Type:String
Aliases:ParameterValues
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Severity

Specifies the severity of an alert. The acceptable values for this parameter are:- 1: Error

  • 2: Warning
  • 3: Informational
Type:Severities
Parameter Sets:Error, Warning, Informational
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False