Add-AzureRmMetricAlertRule

Active Directory Auditing Tool

The Who, Where and When information is very important for an administrator to have complete knowledge of all activities that occur on their Active Directory. This helps them identify any desired / undesired activity happening. ADAudit Plus assists an administrator with this information in the form of reports. In real-time, ensure critical resources in the network like the Domain Controllers are audited, monitored and reported with the entire information on AD objects - Users, Groups, GPO, Computer, OU, DNS, AD Schema and Configuration changes with 200+ detailed event specific GUI reports and email alerts.

Account Management » Add-AzureRmMetricAlertRule

Add-AzureRmMetricAlertRule

Written by Titus Manohar, IT security team, ManageEngine Updated on September 2025

Syntax

Add-AzureRmMetricAlertRule

-WindowSize <TimeSpan>]

-Operator <ConditionOperator>

-Threshold<Double>

TargetResourceId <String>

-MetricName<String>

-TimeAggregationOperator <TimeAggregationOperator>

-Location <String>

[-Description <String>]

[-DisableRule]

-ResourceGroupName<String>

-Name<String>

-Action 

<System.Collections.Generic.List`1[Microsoft.Azure.Management.Insights.Models. RuleAction]>]

[-DefaultProfile <IAzureContextContainer>]

[ <CommonParameters>]

Description

The Add-AzureRmMetricAlertRule cmdlet adds or updates a metric-based alert rule. The added rule is associated with a resource group and has a name. This cmdlet implements the ShouldProcess pattern, i.e., it might request confirmation from the user before actually creating, modifying, or removing the resource.

Required parameters

-Location

Description Specifies the location where the rule is defined. 
Type String
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

-Name

Description Specifies the name of the profile.
Type String
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

-MetricName

Description Specifies the name of the metric the rule is monitoring. Specify this parameter only for metric-based rules.
Type String
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

-Operator

Description Specifies the relational operator for the condition of the rule. 
Type ConditionOperator
Paramatere sets  GreaterThan, GreaterThanOrEqual,LessThan, LessThanOrEqual
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

-ResourceGroupName

Description Specifies the name of the resource group for the rule.
Aliases ResourceGroup
Type  String
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

-TargetResourceId

Description Specifies the ID of the resource the rule is monitoring. This property cannot be updated for an existing alert rule.
Type  String
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

-Threshold

Description Specifies the threshold of the rule.
Type  Double
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

-TimeAggregationOperator

Description Specifies the aggregation operator to apply to the time window when the rule is being evaluated.
Type  TimeAggregationOperator
Parameter sets Average, Minimum, Maximum, Total, Last
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

-WindowSize

Description Specifies the time window size for the rule to compute its data.
Type  TimeSpan
Position Named
Default value None
Accept pipeline input True  (ByPropertyName)
Accept Wildcard characters False

Output

Microsoft.Azure.Commands.Insights.OutputClasses.PSAddAlertRuleOperationResponse

Explore Active Directory auditing and reporting with ADAudit Plus.

  •  
  •  
  •  
  • By clicking 'Schedule a personalized demo' you agree to processing of personal data according to the Privacy Policy.
Account Management Auditing
Active Directory Auditing
Windows Server Auditing