从TFS迁移至Azure DevOps时PowerShell Core任务报无效句柄错误

错误含义 #

Exception setting "CursorPosition": "The handle is invalid." 表示PowerShell Core（pwsh）在尝试设置控制台光标位置时失败，因为当前运行环境没有提供有效的控制台交互句柄，导致相关操作无法执行。

涉及的句柄是什么 #

这里的句柄指Windows系统中的控制台输入/输出句柄（对应标准输入STDIN、标准输出STDOUT、标准错误STDERR的系统内核对象句柄）。程序通过这些句柄与控制台窗口进行交互（比如移动光标、输出文本、读取输入）。当pwsh在没有关联真实控制台会话的环境下运行时，这些句柄会处于无效状态（比如值为null或无效标识），进而触发报错。

Windows PowerShell与PowerShell Core在此场景的行为差异 #

• 控制台操作兼容性：Windows PowerShell（powershell.exe）作为Windows原生组件，对无控制台的运行环境兼容性更强，遇到控制台相关操作时会自动降级处理（比如跳过光标设置、静默忽略无效句柄），不会抛出异常；而PowerShell Core（pwsh）的跨平台设计使其对控制台上下文的校验更严格，一旦检测到无效句柄，执行控制台交互操作会直接抛出错误。
• 环境适配逻辑：Windows PowerShell深度集成Windows控制台子系统，即使在非交互式、无窗口的CI/CD任务环境中，也会自动模拟兼容的控制台上下文；pwsh则遵循跨平台的通用逻辑，默认不会为无控制台场景模拟有效句柄，必须显式配置或避免控制台相关操作。
• 任务启动模式：Azure DevOps开启“Use PowerShell Core”选项后，会直接调用pwsh.exe并以非交互式、无窗口模式启动；关闭该选项时调用powershell.exe，任务环境会自动为其提供适配的控制台句柄，确保相关操作正常执行。

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