要捕获远程 powershell 脚本的完整错误堆栈，需在远程脚本开头设 $erroractionpreference = "stop"，避免 try/catch 吞掉异常，用 invoke-command 配合 -erroraction stop，并在 catch 中输出 $_.exception | format-list -property * -force 或导出 $error[0] 为 json。
在远程执行 powershell 脚本时，远端错误默认不会完整回传到本地会话——常见现象是只看到模糊的“commandinvocationexception”或空错误信息。要捕获远端脚本抛出的**完整错误堆栈（含异常类型、消息、调用位置、内部异常链）**，关键在于让远端错误对象被序列化并原样传递回来，而不是仅返回字符串摘要。
启用远端错误详细信息回传
PowerShell 远程会话默认启用 $ErrorActionPreference = "Stop"，但错误对象在跨会话序列化时会被简化。需主动确保远端错误未被截断：
- 在远程脚本开头显式设置：
$ErrorActionPreference = "Stop"（强制所有错误终止并生成完整 ErrorRecord） - 避免在远端使用
try/catch吞掉原始异常；如需处理，应在catch中重新抛出：throw $_（保留原始堆栈） - 禁用远端的错误截断行为：远程会话中运行
$ErrorView = "NormalView"（虽非必需，但可辅助调试输出格式）
使用 Invoke-Command 并保留错误上下文
推荐用 Invoke-Command 执行远端脚本，并配合 -ErrorAction Stop 和结构化捕获：
- 直接执行脚本块，不依赖
.\script.ps1调用（避免路径/作用域干扰）：Invoke-Command -ComputerName "vm01" -ScriptBlock { & "C:\Scripts\deploy.ps1" } -ErrorAction Stop - 若仍报错，用
try/catch捕获并展开远端错误：try { Invoke-Command ... } catch { $_.Exception | Format-List -Property * -Force } - 重点检查
$_.Exception.InnerException和$_.ScriptStackTrace—— 这两个属性通常包含远端真实的堆栈轨迹
手动导出远端 $Error 数组（最可靠方式）
当上述方法仍丢失细节时，可让远端主动输出其完整的 $Error[0] 对象为结构化数据：
- 在远程脚本末尾添加：
if ($Error.Count -gt 0) { $Error[0] | ConvertTo-Json -Depth 10 } - 或通过
Invoke-Command单独查询远端错误：Invoke-Command -ComputerName "vm01" -ScriptBlock { if ($Error) { $Error[0] | Select-Object Exception, ScriptStackTrace, CategoryInfo, TargetObject | ConvertTo-Json -Depth 5 } } - 结果为 JSON 字符串，可在本地用
ConvertFrom-Json还原为对象，查看完整异常链
补充：远程调试会话中实时观察
若需交互式排查，可建立持久远程会话后手动触发脚本：
$s = New-PSSession -ComputerName "vm01"-
Invoke-Command -Session $s -ScriptBlock { Set-PSDebug -Trace 1; .\deploy.ps1 }（开启追踪，错误发生时立即停住） - 随后用
Enter-PSSession -Session $s登录，直接运行$Error[0] | fl *查看最新错误全貌
