使用Invoke-AzureRmVMRunCommand与Azure API执行VM脚本遇报错求助

你提到尝试用Invoke-AzureRmVMRunCommand和Azure API调用执行Get-Service DHCP脚本（存为test.ps1），遇到了两个典型错误，结合你已经做的重启VM、换VM、换机器排查，我给你针对性的解决方案：

一、Invoke-AzureRmVMRunCommand返回404：资源组下虚拟机未找到 #

这个错误大概率是资源标识不匹配、模块过时或权限/状态问题，按以下步骤排查：

• 核对资源组和VM名称的准确性：Azure资源名称虽然大小写不敏感，但拼写错误（比如多空格、少字母）是常见坑。先通过命令确认目标VM确实存在：

  Get-AzVM -ResourceGroupName "你的资源组名称"
  

  （如果还在用AzureRM模块，换成Get-AzureRmVMRunCommand，但更建议直接迁移到Az模块，下文会说明）

• 升级到Az模块，替代过时的AzureRM：AzureRM已经停止维护，旧版本模块可能和Azure新API不兼容，导致资源识别错误。执行以下命令迁移：

  # 安装Az模块（允许覆盖现有模块）
  Install-Module -Name Az -AllowClobber -Scope CurrentUser -Force
  # 切换到Az上下文
  Connect-AzAccount
  # 用Az模块的命令替代原操作：
  Invoke-AzVMRunCommand -ResourceGroupName "你的资源组" -VMName "你的VM名称" -CommandId "RunPowerShellScript" -ScriptPath ".\test.ps1"
  

• 验证账号权限：当前登录的Azure账号必须拥有目标VM的Virtual Machine Contributor或更高权限（比如Owner）。可以用命令检查：

  Get-AzRoleAssignment -SignInName "你的登录邮箱" -ResourceGroupName "你的资源组" -ResourceName "你的VM名称" -ResourceType Microsoft.Compute/virtualMachines
  

  如果没有对应权限，需要让管理员给你分配角色。

• 确认VM处于运行状态：只有Running状态的VM才能执行Run Command，用以下命令检查状态：

  Get-AzVM -ResourceGroupName "你的资源组" -Name "你的VM名称" -Status | Select-Object -ExpandProperty Statuses
  

  如果VM是Stopped/Deallocated状态，先启动它。

二、Azure API调用返回Conflict：Run Command扩展执行中 #

这个错误是Azure的保护机制：同一虚拟机上不能并行执行Run Command操作，解决思路是等待或终止现有操作，再发起新调用：

• 查看并等待现有操作完成：你可以通过Azure Portal进入VM的「运行命令」页面，查看历史操作的状态；也可以用PowerShell查询：

  # 获取最近的Run Command操作
  $latestCommand = Get-AzVMRunCommand -ResourceGroupName "你的资源组" -VMName "你的VM名称" | Sort-Object TimeCreated -Descending | Select-Object -First 1
  # 查看操作状态
  $latestCommand.Status
  

  如果状态是Running，等待5-10分钟（简单脚本一般很快完成），再重试调用。

• 终止卡住的操作：如果某个Run Command操作长时间卡住（超过15分钟），可以手动终止：

  Remove-AzVMRunCommand -ResourceGroupName "你的资源组" -VMName "你的VM名称" -CommandId $latestCommand.Id -Force
  

  或者在Azure Portal的「运行命令」历史里，找到卡住的操作，点击「终止」。

• 在脚本中加入状态检查逻辑：如果是自动化调用，建议先检查是否有正在运行的操作，再执行新命令，比如：

  # 发起Run Command并作为后台作业
  $job = Invoke-AzVMRunCommand -ResourceGroupName "你的资源组" -VMName "你的VM名称" -CommandId "RunPowerShellScript" -ScriptPath ".\test.ps1" -AsJob
  # 循环等待作业完成
  while ($job.State -eq "Running") {
      Write-Host "等待操作完成..."
      Start-Sleep -Seconds 30
      $job = Get-Job -Id $job.Id
  }
  # 获取执行结果
  $result = $job | Receive-Job
  Write-Output $result.Value[0].Message
  

• 重置Run Command扩展：如果扩展本身异常，导致操作一直卡住，可以重新安装扩展：

  Set-AzVMExtension -ResourceGroupName "你的资源组" -VMName "你的VM名称" -Name "RunCommandWindows" -Publisher "Microsoft.CPlat.Core" -Type "RunCommandWindows" -TypeHandlerVersion "1.10" -ForceRerun $true
  

通用排查补充建议 #

除了上面的针对性方案，你还可以做这些验证：

1. 直接在VM本地执行Get-Service DHCP，确认脚本本身没有问题（比如权限不足、服务名称错误）；
2. 检查VM的网络：确保VM能和Azure管理平面通信（不需要公网，但要允许Azure服务访问VM的出站流量）；
3. 查看VM本地的Run Command日志：日志路径是C:\WindowsAzure\Logs\Plugins\Microsoft.CPlat.Core.RunCommandWindows\，里面的日志文件能帮你定位脚本执行的具体错误。

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