WinSW项目CLI命令详解：Windows服务管理全指南

WinSW项目CLI命令详解：Windows服务管理全指南

winsw A wrapper executable that can run any executable as a Windows service, in a permissive license. 项目地址: https://gitcode.com/gh_mirrors/wi/winsw

前言

WinSW作为一款强大的Windows服务包装工具，为开发者提供了便捷的命令行接口(CLI)来管理系统服务。本文将全面解析WinSW的各项CLI命令，帮助您掌握服务管理的核心操作。

基础服务管理命令

安装服务(install)

安装命令是使用WinSW的第一步，它可以将您的应用程序注册为Windows服务。

winsw install [配置文件路径] [选项]

关键参数说明：

• 配置文件路径：可选参数，默认会查找与可执行文件同名的XML配置文件
• --no-elevate：禁用UAC提权提示
• --username/--password：指定服务运行账户

技术要点：

• 安装过程会向Windows服务管理器注册服务
• 建议使用最小权限原则配置服务账户

卸载服务(uninstall)

当不再需要服务时，使用卸载命令移除服务注册。

winsw uninstall [配置文件路径] [--no-elevate]

注意事项：

• 卸载前应先停止服务
• 卸载不会删除程序文件，仅移除服务注册信息

服务生命周期控制

启动服务(start)

winsw start [配置文件路径] [--no-elevate]

典型应用场景：

• 服务安装后的首次启动
• 系统重启后手动启动服务

停止服务(stop)

winsw stop [配置文件路径] [--no-elevate] [--no-wait] [--force]

选项解析：

• --no-wait：异步停止，不等待服务完全停止
• --force：强制停止，即使有依赖服务

重启服务(restart)

winsw restart [配置文件路径] [--no-elevate] [--force]

最佳实践：

• 配置变更后建议使用重启命令
• 生产环境谨慎使用--force选项

服务状态管理

检查状态(status)

winsw status [配置文件路径]

输出解读：

• 返回服务当前运行状态
• 可用于脚本中判断服务健康状况

刷新配置(refresh)

winsw refresh [配置文件路径] [--no-elevate]

技术细节：

• 无需重新安装即可应用配置变更
• 适用于修改服务描述等非关键配置

高级功能命令

自定义包装器(customize)

winsw customize -o 输出路径 --manufacturer 厂商名称

应用场景：

• 为服务包装器添加厂商信息
• 创建具有企业标识的自定义包装器

开发工具集(dev)

WinSW提供了一系列开发者工具：

1. 进程树查看(dev ps)

   winsw dev ps [配置文件路径] [-a|--all]
   

   • 可视化服务相关进程关系
   • -a选项显示所有服务进程

2. 强制终止(dev kill)

   winsw dev kill [配置文件路径] [--no-elevate]
   

   • 处理服务无响应情况
   • 应作为最后手段使用

3. 服务列表(dev list)

   winsw dev list
   

   • 列出当前可执行文件管理的所有服务
   • 便于批量管理多个服务

最佳实践建议

1. 配置文件管理

   • 保持配置文件与可执行文件同名
   • 使用版本控制管理配置文件变更

2. 权限控制

   • 生产环境避免使用--no-elevate
   • 为服务配置专用低权限账户

3. 自动化脚本

   • 结合状态检查实现健壮的部署脚本
   • 记录关键操作日志

4. 故障排查

   • 使用dev ps分析进程问题
   • 谨慎使用强制选项

通过掌握这些CLI命令，您可以全面掌控Windows服务的生命周期管理，实现服务的自动化部署和运维。WinSW的强大功能让Windows服务管理变得简单高效。

winsw A wrapper executable that can run any executable as a Windows service, in a permissive license. 项目地址: https://gitcode.com/gh_mirrors/wi/winsw