Azure DevOps Pipeline任务报错：Invoke-AzureRmVMRunCommand路径未找到

我之前帮团队排查过一模一样的问题，核心误区就是没搞清楚ScriptPath参数的路径指向——它不是你本地机器的路径，也不是Azure DevOps代理服务器的路径，而是目标Windows虚拟机本地的文件路径！

为什么会报错？ #

Invoke-AzureRmVMRunCommand是通过Azure服务远程触发目标VM执行命令，这个cmdlet会去VM本地找你指定的ScriptPath文件。如果脚本还没传到VM上，自然会提示路径不存在。

正确的解决步骤（Azure DevOps管道场景） #

1. 先把脚本传到目标VM

在你的Azure PowerShell任务之前，添加一个Azure文件复制任务，或者用PowerShell任务调用Copy-AzFile cmdlet，把DevOps管道里的脚本复制到VM的某个可访问目录（比如C:\temp）。

示例Copy-AzFile命令：

Copy-AzFile -ResourceGroupName 'rgname' -VMName 'vmname' -LocalPath '$(System.DefaultWorkingDirectory)/your-script.ps1' -RemotePath 'C:\temp'

这里$(System.DefaultWorkingDirectory)是DevOps代理机器上存放你流水线工件的路径，根据实际情况调整。

2. 调用Invoke-AzureRmVMRunCommand时使用VM本地路径

脚本传过去之后，ScriptPath就填VM上的绝对路径：

Invoke-AzureRmVMRunCommand -ResourceGroupName 'rgname' -Name 'vmname' -CommandId 'RunPowerShellScript' -ScriptPath 'C:\temp\your-script.ps1' -Parameter @{"arg1" = "var1";"arg2" = "var2"}

更便捷的替代方案：直接传脚本内容 #

如果你的脚本比较简短，不想额外做文件复制步骤，可以用-ScriptString参数直接把脚本内容传递过去，完全不用依赖VM上的文件：

$scriptContent = @"
param(`$arg1, `$arg2)
# 这里写你的脚本逻辑
Write-Host "Received arguments: `$arg1, `$arg2"
"@

Invoke-AzureRmVMRunCommand -ResourceGroupName 'rgname' -Name 'vmname' -CommandId 'RunPowerShellScript' -ScriptString $scriptContent -Parameter @{"arg1" = "var1";"arg2" = "var2"}

额外提醒 #

• 建议升级到Invoke-AzVMRunCommand（AzureRm模块已被弃用），用法和AzureRm版本几乎一致，但支持最新的Azure功能。
• 确保目标VM的网络安全组（NSG）允许Azure运行命令的访问（默认规则是允许的，若有自定义规则需检查）。

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