Pywinrm，一个 Python 管理利器！

Pywinrm：实现跨平台自动化管理的核心工具

在混合基础设施中，从Linux系统管理Windows服务器常面临协议壁垒。当SSH无法连接Windows，而原生PowerShell Remoting又缺乏标准化的Python集成方案时，pywinrm模块便成为关键桥梁。它基于Windows远程管理协议，使Python脚本能够直接调用远程Windows命令与PowerShell，为异构环境自动化提供了稳定可靠的解决方案。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

快速安装与环境配置

pywinrm可通过pip直接安装，作为Ansible管理Windows节点的标准依赖，其稳定性已得到广泛验证。执行以下命令完成部署：

!pip install pywinrm
import winrm
print("pywinrm模块导入成功")
print(f"支持的认证方式: basic, ntlm, kerberos, credssp")

安装完成后，终端将显示模块信息与协议端口：

pywinrm模块导入成功
支持的认证方式：basic， ntlm, kerberos， credssp
WinRM协议端口：HTTP 5985 / HTTPS 5986

建立会话与执行基础命令

管理操作始于会话创建。Session对象处理所有连接参数，run_cmd方法则用于执行标准CMD指令。以下示例演示如何获取远程主机的完整网络配置：

session = winrm.Session(
    'windows-server.example.com',
    auth=('administrator', 'password'),
    transport='ntlm')
result = session.run_cmd('ipconfig', ['/all'])
print(f"命令执行状态码: {result.status_code}")
print(result.std_out.decode('utf-8', errors='ignore')[:200] + "...")

命令执行后返回状态码与解析后的输出内容：

命令执行状态码：0
Windows IP Configuration
   Host Name . . . . . . . . . . . . : WIN-SERVER
   Primary Dns Suffix  . . . . . . . : example.com...

执行PowerShell脚本

pywinrm的核心价值体现在PowerShell脚本的远程执行能力上。run_ps方法自动完成脚本编码与传输，支持复杂的系统管理任务。例如获取操作系统与处理器信息：

ps_script = """
$os = Get-CimInstance Win32_OperatingSystem
$cpu = Get-CimInstance Win32_Processor
"操作系统: " + $os.Caption
"处理器: " + $cpu.Name
"""
result = session.run_ps(ps_script)
output_lines = result.std_out.decode('utf-8', errors='ignore').strip().split('\n')
for line in output_lines:
    print(f"  {line}")

脚本执行后返回详细的系统配置数据：

操作系统：Microsoft Windows Server 2024 Datacenter
  处理器：Intel(R) Xeon(R) Platinum 8272CL CPU @ 2.60GHz

认证机制与安全配置

安全的远程连接依赖于正确的认证方式配置。pywinrm支持多种企业级认证协议，需根据域环境与安全要求进行选择：

session_ntlm = winrm.Session(
    'server',
    auth=('domain\\user', 'password'),
    transport='ntlm')
print("认证方式配置完成")
print("  - NTLM: 本地+域账户")
print("  - Kerberos: 仅域账户")
print("  - CredSSP: 支持双跳")

不同认证协议的适用场景如下：

认证方式配置完成
  - NTLM：本地+域账户
  - Kerberos：仅域账户
  - CredSSP：支持双跳

技术优势与应用场景分析

相较于SSH或直接调用PowerShell Remoting，pywinrm的核心价值在于提供了标准化的Python API接口，并能深度集成至Ansible等自动化编排平台，实现配置管理的统一化。

需要注意的是，初始部署需正确配置WinRM服务与防火墙规则，开放5985或5986端口。这些前置步骤是保证连接稳定的基础。

该工具特别适用于以下场景：需要批量管理Windows服务器集群，或构建统一运维平台以同时处理Linux与Windows资产。它有效解决了跨平台自动化中的协议转换与执行引擎标准化问题。