你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Add-AzMetricAlertRule

模块:: Az.Monitor Module

添加或更新基于指标的经典警报规则（已在公有云上停用）。若要创建新的指标警报规则，请使用 Add-AzMetricAlertRuleV2 cmdlet。

语法

Default （默认值）

Add-AzMetricAlertRule
    -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.Monitor.Management.Models.RuleAction]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Add-AzMetricAlertRule cmdlet 添加或更新基于指标的警报规则。添加的规则与资源组相关联，并且具有名称。此 cmdlet 实现 ShouldProcess 模式，即在实际创建、修改或删除资源之前，它可能会请求用户确认。

示例

示例 1：向网站添加指标警报规则

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup "Default-Web-EastUS" -Operator GreaterThan -Threshold 2 -WindowSize 00:05:00 -MetricName "Requests" -Description "Pura Vida" -TimeAggregationOperator Total

RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
33574ccf-0b01-43b4-aa97-87e6bbcf1c11                                                                         Created

此命令为网站创建指标警报规则。

示例 2：禁用规则

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup Default-Web-EastUS -Operator GreaterThan -Threshold 2 -WindowSize 00:05:00 -MetricName "Requests" -TimeAggregationOperator Total

RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
96c489f1-8529-46e1-a76d-2c1463ca3116                                                                                 OK

此命令禁用规则。如果该规则不存在，则会创建它已禁用。如果该规则存在，则它只是禁用它。

示例 3：添加包含操作的规则

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup "Default-Web-EastUS" -Operator GreaterThan -Threshold 1 -TargetResourceId "/subscriptions/b93fb07a-6f93-30be-bf3e-4f0deca15f4f/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/mywebsite" -MetricName "Requests" -TimeAggregationOperator Total

RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
9a5bc388-c7ac-4dc6-aa70-f4bc29c2c712                                                                                 OK

此命令为网站创建指标警报规则。

参数

-Action

指定以逗号分隔的操作列表。

参数属性

类型:	List<T>[RuleAction]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Description

指定规则的说明。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-DisableRule

禁用规则。如果未指定此参数，则会启用规则。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Location

指定定义规则的位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-MetricName

指定规则正在监视的指标的名称。仅为基于指标的规则指定此参数。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Name

指定规则的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Operator

指定规则条件的关系运算符。此参数的可接受值为：

GreaterThan
GreaterThanOrEqual
LessThan
小于或等于

参数属性

类型:	ConditionOperator
默认值:	None
接受的值:	GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ResourceGroupName

指定规则的资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	ResourceGroup

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-TargetResourceId

指定规则正在监视的资源的 ID。注意：无法为现有警报规则更新此属性。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Threshold

指定规则的阈值。

参数属性

类型:	Double
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-TimeAggregationOperator

指定要应用于计算规则的时间窗口的聚合运算符。

参数属性

类型:	Nullable<T>[TimeAggregationOperator]
默认值:	None
接受的值:	Average, Minimum, Maximum, Total, Last
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WindowSize

指定规则计算其数据的时间窗口大小。

参数属性

类型:	TimeSpan
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

Add-AzMetricAlertRule

语法

Default （默认值）

说明

示例

示例 1：向网站添加指标警报规则

示例 2：禁用规则

示例 3：添加包含操作的规则

参数

-Action

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-Description

参数属性

参数集

-DisableRule

参数属性

参数集

-Location

参数属性

参数集

-MetricName

参数属性

参数集

-Name

参数属性

参数集

-Operator

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-TargetResourceId

参数属性

参数集

-Threshold

参数属性

参数集

-TimeAggregationOperator

参数属性

参数集

-WhatIf

参数属性

参数集

-WindowSize

参数属性

参数集

CommonParameters

输入

输出

相关链接

反馈