Set-SCOMAlert

Article
12/08/2011

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Set-SCOMAlert

Changes the properties of the specified alert.

Syntax

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

Detailed Description

The Set-SCOMAlert cmdlet changes the properties of the specified alert.

Parameters

-Alert<MonitoringAlert>

Specifies one or more alert objects. Enter a variable that represents the alerts, or type a command that gets the alerts. For information about how to get an alert object, type Get-Help Get-SCOMAlert.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Connector<MonitoringConnector>

Specifies a monitoring connector object. Enter a variable that represents the connector, or type a command that gets the connector.

For information about how to get a connector object, type Get-Help Get-SCOMConnector.

Aliases	none
Required?	false
Position?	2
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField1<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	3
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField10<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	4
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField2<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	5
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField3<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	6
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField4<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	7
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField5<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	8
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField6<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	9
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField7<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	10
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField8<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	11
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-CustomField9<String>

Specifies a custom field property on an alert object.

Aliases	none
Required?	false
Position?	12
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Owner<String>

Specifies a value for the Owner property for the alert.

Aliases	none
Required?	false
Position?	13
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-ResolutionState<Byte>

Specifies a resolution state Id. For example, the resolution state Id for "Closed" is 255.

Aliases	none
Required?	false
Position?	14
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-TicketId<String>

Specifies a value for the TicketId property for the alert.

Aliases	none
Required?	false
Position?	15
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before executing the command.

Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?	false
Position?	named
Default Value	none
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

Examples

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

This command gets all alerts with a resolution state of 15 and then uses the pipeline operator (|) to pass the alert objects to the Set-SCOMAlert cmdlet which closes the alert by setting the resolution state to 255.

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

-------------------------- EXAMPLE 2 --------------------------

Description

-----------

This command gets all alerts named "Failed Accessing Windows Event Log" and then uses the pipeline operator to pass the alert objects to the Set-SCOMAlert cmdlet which changes the owner and sets the value for CustomField1.

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

Get-SCOMConnector