Azure PowerShell脚本Invoke-AzVMRunCommand遍历VM时vm_names参数报错

1. 修正脚本参数定义语法 #

确保参数定义为数组类型，明确设置非必填并赋予正确的数组默认值，避免Mandatory属性误设为$true：

param(
    [Parameter(Mandatory=$false)]
    [string[]]$vm_names = @("test-na01-vm004", "test-na01-vm005")
)

# 遍历执行远程命令
foreach ($vm in $vm_names) {
    Write-Host "Executing command on VM: $vm"
    Invoke-AzVMRunCommand -ResourceGroupName "你的资源组名称" -VMName $vm -CommandId 'RunPowerShellScript' -ScriptPath ".\你的远程脚本.ps1"
}

2. 流水线任务中传递参数的正确格式 #

如果需要动态指定VM列表而非依赖默认值，需注意参数传递格式：

• 直接在Azure PowerShell任务的脚本参数框中传入数组：

  -vm_names @("test-na01-vm004", "test-na01-vm005")
  

• 若使用流水线变量（如变量VM_LIST值为test-na01-vm004,test-na01-vm005），需在脚本中转换为数组：

  param(
      [Parameter(Mandatory=$false)]
      [string]$vm_names = "test-na01-vm004,test-na01-vm005"
  )
  
  # 将逗号分隔字符串转为数组
  $vmArray = $vm_names -split "," | ForEach-Object { $_.Trim() }
  
  foreach ($vm in $vmArray) {
      Invoke-AzVMRunCommand -ResourceGroupName "你的资源组名称" -VMName $vm -CommandId 'RunPowerShellScript' -ScriptPath ".\你的远程脚本.ps1"
  }
  

3. 添加调试输出排查参数接收情况 #

在脚本开头添加调试代码，确认参数是否被正确接收：

param(
    [Parameter(Mandatory=$false)]
    [string[]]$vm_names = @("test-na01-vm004", "test-na01-vm005")
)

# 调试输出参数信息
Write-Host "Received VM list: $($vm_names -join ', ')"
Write-Host "Parameter type: $($vm_names.GetType().Name)"

foreach ($vm in $vm_names) {
    Invoke-AzVMRunCommand -ResourceGroupName "你的资源组名称" -VMName $vm -CommandId 'RunPowerShellScript' -ScriptPath ".\你的远程脚本.ps1"
}

通过流水线日志查看输出，确认参数是否为空、类型是否正确。

4. 确保PowerShell版本兼容性 #

在Azure PowerShell任务的版本选项中选择PowerShell 7.x版本，避免旧版本PowerShell对数组参数解析的兼容性问题。

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