Azure远程VM执行带参数PowerShell脚本失败求助

问题原因 #

使用az vm run-command invoke的--parameters参数传递值时，若直接指定脚本文件路径，参数不会自动绑定到脚本的Param块——该参数的默认行为是传递给RunPowerShellScript命令本身，而非目标脚本的参数。

解决方案 #

方案1：在--scripts中直接调用脚本并传参 #

修改Azure CLI命令，将脚本调用和参数直接整合到--scripts参数中，绕过--parameters的默认限制：

az vm run-command invoke --command-id RunPowerShellScript --name my-vm-win -g myRG --scripts "& 'C:\test.ps1' -test Peter"

方案2：适配脚本参数接收逻辑 #

保留--parameters传递方式的话，需要修改PowerShell脚本，增加参数兜底逻辑，确保能获取到传入的值：

Param(
    [string] $test
)

# 若Param未绑定到参数，从命令行参数列表中获取备用值
if (-not $test) {
    $test = $args[0]
}

Write-Output "Hello $test"

对应CLI命令可改为：

az vm run-command invoke --command-id RunPowerShellScript --name my-vm-win -g myRG --scripts "C:\test.ps1" --parameters "Peter"

或者显式映射命名参数：

az vm run-command invoke --command-id RunPowerShellScript --name my-vm-win -g myRG --scripts "C:\test.ps1 -test {test}" --parameters test=Peter

方案3：内嵌脚本内容（适合简单场景） #

如果脚本逻辑简单，直接将脚本内容嵌入--scripts，此时--parameters能正常与Param块绑定：

az vm run-command invoke --command-id RunPowerShellScript --name my-vm-win -g myRG --scripts 'Param([string] $test) Write-Output "Hello $test"' --parameters test=Peter

验证 #

执行修改后的命令后，输出的message字段应显示Hello Peter，说明参数已成功传递。

内容的提问来源于stack exchange，提问作者Nerd in Training