使用Azure PowerShell创建带自定义属性的Azure警报

问题概述 #

需要批量给存储账户创建Azure指标警报，要求给操作组添加自定义Webhook属性（用于逻辑应用判断处理逻辑），但使用PowerShell脚本时出现绑定错误，且操作组与存储账户分属不同订阅。

错误原因分析 #

当前代码存在3个核心错误：

• 错误的ActionGroup对象类型：使用了New-AzActivityLogAlertActionGroupObject（用于活动日志警报），但创建指标警报需要使用New-AzActionGroupObject，两者类型不兼容，导致绑定失败。
• 多余的JSON转换：将创建的ActionGroup对象用ConvertFrom-Json转换，破坏了原本的对象类型，Add-AzMetricAlertRuleV2无法识别JSON格式的参数。
• 操作组获取不精准：Get-AzActionGroup未指定资源组，会返回当前订阅所有操作组，可能导致获取错误的目标操作组。

修正后的完整脚本 #

# 1. 切换到操作组所在订阅，精准获取目标操作组
Select-AzSubscription -SubscriptionId "<ActionGroupSubscriptionId>"
$existingActionGroup = Get-AzActionGroup -ResourceGroupName "<ActionGroupResourceGroup>" -Name "<ActionGroupName>"

# 2. 创建指标警报专用的ActionGroup对象，添加自定义Webhook属性
$alertActionGroup = New-AzActionGroupObject `
    -ActionGroupId $existingActionGroup.Id `
    -WebhookProperty @{"sampleWebhook"="Value"; "customFlag"="storageAlert"} # 按需添加自定义属性

# 3. 定义指标警报条件
$availabilityCriteria = New-AzMetricAlertRuleV2Criteria `
    -MetricName "Availability" `
    -MetricNamespace "Microsoft.Storage/storageAccounts" `
    -TimeAggregation Average `
    -Operator LessThan `
    -Threshold 100

# 4. 切换到存储账户所在订阅，获取目标存储账户
Select-AzSubscription -SubscriptionId "<StorageAccountSubscriptionId>"
$storage = Get-AzStorageAccount -ResourceGroupName "<StorageAccountResourceGroup>" -Name "<StorageAccount>"

# 5. 创建指标警报
Add-AzMetricAlertRuleV2 `
    -Name "$($storage.StorageAccountName)_availability_alert" `
    -ResourceGroupName "<StorageAccountResourceGroup>" `
    -WindowSize 00:05:00 `
    -Frequency 00:05:00 `
    -Description "存储账户可用性低于100%时触发警报" `
    -Condition $availabilityCriteria `
    -Actions $alertActionGroup `
    -Severity 2 `
    -TargetResourceId $storage.Id `
    -Enabled $true

关键修正点说明 #

• 使用匹配的Cmdlet：用New-AzActionGroupObject替代活动日志专用的New-AzActivityLogAlertActionGroupObject，确保对象类型符合指标警报的参数要求。
• 移除无效转换：直接使用New-AzActionGroupObject返回的原生对象，不需要额外的JSON转换操作。
• 精准定位操作组：通过-ResourceGroupName和-Name指定目标操作组，避免跨订阅场景下获取错误资源。
• 跨订阅兼容处理：操作组的ID是完整的Azure资源标识符（包含订阅、资源组信息），即使存储账户在其他订阅，也可直接引用该ID，无需额外配置。

内容的提问来源于stack exchange，提问作者Shushud