New-SCSMAlertRule
Creates an alert rule to be used with an Operations Manager Alert connector in Service Manager.
Parameter Set: Class
New-SCSMAlertRule [-Name] <String> -Class <String> -Operator <CompareOperator> -Template <ManagementPackObjectTemplate> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-Priority <Priority> ] [-SCSession <Connection[]> ] [-Severity <Severity> ] [ <CommonParameters>]
Parameter Set: Computer
New-SCSMAlertRule [-Name] <String> -Group <String> -Template <ManagementPackObjectTemplate> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-Priority <Priority> ] [-SCSession <Connection[]> ] [-Severity <Severity> ] [ <CommonParameters>]
Parameter Set: Custom
New-SCSMAlertRule [-Name] <String> -Template <ManagementPackObjectTemplate> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-CustomField1 <String> ] [-CustomField10 <String> ] [-CustomField2 <String> ] [-CustomField3 <String> ] [-CustomField4 <String> ] [-CustomField5 <String> ] [-CustomField6 <String> ] [-CustomField7 <String> ] [-CustomField8 <String> ] [-CustomField9 <String> ] [-CustomOperator1 <Nullable`1> ] [-CustomOperator10 <Nullable`1> ] [-CustomOperator2 <Nullable`1> ] [-CustomOperator3 <Nullable`1> ] [-CustomOperator4 <Nullable`1> ] [-CustomOperator5 <Nullable`1> ] [-CustomOperator6 <Nullable`1> ] [-CustomOperator7 <Nullable`1> ] [-CustomOperator8 <Nullable`1> ] [-CustomOperator9 <Nullable`1> ] [-Priority <Priority> ] [-SCSession <Connection[]> ] [-Severity <Severity> ] [ <CommonParameters>]
Parameter Set: ManagementPack
New-SCSMAlertRule [-Name] <String> -ManagementPack <String> -Operator <CompareOperator> -Template <ManagementPackObjectTemplate> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-Priority <Priority> ] [-SCSession <Connection[]> ] [-Severity <Severity> ] [ <CommonParameters>]
Parameter Set: NoCriteria
New-SCSMAlertRule [-Name] <String> -NoCriteria -Template <ManagementPackObjectTemplate> [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-Priority <Priority> ] [-SCSession <Connection[]> ] [-Severity <Severity> ] [ <CommonParameters>]
The New-SCSMAlertRule cmdlet creates an alert rule to use with an Operations Manager Alert connector in Service Manager.
Specifies an instance of the monitoring class for which the alert was raised.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the name of the computer on which the System Center Data Access service runs. The user account that is specified in the Credential parameter must have access rights to the specified computer.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
Specifies the credentials that this cmdlet uses to connect to the server on which the System Center Data Access service runs. The specified user account must have access rights to that server.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField1. If you specify a value for this parameter, then you must also specify a value for the CustomOperator1 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField2. If you specify a value for this parameter, then you must also specify a value for the CustomOperator2 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField3. If you specify a value for this parameter, then you must also specify a value for the CustomOperator3 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField4. If you specify a value for this parameter, then you must also specify a value for the CustomOperator4 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField5. If you specify a value for this parameter, then you must also specify a value for the CustomOperator5 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField6. If you specify a value for this parameter, then you must also specify a value for the CustomOperator6 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField7. If you specify a value for this parameter, then you must also specify a value for the CustomOperator7 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField8. If you specify a value for this parameter, then you must also specify a value for the CustomOperator8 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField9. If you specify a value for this parameter, then you must also specify a value for the CustomOperator9 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the value for CustomField10. If you specify a value for this parameter, then you must also specify a value for the CustomOperator10 parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField1. If you specify this parameter, then you must also specify a value in the CustomField1 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField10. If you specify this parameter, then you must also specify a value in the CustomField10 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField2. If you specify this parameter, then you must also specify the CustomField2 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField3. If you specify this parameter, then you must also specify the CustomField3 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField4. If you specify this parameter, then you must also specify the CustomField4 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField5. If you specify this parameter, then you must also specify the CustomField5 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField6. If you specify this parameter, then you must also specify the CustomField6 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField7. If you specify this parameter, then you must also specify the CustomField7 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField8. If you specify this parameter, then you must also specify the CustomField8 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the operator to apply to CustomField9. If you specify this parameter, then you must also specify the CustomField9 parameter. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the name of the group that contains the computers to be associated with the alert rule.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the list of management packs.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the name of the alert rule.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Indicates that this cmdlet configures the alert rule to have no criteria.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the comparison operator to use in the alert rule. Valid values are:
-- Equals
-- Contains
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the priority of the alert rule. Valid values are:
-- Low
-- Medium
-- High
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies an object that represents the session to a Service Manager management server.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
Specifies the severity of the alert rule. Valid values are:
-- Low
-- Medium
-- High
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
Specifies the template to apply to the rule.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
The input type is the type of the objects that you can pipe to the cmdlet.
None.
You cannot pipe input to this cmdlet.
The output type is the type of the objects that the cmdlet emits.
- None.
- This cmdlet does not generate any output.
The first command gets a template that matches the specified string by using the Get-SCSMObjectTemplate cmdlet. The command stores the result in the $Template variable.
The second command gets a management pack named System.Library by using the Get-SCSMManagementPack cmdlet. The command stores the result in the $ManagementPack variable.
The final command creates an alert rule for an Operations Manager Alert connector.
PS C:\>$Template = Get-SCSMObjectTemplate -Name ".*IncidentTemplate.*"
PS C:\> $ManagementPack = Get-SCManagementPack -Name "System.Library"
PS C:\> $Rule = New-SCSMAlertRule -Name "AlertRule22" -ManagementPack -Template $Template