Share via

Set-SCOMAlert

Module:
OperationsManager Module

Changes the properties of alerts.

Syntax

Default (Default) 

Set-SCOMAlert
    -Alert <MonitoringAlert[]>
    [-Connector <MonitoringConnector>]
    [[-CustomField1] <String>]
    [[-CustomField2] <String>]
    [[-CustomField3] <String>]
    [[-CustomField4] <String>]
    [[-CustomField5] <String>]
    [[-CustomField6] <String>]
    [[-CustomField7] <String>]
    [[-CustomField8] <String>]
    [[-CustomField9] <String>]
    [[-CustomField10] <String>]
    [[-ResolutionState] <Byte>]
    [[-Owner] <String>]
    [[-TicketId] <String>]
    [-TfsWorkItemId <String>]
    [-TfsWorkItemOwner <String>]
    [[-Comment] <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Set-SCOMAlert cmdlet changes the properties of one or more alerts. You can use the cmdlet to resolve an alert by setting the ResolutionState parameter to 255 (Closed).

Examples

Example 1: Close alerts by using the resolution state

PS C:\>Get-SCOMAlert -ResolutionState 15 | Set-SCOMAlert -ResolutionState 255

This command gets all alerts with a resolution state of 15 and then passes the alert objects to the Set-SCOMAlert cmdlet by using the pipe operator. The Set-SCOMAlert cmdlet closes the alert by setting the resolution state to 255.

Example 2: Change the properties of alerts

PS C:\>Get-SCOMAlert -Name "Failed Accessing Windows Event Log" | Set-SCOMAlert -Owner "CONTOSO\Isabel" -CustomField1 "Root Cause - Permissions"

This command gets all alerts named "Failed Accessing Windows Event Log" and then passes the alert objects to the Set-SCOMAlert cmdlet by using the pipe operator. The Set-SCOMAlert cmdlet changes the owner of the alert and sets the value for CustomField1.

Parameters

-Alert

Specifies an array of MonitoringAlert objects. To obtain a MonitoringAlert object, use the Get-SCOMAlert cmdlet.

Parameter properties

Type:

MonitoringAlert[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-Comment

Specifies a comment to add to the resolved alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Connector

Specifies a MonitoringConnector object. This parameter specifies the connector that generated the connection string. To obtain a MonitoringConnector object, use the Get-SCOMConnector cmdlet.

Parameter properties

Type:MonitoringConnector
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField1

Specifies information to add to the CustomField1 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField10

Specifies information to add to the CustomField10 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:11
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField2

Specifies information to add to the CustomField2 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:3
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField3

Specifies information to add to the CustomField3 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:4
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField4

Specifies information to add to the CustomField4 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:5
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField5

Specifies information to add to the CustomField5 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:6
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField6

Specifies information to add to the CustomField6 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:7
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField7

Specifies information to add to the CustomField7 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:8
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField8

Specifies information to add to the CustomField8 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:9
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CustomField9

Specifies information to add to the CustomField9 property of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:10
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Owner

Specifies the user name of the owner of the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:13
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PassThru

Indicates that the cmdlet creates or modifies an object that a command can use in the pipeline. By default, this cmdlet does not generate any output.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResolutionState

Specifies a resolution state Id.

When Operations Manager generates an alert, its resolution state is New. You can change the resolution state for a new alert to Closed or to a custom resolution state that an administrator has created for the management group. The ID for New is 0 and the ID for Closed is 255. You can assign custom resolution states any value from 2 through 254.

Parameter properties

Type:Byte
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:12
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-TfsWorkItemId

The Set-SCOMAlert cmdlet changes the properties of one or more alerts. You can use the cmdlet to resolve an alert by setting the ResolutionState parameter to 255 (Closed).

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-TfsWorkItemOwner

The Set-SCOMAlert cmdlet changes the properties of one or more alerts. You can use the cmdlet to resolve an alert by setting the ResolutionState parameter to 255 (Closed).

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-TicketId

Specifies a value for the TicketId property for the alert.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:14
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.