Set-AlertDestination
Set-AlertDestination
Sets the Operations Manager Connector Framework connector to which the specified alert will be forwarded.
Syntax
Parameter Set: FromAlert
Set-AlertDestination [-Alert] <MonitoringAlert[]> [-Connector] <MonitoringConnector> [[-Comment] <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
Sets the Operations Manager Connector Framework connector to which the specified alert will be forwarded.
Parameters
-Alert<MonitoringAlert[]>
Specifies monitoring alerts. You can use the Get-Alert cmdlet to retrieve objects to pass as values of this parameter. To enter multiple values, separate them by using commas.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Comment<String>
Specifies a comment to associate with the alert destination.
Aliases |
none |
Required? |
false |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Connector<MonitoringConnector>
Specifies the monitoring connector.
Aliases |
none |
Required? |
true |
Position? |
2 |
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
Notes
- For more information, type "Get-Help Set-AlertDestination -detailed". For technical information, type "Get-Help Set-AlertDestination -full".
When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".
Examples
-------------- EXAMPLE 1 --------------
This command uses Get-Connector along with Where-Object to retrieve a connector that includes myconn in its name. It stores the result in the $destination variable. It then uses Get-Alert to retrieve alerts and passes the results to Where-Object to filter them for alerts that include SDK in their name. The alerts that make it through the filter are passed to Set-AlertDestination which updates the alert destination for each alert to the connector stored in $destination.
C:\PS>$destination = get-connector | where-object {$_.name -match "myconn"}
get-alert | where-object {$_.name -match "SDK"} |
set-alertdestination -connector $destination