Azure Bicep部署Linux VM遇AADSSHLoginForLinux扩展问题求助

针对你用Azure Bicep部署带AADSSHLoginForLinux扩展的Linux VM时遇到的问题，可按以下步骤排查：

• 确认Microsoft.Azure.ActiveDirectory资源提供程序已注册：
  很多人会忽略这个，只注册了Microsoft.Compute。执行命令检查状态：

  az provider show --namespace Microsoft.Azure.ActiveDirectory --query "registrationState"
  

  若返回不是Registered，运行注册命令：

  az provider register --namespace Microsoft.Azure.ActiveDirectory
  

  注册可能需要几分钟，等待状态更新后再重试部署。

• 核对Bicep扩展配置细节：
  确保扩展的核心参数完全正确，示例正确配置如下：

  resource vmAadExtension 'Microsoft.Compute/virtualMachines/extensions@2023-09-01' = {
    name: 'AADSSHLoginForLinux'
    parent: linuxVm
    properties: {
      publisher: 'Microsoft.Azure.ActiveDirectory'
      type: 'AADSSHLoginForLinux'
      typeHandlerVersion: '1.0'
      autoUpgradeMinorVersion: true
      settings: {}
    }
  }
  

  注意typeHandlerVersion需使用官方支持的版本，避免使用未兼容的新版。

• 验证VM操作系统兼容性：
  AADSSHLoginForLinux仅支持特定Linux发行版，比如Ubuntu 18.04 LTS及以上、CentOS 7.9/8.x、RHEL 7.9/8.x等。如果你的VM镜像不在支持列表内，扩展会安装失败。

• 检查部署账户权限：
  部署账户需要具备Virtual Machine Contributor权限以管理VM，同时需要Azure AD Domain Services Contributor或等效权限来完成AAD相关的扩展配置。

• 查看详细错误日志：
  登录Azure门户，找到失败的部署记录，查看具体错误代码和描述。常见错误包括扩展安装超时（需检查VM网络连通性）、AAD权限不足、镜像不兼容等，这些细节能快速定位问题。

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