Azure Automation Runbook执行Restart-AzWebApp时出现空引用错误求助

以下是针对该错误的排查方向和解决步骤：

1. 托管标识权限不足 #

Runbook使用的托管标识没有对目标WebApp或其所在资源组的操作权限，导致无法定位资源，触发空引用错误。

• 解决：在Azure门户中找到目标资源组或WebApp资源，进入「访问控制(IAM)」页面，为Runbook所属的托管标识添加**网站参与者（Website Contributor）或参与者（Contributor）**角色。

2. 租户/资源信息配置错误 #

Set-AzContext未正确切换到目标租户，或资源组、WebApp名称拼写错误，导致找不到对应资源，返回空对象引发错误。

• 解决：
  • 核对<secret-uuid>是否为正确的租户ID（可在Azure AD门户中查看）。
  • 确认ResourceGroupName和Name的拼写与Azure门户中的完全一致（注意区分大小写）。
  • 在Set-AzContext后添加Get-AzContext命令，输出当前上下文信息，验证是否切换成功。

3. Az模块版本过旧 #

Automation账户中的Az模块存在已知bug，旧版本可能导致空引用错误。

• 解决：
  • 进入Azure Automation账户的「模块」页面，检查Az.Websites和Az.Accounts模块的版本。
  • 将这些模块更新到最新稳定版，推荐使用Az.Websites 2.0及以上版本。

优化后的脚本（便于排查） #

可以在脚本中增加上下文验证和错误捕获，快速定位问题：

Connect-AzAccount -Identity
$context = Set-AzContext -Tenant "<secret-uuid>"
if (-not $context) {
    throw "无法设置Azure上下文"
}
Write-Output "当前上下文: 租户ID=$($context.Tenant.Id), 订阅ID=$($context.Subscription.Id)"
Write-Output "开始重启WebApp"
try {
    Restart-AzWebApp -ResourceGroupName "testconfogproxy_group" -Name "testconfogproxy" -ErrorAction Stop
    Write-Output "WebApp重启完成"
} catch {
    Write-Error "重启失败: $_"
    throw
}

内容的提问来源于stack exchange，提问作者北山硝子