为何输入VMID无法解析到单个Hyper-V虚拟机？PowerShell报错排查

我来帮你分析这个问题的原因和解决办法，毕竟我也踩过类似的坑：

为什么会出现这个错误？ #

这个报错本质是New-PSSession接收到的VMID参数无法对应到唯一的一台虚拟机，常见的两个原因：

1. Get-VM返回了多个虚拟机对象
   虽然你指定了-VMName，但Hyper-V服务器上可能存在同名的虚拟机（比如集群环境下的残留实例、或者之前测试创建的同名VM没删掉）。这时候(Get-VM ...).ID会返回一个GUID数组，而New-PSSession -VMId只接受单个GUID，传入数组就会触发这个错误。

2. New-PSSession -VMId的作用范围限制
   这个参数是专门针对本地Hyper-V主机的虚拟机设计的。如果你的VM在远程服务器上，直接在本地执行New-PSSession -VMId $VMID是找不到目标VM的——本地主机根本没有这个ID的虚拟机，自然无法解析到单个实例。

对应的解决方法 #

方法1：确保Get-VM只返回单个VM实例

先排查是否存在重名VM，再筛选出唯一的目标VM：

# 先验证返回的VM数量
$targetVMs = Get-VM -ComputerName $HyperVServerName -Name $VMName
Write-Host "找到的同名VM数量：$($targetVMs.Count)"

if ($targetVMs.Count -gt 1) {
    # 按状态筛选，只取正在运行的那个（或者你需要的其他属性）
    $targetVM = $targetVMs | Where-Object { $_.State -eq 'Running' }
    $VMID = $targetVM.ID
} else {
    $VMID = $targetVMs.ID
}

如果确实存在重名VM，建议直接重命名其中一个，避免后续再出问题。

方法2：正确连接远程Hyper-V上的VM

既然New-PSSession -VMId只能处理本地VM，要连接远程服务器上的VM，得先建立到Hyper-V服务器的会话，再在这个会话里连接VM：

$HyperVServerName = "TheServerName"
$VMName = "AValidVMName"
$SnapshotName = "ASnapshotName"
$creds = Get-Credential

# 恢复快照并启动VM
Restore-VMSnapshot -ComputerName $HyperVServerName -VMName $VMName -Name $SnapshotName -Confirm:$false
Start-VM -ComputerName $HyperVServerName -Name $VMName

# 等待VM完全启动（比单纯的sleep更可靠）
do {
    $vmState = (Get-VM -ComputerName $HyperVServerName -Name $VMName).State
    Start-Sleep -Seconds 3
} while ($vmState -ne 'Running')

# 第一步：先建立到Hyper-V服务器的PSSession
$serverSession = New-PSSession -ComputerName $HyperVServerName -Credential $creds
if ($serverSession) {
    Enter-PSSession -Session $serverSession
    
    # 第二步：在远程服务器的会话内，获取VMID并连接VM
    $vmId = (Get-VM -Name $VMName).ID
    $vmSession = New-PSSession -VMId $vmId -Credential $creds
    
    if ($vmSession) {
        Enter-PSSession -Session $vmSession
        # 在这里执行你的操作
    }
}

另外补充个小提示：如果你的VM是Gen2且用了Enhanced Session Mode，确保Hyper-V服务器和本地机器都启用了这个功能，不过这通常不是ID解析错误的直接原因，只是个额外的排查点。

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