使用 Python 和 WinRM 远程控制 Windows 服务器

pip install pywinrm

代码实战

编写 Python 脚本连接 Windows 被控端。我们需要 IP 地址、端口号、用户名和密码。

基础连接示例

import winrm

# 连接参数
host = "192.168.1.100"
port = 5985
username = "Administrator"
password = "your_password"

# 创建会话，transport 可选 'ntlm' 或 'basic'
session = winrm.Session(
    f"http://{host}:{port}", 
    auth=(username, password), 
    transport='ntlm'
)

# 执行 CMD 命令
result = session.run_cmd('ipconfig', ['/all'])
print(result.status_code)
print(result.std_out.decode('utf-8'))

# 关闭会话
session.close()

封装类实现

为了便于维护，建议将逻辑封装为类，并处理编码问题及异常。

import winrm
import codecs

class WindowsRemoteManager:
    def __init__(self, host, port, username, password):
        self.host = host
        self.port = port
        self.session = winrm.Session(
            f"http://{host}:{port}",
            auth=(username, password),
            transport='ntlm'
        )

    def run_cmd(self, cmd):
        """
        执行 CMD 命令，获取返回值
        :param cmd: 命令字符串
        :return: 返回结果内容
        """
        try:
            result = self.session.run_cmd(cmd)
            code = result.status_code
            content = result.std_out if code == 0 else result.std_err
            
            # 尝试 UTF-8 解码，失败则尝试 GBK
            try:
                return content.decode("utf-8")
            except UnicodeDecodeError:
                return content.decode("gbk")
        except Exception as e:
            return f"Error: {str(e)}"

    def run_ps(self, cmd):
        """
        执行 PowerShell 命令
        :param cmd: 命令字符串
        :return: 返回结果内容
        """
        try:
            result = self.session.run_ps(cmd)
            code = result.status_code
            content = result.std_out if code == 0 else result.std_err
            try:
                return content.decode("utf-8")
            except UnicodeDecodeError:
                return content.decode("gbk")
        except Exception as e:
            return f"Error: {str(e)}"

    def close(self):
        """关闭会话"""
        self.session.close()

# 使用示例
if __name__ == "__main__":
    manager = WindowsRemoteManager(
        host="192.168.1.100",
        port=5985,
        username="Administrator",
        password="password"
    )
    
    # 查看 D 盘某日志文件内容
    cmd = 'D: & cd py\\log & type trade.log'
    output = manager.run_cmd(cmd)
    print(output)
    
    manager.close()

安全注意事项

1. 避免明文传输：上述示例使用了 HTTP 和 Basic/NTLM 认证。在生产环境中，应配置 HTTPS 并使用证书认证，防止密码在网络中泄露。
2. 最小权限原则：不要使用 Administrator 账户进行日常运维，建议创建具有特定权限的专用账户。
3. 网络隔离：限制 WinRM 端口仅对受信任的 IP 段开放。
4. 禁用 Basic Auth：除非必要，否则不要在 Service 配置中开启 AllowUnencrypted="true" 和 Basic="true"。

常见问题排查

• 连接超时：检查防火墙是否放行 5985 端口，确认网络可达性（ping）。
• 401 Unauthorized：用户名或密码错误，或 TrustedHosts 未配置正确。
• 404 Not Found：WinRM 服务未启动，或路径配置错误。
• 编码乱码：Windows 默认控制台编码通常为 GBK，Python 解码时需兼容 GBK 或 UTF-8。

通过上述步骤，即可实现通过 Python 脚本安全、稳定地远程控制 Windows 服务器，自动化执行系统管理任务。