Set-SCOMAlert
[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"