Azure Bicep中runCommands资源参数使用问题求助

问题根源 #

你在脚本中使用的${master}这类格式是Bicep的变量语法，但VM Run Command的脚本是在虚拟机内部执行的，Bicep不会解析脚本内的占位符，因此这种引用方式完全无效。

正确参数引用方式 #

Run Command定义的parameters和protectedParameters会作为位置参数传递给脚本，顺序为parameters列表在前，protectedParameters列表在后。你有两种引用方式：

1. 通过位置参数数组$args引用
   直接按参数定义顺序使用$args[0]、$args[1]等，比如：

   New-Item -Path C:\AzureData\ -Name "$($args[1]).txt" -ItemType File -Value "$($args[2]),$($args[0]),$($args[3])"
   

2. 显式声明参数后按名称引用
   在脚本开头定义参数列表，之后直接用参数名引用，可读性更强：

   param(
       [string]$master,
       [string]$user,
       [string]$domain,
       [string]$password
   )
   New-Item -Path C:\AzureData\ -Name "$user.txt" -ItemType File -Value "$domain,$master,$password"
   

修改后的完整Bicep代码 #

resource ps2 'Microsoft.Compute/virtualMachines/runCommands@2022-11-01' = {
  parent: vm
  name: 'WithProtectedParameters'
  location: location
  properties: {
    parameters: [
      {
        name: 'master'
        value: '10.10.10.10'
      }
      {
        name: 'user'
        value: 'thomas'
      }
      {
        name: 'domain'
        value: 'company'
      }
    ]
    protectedParameters: [
      {
        name: 'password'
        value: dmaPassword // 来自Key Vault
      }
    ]
    runAsPassword: adminPassword
    runAsUser: adminUsername
    source: {
      script: '''
        param(
            [string]$master,
            [string]$user,
            [string]$domain,
            [string]$password
        )
        New-Item -Path C:\AzureData\ -Name "$user.txt" -ItemType File -Value "$domain,$master,$password"
      '''
    }
  }
}

额外注意事项 #

• 三重单引号包裹的脚本可直接使用双引号，无需转义（如"$user.txt"），Bicep会原样传递给虚拟机执行。
• protectedParameters中的敏感参数会被Azure加密存储，不会出现在部署日志或执行记录中，适合传递密码、密钥等信息。
• 确保runAsUser拥有执行脚本所需的权限（比如创建文件需要目标目录的写入权限）。

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