使用Azure PowerShell创建Premium Key Vault时访问策略配置报错排查

第一个错误：VaultName = $keyVault.Name 参数为空/无效 #

• 核心原因：变量$keyVault未正确捕获Key Vault的创建结果，或是你的Az PowerShell模块版本中，返回的Key Vault对象不存在Name属性。
• 排查与解决：
  1. 确认创建Key Vault时是否将返回值赋值给$keyVault，正确的创建命令格式应为：

     $keyVault = New-AzKeyVault -Name "你的密钥库名称" -ResourceGroupName "资源组名称" -Location "目标区域" -Sku Premium
     

     若未执行赋值操作，$keyVault为空变量，$keyVault.Name自然无有效值。
  2. 在PowerShell中执行$keyVault | Select-Object *，查看返回对象的所有属性，确认密钥库名称对应的属性名（新版本Az模块通常为Name，旧版本可能为VaultName）。

第二个错误：VaultName = $keyVault.VaultName 报"NotFound" #

• 核心原因：
  1. 属性值不匹配：$keyVault.VaultName并非实际的密钥库名称，或是Key Vault创建返回的对象属性名已变更。
  2. Azure后台同步延迟：Key Vault创建后，Azure需要几秒完成全局同步，立即执行访问策略设置可能出现资源未同步的情况。
  3. 未指定资源组：若订阅内存在同名密钥库，或是未传入-ResourceGroupName参数，PowerShell可能在错误的资源组中查找目标密钥库。
• 排查与解决：
  1. 先手动验证密钥库是否存在，执行：

     Get-AzKeyVault -Name "你的密钥库名称" -ResourceGroupName "资源组名称"
     

     若能返回结果，说明资源已存在，再继续排查其他问题。
  2. 若存在同步延迟，在创建密钥库后添加等待时间，例如：

     Start-Sleep -Seconds 10
     

     再执行Set-AzKeyVaultAccessPolicy命令。
  3. 执行Set-AzKeyVaultAccessPolicy时显式指定-ResourceGroupName参数，避免查找范围错误：

     Set-AzKeyVaultAccessPolicy -VaultName $keyVault.Name -ResourceGroupName "你的资源组名称" -UserPrincipalName "目标用户UPN" -PermissionsToKeys "Get","List"
     

  4. 检查Az模块版本，执行Get-Module Az.KeyVault查看版本，若版本过旧，建议更新模块：

     Update-Module Az.KeyVault -Force
     

额外注意事项 #

• 确保PowerShell会话已正确登录Azure（Connect-AzAccount），且切换到了目标订阅（Set-AzContext -Subscription "订阅ID/名称"）。
• 密钥库名称为全局唯一值，确认创建时的名称无拼写错误。

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