New-RedgateMonitorAlertSpecificSettings
Published 18 April 2024
Creates new Alert specific settings object for the given AlertType.
Syntax
New-RedgateMonitorAlertSpecificSettings [-AlertType] <int> [[-MonitoredObjectType] <string>] [[-DatabaseEngine] <MonitoredDatabaseEngine>] [<CommonParameters>]
Description
Creates new Alert specific settings object for the given AlertType, suitable for use with Update-RedgateMonitorAlertSpecificSettings.
Parameters
-AlertType
<Int32>
The id of the alert type. Predefined ids are accessible through global alert type variables, $AlertType, $AgAlertTypes, $AzureSqlDatabaseAlertTypes, $AzureSqlServerAlertTypes, $ClusterAlertTypes, $ClusterMachineAlertTypes, $DatabaseAlertTypes, $DiskAlertTypes, $ElasticPoolAlertTypes, $InstanceAlertTypes, $JobAlertTypes and $StandaloneMachineAlertTypes.
| Aliases | None |
| Required? | true |
| Position? | 1 |
| Default Value | 0 |
| Accept Pipeline Input | False |
| Accept Wildcard Characters | false |
-MonitoredObjectType
<String>
Deprecated. Use -DatabaseEngine Postgres instead of "PostgresInstance". Other values have no effect.
| Aliases | None |
| Required? | false |
| Position? | 2 |
| Default Value | None |
| Accept Pipeline Input | False |
| Accept Wildcard Characters | false |
-DatabaseEngine
<MonitoredDatabaseEngine>
The database engine to create settings for, for alert types that have separate settings per engine. Without it, the settings are for SQL Server, or for PostgreSQL when -MonitoredObjectType is "PostgresInstance".
| Aliases | None |
| Required? | false |
| Position? | 3 |
| Default Value | None |
| Accept Pipeline Input | False |
| Accept Wildcard Characters | false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable, and -ProgressAction. For more information, see http://technet.microsoft.com/en-us/library/hh847884.aspx.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
-
None.
You cannot pipe input to this cmdlet.
Return values
The output type is the type of the objects that the cmdlet emits.
-
[AlertSpecificSettings] A custom sub-type of AlertSpecificSettings that's appropriate to the specified AlertType.
Examples
-------------------------- EXAMPLE 1 --------------------------
New-RedgateMonitorAlertSpecificSettings $AlertTypes.HighCpu
-------------------------- EXAMPLE 2 --------------------------
New-RedgateMonitorAlertSpecificSettings -AlertType $AlertTypes.LongRunningQuery -DatabaseEngine MySql
This documentation contains proprietary information and is protected by copyright law.
Copyright © 2026 Red Gate Software Limited. All rights reserved
