使用Bicep部署Azure自动化账户模块失败，求排查原因

可能的原因及对应解决方案： #

1. PowerShell运行时版本不兼容 #

Azure自动化账户默认可能使用PowerShell 5.1，而新版Microsoft Graph模块仅支持PowerShell 7.x及以上版本，直接部署会因版本不匹配失败。

• 解决：
  • 在Azure门户的自动化账户中，进入「运行时环境」切换到PowerShell 7.1版本；
  • 在Bicep中指定兼容的模块版本，例如指定具体版本的包URL：

    contentLink: {
      uri: 'https://www.powershellgallery.com/api/v2/package/Microsoft.Graph.Authentication/2.0.1'
    }
    

2. 模块依赖未按顺序部署 #

Microsoft Graph模块存在依赖关系（如Microsoft.Graph.Authentication是其他模块的基础），并行部署所有模块会导致依赖未就绪就开始安装，引发失败。

• 解决：
  • 在Bicep中通过dependsOn控制部署顺序，先部署认证模块，再部署其他模块：

    resource automationResource 'Microsoft.Automation/automationAccounts@2022-08-08' = {
      name: 'your-automation-account'
      location: resourceGroup().location
      properties: {
        sku: {
          name: 'Basic'
        }
      }
    
      resource authModule 'modules' = {
        name: 'Microsoft.Graph.Authentication'
        properties: {
          contentLink: {
            uri: 'https://www.powershellgallery.com/api/v2/'
          }
        }
      }
    
      resource otherModules 'modules' = [for module in ['Microsoft.Graph.Groups', 'Microsoft.Graph.Mail', 'Microsoft.Graph.Planner', 'Microsoft.Graph.Teams', 'Microsoft.Graph.Users', 'Microsoft.Graph.Users.Actions']: {
        name: module
        properties: {
          contentLink: {
            uri: 'https://www.powershellgallery.com/api/v2/'
          }
        }
        dependsOn: [authModule]
      }]
    }
    

3. 网络访问限制 #

如果自动化账户配置了虚拟网络集成或专用链接，可能无法访问PowerShell Gallery的API地址，导致模块下载失败。

• 解决：
  • 若使用VNet集成，确保出站规则允许访问www.powershellgallery.com；
  • 若使用专用链接，为PowerShell Gallery配置专用端点；
  • 手动下载模块包上传至Azure存储账户，修改contentLink指向存储中的模块包地址。

4. 模块名称或权限问题 #

• 确认PowerShell Gallery中模块名称的准确性，避免拼写错误；
• 检查部署账户的权限，确保拥有Microsoft.Automation/automationAccounts/modules/write权限（如分配自动化账户参与者角色）。

内容的提问来源于stack exchange，提问作者H. Pauwelyn