Get-AzAutomationCredential在PowerShell ISE可用但Runbook中报空引用错误

• 身份上下文缺失：本地PowerShell ISE运行时使用的是个人登录Az的有效身份上下文，默认拥有对应资源的操作权限；但Azure Runbook运行环境不会自动完成Az身份认证，未做显式登录的情况下调用Az类cmdlet不会返回明确的认证错误，只会返回空值，后续访问对象属性时直接触发空引用报错。
• 运行身份权限不足：即使完成了Runbook的身份登录，如果使用的托管标识/运行账号没有被授予目标自动化账户下凭据的读取权限，Get-AzAutomationCredential 调用会返回$null，不会抛出明确的权限不足提示。
• Az模块版本不兼容：本地ISE安装的Az.Automation模块版本与自动化账户中加载的模块版本差异过大时，会出现cmdlet执行逻辑异常、返回值结构不匹配的问题，导致结果为空。
• 参数拼写误差：资源组名、自动化账户名、凭据名存在多余空格、拼写错误时，查询不到对应资源也会返回空值。

按以下顺序排查处理即可：

1. 在Runbook最开头补充标准Az身份认证逻辑，不要直接调用资源操作cmdlet：

   # 关闭上下文自动保存，避免多Runbook并发时上下文混乱
   Disable-AzContextAutosave -Scope Process | Out-Null
   # 使用自动化账户托管标识完成登录
   Connect-AzAccount -Identity | Out-Null
   # 若自动化账户跨订阅存在，显式指定当前操作的订阅ID
   # Set-AzContext -SubscriptionId "替换为你的实际订阅ID" | Out-Null
   

2. 配置运行身份权限：进入目标自动化账户的访问控制（IAM）页面，给Runbook使用的系统/用户托管标识分配自动化凭据读取者或自动化账户参与者角色，权限生效等待3-5分钟后再做测试。
3. 对齐模块版本：进入自动化账户的模块管理页面，检查Az.Automation模块版本，和本地ISE中正常运行的模块大版本保持一致；如果版本过旧，更新Az模块到稳定版本，等待模块同步完成后再测试。
4. 增加空值容错逻辑，方便快速定位问题：

   $autoCredential = Get-AzAutomationCredential -ResourceGroupName "ResourceGroup" -AutomationAccountName "automationaccount" -Name "accountName"
   if (-not $autoCredential) {
       throw "凭据查询返回空，请检查参数拼写、身份权限、模块版本配置"
   }
   $User = $autoCredential.UserName
   

5. 核对传入的三个参数：资源组名、自动化账户名、凭据名，确认不存在多余空格、拼写错误，和凭据面板中存储的信息完全一致。

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