在VSCode中用Bicep模板执行runCommand@2024-07-01时遇无效URL错误

通过Bicep部署Windows虚拟机，需完成三个流程：安装IIS、从公开代码仓库下载代码、重启机器。目前DSC扩展可完成前两步，但执行RunCommand时持续返回"Invalid Url"（错误请求），即使将命令改为简单的输出语句也无法解决。

错误原因分析 #

问题出在RunCommand的资源定义上：

• Windows虚拟机的RunCommand需明确指定执行环境为PowerShell，未指定commandId会导致解析错误
• API要求内联脚本内容需以数组形式传递，而非单一字符串
• 资源类型名称应为复数形式runCommands，而非单数runCommand

修正后的Bicep代码 #

@description('虚拟机名称')
param vmName string = 'vm1'
param location string = resourceGroup().location
@description('虚拟机大小')
param vmSize string = 'Standard_D2s_v3'
param adminUsername string = 'adminUser'
param adminPassword string = 'some-secret-password'
param vNetName string ='vnet1'
param subnetName string='subnet1'
param nsgName string='nsg1'
var nicName = '${vmName}-nic'
resource nsg 'Microsoft.Network/networkSecurityGroups@2024-03-01' existing = {
  name: nsgName
}

resource nic 'Microsoft.Network/networkInterfaces@2022-05-01' = {
  name: nicName
  location: location
  properties: {
    ipConfigurations: [
      {
        name: 'ipconfig1'
        properties: {
          privateIPAllocationMethod: 'Dynamic'
          subnet: {
            id: resourceId('Microsoft.Network/virtualNetworks/subnets', vNetName, subnetName)
          }
        }
      }
    ]
    networkSecurityGroup:{
      id: nsg.id
    }
  }
}

resource vm 'Microsoft.Compute/virtualMachines@2022-03-01' = {
  name: vmName
  location: location
  properties: {
    hardwareProfile: {
      vmSize: vmSize
    }
    osProfile: {
      computerName: vmName
      adminUsername: adminUsername
      adminPassword: adminPassword
    }
    storageProfile: {
      imageReference: {
        publisher: 'MicrosoftWindowsServer'
        offer: 'WindowsServer'
        sku: '2019-Datacenter'
        version: 'latest'
      }
      osDisk: {
        createOption: 'FromImage'
        managedDisk: {
          storageAccountType: 'Standard_LRS'
        }
      }
    }
    networkProfile: {
      networkInterfaces: [
        {
          id: nic.id
        }
      ]
    }
  }
}

resource vmExtension 'Microsoft.Compute/virtualMachines/extensions@2022-03-01' = {
  parent: vm
  name: 'IIS'
  location: location
  properties: {
    publisher: 'Microsoft.Powershell'
    type: 'DSC'
    typeHandlerVersion: '2.9'
    autoUpgradeMinorVersion: true
    settings: {
      configuration: {
        url: 'https://raw.githubusercontent.com/Azure/azure-quickstart-templates/refs/heads/master/demos/vmss-windows-webapp-dsc-autoscale/DSC/InstallIIS.zip'
        script: 'InstallIIS.ps1'
        function: 'InstallIIS'
      }
      configurationArguments: {
        nodeName: 'localhost'
        WebDeployPackagePath: 'https://raw.githubusercontent.com/Azure/azure-quickstart-templates/refs/heads/master/demos/vmss-windows-webapp-dsc-autoscale/WebDeploy/DefaultASPWebApp.v1.0.zip'
      }
    }
  }
}

// 修正后的RunCommand资源
resource rebootCommand 'Microsoft.Compute/virtualMachines/runCommands@2024-07-01' = {
  parent: vm
  name: 'reboot'
  location: location
  properties: {
    asyncExecution: false
    commandId: 'RunPowerShellScript' // 指定Windows环境的PowerShell执行模式
    source: {
      script: [ // 脚本内容以数组形式传递
        'Write-Host "Hello World"'
        'Restart-Computer -Force' // 执行虚拟机重启
      ]
    }
  }
}

关键修正点 #

1. 资源类型改为复数runCommands，匹配Azure API规范
2. 添加commandId: 'RunPowerShellScript'，明确指定Windows环境下的脚本执行引擎
3. 将脚本内容从字符串改为数组，符合API参数格式要求
4. 使用PowerShell原生命令替换cmd语法，确保Windows环境兼容

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