【零基础入门】手把手教你安装配置Windows远程管理神器PyWinRM

【零基础入门】手把手教你安装配置Windows远程管理神器PyWinRM

pywinrm Python library for Windows Remote Management (WinRM) 项目地址: https://gitcode.com/gh_mirrors/py/pywinrm

一、项目基础介绍及编程语言

项目名称: PyWinRM
核心语言: Python
项目简介: PyWinRM是一款由Python编写的客户端库，专为Windows远程管理服务(WinRM)设计。通过它，你可以在任何安装了Python的环境中轻松地对Windows系统执行远程命令，无论是运行批处理脚本、PowerShell脚本还是获取WMI变量等，都不在话下。此项目广泛应用于自动化运维场景，尤其是与Ansible集成以实现对Windows主机的支持。

二、关键技术与框架

关键技术：

• WinRM协议: 支持基本认证、证书认证、NTLM、Kerberos以及CredSSP等多种认证方式。
• 跨平台兼容性: 兼容Linux, macOS, 和Windows操作系统上的Python环境。
• GSS-API Wrap: 在特定情况下利用消息加密，保障通信安全。

使用到的框架与依赖：

• requests: 处理HTTP请求，用于与WinRM服务端交互。
• requests-kerberos/requests-credssp: 可选依赖，分别支持Kerberos和CredSSP高级认证方式。

三、安装与配置教程 - 小白级操作

准备工作：

确保你的计算机已安装Python 3.8及以上版本，并有权限安装Python包。对于Windows系统，还需确保WinRM服务已在目标机器上启用。

步骤1：基础安装

打开终端或命令提示符，通过pip安装PyWinRM的基本功能：

pip install pywinrm

这将足以完成基本的认证方式（基本、证书、NTLM）的安装。

步骤2：高级认证安装

Kerberos认证：

对于Kerberos，你需要额外的依赖项。对于Debian/Ubuntu类系统：

sudo apt-get install gcc python3-dev libkrb5-dev
pip install pywinrm[kerberos]

RHEL/CentOS则使用：

sudo dnf install gcc krb5-devel krb5-workstation python3-devel
pip install pywinrm[kerberos]

CredSSP认证：

若需CredSSP支持：

pip install pywinrm[credssp]

步骤3：配置WinRM服务端

• 对于测试，快速启动WinRM服务并允许HTTP访问（不推荐生产环境）:

  winrm quickconfig
  

• 开启基本认证（适用于本地账户测试，但不建议在生产环境下使用）:

  winrm set winrm/config/service/auth @{Basic="true"}
  

• 若要开启CredSSP支持（适用于需要从一台服务器跳转到另一台的情景）:

  Enable-WSManCredSSP -Role Server -Force
  Set-Item -Path "WSMan:\localhost\Service\Auth\CredSSP" -Value $true
  

步骤4：验证安装

安装完成后，你可以通过Python脚本来测试连接：

import winrm

s = winrm.Session('目标服务器IP', auth=('用户名', '密码'))
r = s.run_cmd('ipconfig', ['/all'])
print(r.std_out)

确保替换 '目标服务器IP'、'用户名' 和 '密码' 为实际值，并检查输出是否正确显示了远程服务器的网络配置信息。

至此，您已经完成了PyWinRM的安装与初步配置，可以开始您的Windows远程管理之旅了。记得，在进行生产环境配置时，重视安全性设置，避免不必要的安全隐患。

pywinrm Python library for Windows Remote Management (WinRM) 项目地址: https://gitcode.com/gh_mirrors/py/pywinrm