Debian容器中通过subprocess.run()启动交互式Enter-PSSession失败问题

问题根源 #

Enter-PSSession是交互式命令，必须依赖终端（TTY）处理输入输出交互。用subprocess.run()直接调用时，默认不会给子进程分配TTY，导致会话无法接收用户输入，进而出现挂起。

具体解决方案 #

1. 给子进程分配伪终端（Linux环境适用） #

利用Python的pty模块创建伪终端，让PowerShell认为处于交互式终端环境：

import subprocess
import pty
import os
import sys

# 替换为你的远程连接命令
pwsh_cmd = ["pwsh", "-i", "-Command", "Enter-PSSession -ComputerName YOUR_WINDOWS_HOST -Credential (Get-Credential)"]

# 创建伪终端
master_fd, slave_fd = pty.openpty()

# 启动子进程并绑定伪终端
proc = subprocess.Popen(pwsh_cmd, stdin=slave_fd, stdout=slave_fd, stderr=slave_fd, text=True)
os.close(slave_fd)  # 关闭slave端释放资源

# 绑定当前终端与伪终端的输入输出
try:
    while proc.poll() is None:
        # 读取PowerShell输出并打印到当前终端
        output = os.read(master_fd, 1024).decode()
        if output:
            sys.stdout.write(output)
            sys.stdout.flush()
        # 读取用户输入并发送给PowerShell
        user_input = sys.stdin.read(1)
        if user_input:
            os.write(master_fd, user_input.encode())
finally:
    os.close(master_fd)

2. 绑定当前终端的输入输出流 #

如果不需要复杂的流处理，直接把subprocess的标准流绑定到当前终端：

import subprocess
import sys

subprocess.run(
    ["pwsh", "-i", "-Command", "Enter-PSSession ..."],
    stdin=sys.stdin,
    stdout=sys.stdout,
    stderr=sys.stderr,
    check=False
)

这种方式简单直接，但部分环境下可能仍需配合伪终端才能完全正常交互。

3. 提前编写PowerShell脚本调用 #

把远程连接命令写入.ps1脚本（比如connect.ps1），再用Python启动：

# connect.ps1 内容
$cred = New-Object System.Management.Automation.PSCredential(
    "YOUR_USERNAME",
    (ConvertTo-SecureString "YOUR_PASSWORD" -AsPlainText -Force)
)
Enter-PSSession -ComputerName YOUR_WINDOWS_HOST -Credential $cred

Python调用代码：

import subprocess
import sys

subprocess.run(
    ["pwsh", "-i", "-File", "/path/to/connect.ps1"],
    stdin=sys.stdin,
    stdout=sys.stdout,
    stderr=sys.stderr
)

这种方式可以避免在命令行传递敏感凭据，也能减少交互环节导致的挂起。

额外提示 #

• 若使用Get-Credential弹出凭据输入框，需确保Python进程运行在有图形界面的环境中，否则会因无法显示弹窗挂起，建议用脚本中预定义凭据的方式替代。
• 确认Windows主机的WinRM服务已正常启用、防火墙允许WinRM端口（默认5985/5986）、远程用户拥有足够权限，这些你已经手动验证过，无需额外操作。

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