winsw配置文件参数解释说明

id:

指定Windows内部用户标识服务的id;
在系统安装的所有服务中id必须是唯一的,并且完全由字母数字字符组成。

executable:

该元素指定要启动的可执行文件;
可以是绝对路径,也可以只指定可执行文件名称并从PATH中搜索。

arguments:

该标签指定的参数传递给可执行文件,多个参数以空格隔开

name:

服务的简短显示名称,可以包含空格和其他字符;
在系统的所有服务中name也必须是唯一的。

description:

对服务的完整描述。

startmode:

该元素指定windows服务的启动模式。它的值为下列值之一:

  • Boot:设备驱动程序由操作系统和加载程序启动;此值仅对驱动程序服务有效。
  • System:设备驱动程序由操作系统初始化过程启动;此值仅对驱动程序服务有效。
  • Automatic:自动,服务控制管理器将在系统启动期间自动启动服务。
  • Manual:手动,当进程调用StartService方法时,由服务控制管理器启动的服务。
  • Disable:禁用,此服务将不能启动
    默认值为Automatic
delayedAutoStart:

是否启用延迟启动模式;
值为true或者false,需要stratmode设置为Automatic

depend:

指定此服务依赖的其他服务的ID,仅在依赖的服务运行时此服务才可运行,可以使用多个标签指定多个依赖。

logpath:

指定在其中创建日志文件的目录,默认为配置文件所在的目录。

log:

该标签的mode属性指定从启动过程中捕获stdout和stderr的几种不同的方法:

  • append:追加模式

  • reset:重设模式,每次服务启动时,旧的日志文件都会被截断

  • roll-by-size:按日志文件大小滚动,日志大于指定大小后重新生成新的日志文件进行写入,日志文件名最后以阿拉伯数字区分;
    嵌套sizeThreshold标签指定日志文件多大时生成新日志文件,单位为KB;
    嵌套keepFiles标签指定最多要保留的日志文件数;

  • roll-by-time:按日志文件时间段滚动
    必须嵌套pattern标签指定日志文件名的时间标记格式,例如yyyyMMdd HH:mm

  • roll-by-size-time:按日志文件大小和时间模式滚动
    嵌套sizeThreshold标签指定日志文件多大时生成新日志文件,单位为KB
    嵌套pattern标签指定当日志文件文件名最后的区分字段格式(时间格式,如yyyyMMdd HH:mm)
    嵌套autoRollAtTime标签指定每天在指定时间进行日志滚,例如00:00:00表示每天凌晨进行日志滚动

stopexecutable:

指定当请求停止服务时启动另一个进程的可执行文件,不提供默认使用executable指定的文件。

stopargument:

当请求停止服务时启动另一个进程时的参数

stopparentprocessfirst:

是否在停止子进程之前终止父进程,默认true

waithint:

指定多长时间内服务应该对SetServiceStatus函数进行下一次调用,否则会被标记为无响应,默认"15 sec"

sleeptime:

服务两次调用SetServiceStatus函数的间隔时间,默认"1 sec"

prestart:

预启动,服务启动时和主进程启动之前,将执行预启动命令

poststart:

启动后,服务启动时和主进程启动后,将执行启动后命令

prestop:

停止前,服务停止时和主进程停止之前,执行停止前命令

以上三个标签可以内部嵌套executable,arguments,stdoutPath,stderrPath等

preshutdown:

是否关机前进行阻止立即关机,当启动时服务有更多时间停止

preshutdownTimeout:

关机前超时,默认值为"3 min"

stoptimeout:

停止超时时间
当请求停止服务时,尝试向控制台应用程序发送Ctrl + C信号,或向Windows应用程序发布关闭消息,然后等待指定时间以使进程自行正常退出。
如果超时到期或无法发送信号或消息,则会立即终止服务,默认值为"15sec"。

env:

为子进程设置环境变量,可以使用多次从而设置多个变量
单标签,通过name和value两个属性设置环境变的值

interactive:

是否允许该服务与桌面进行交互

beeponshutdown:

是否允许在服务关闭时发出简单的提示音,调试功能,某些系统或硬件不支持

download:

服务包装程序从指定URL下载到本地。在启动服务时且启动服务程序之前运行。

  • from属性指定要下载文件的的url地址
  • to属性指定下载到本地的文件名
  • proxy属性指定代理,格式为"http://[USERNAME:PASSWORD@]HOST:PORT/"
auth:

身份验证,默认值为none(不验证),为basic则表示使用基本身份验证;
当使用基本身份验证时需要额外的附加属性,user指定用户名,password指定密码

failOnError:

下载失败是否继续启动服务,默认true

onfailure:

指定服务启动失败时的行为

  • action属性指定行为,可选的值有restart(重启服务),reboot(重启系统)和none
  • delay属性指定服务启动失败多久后执行操作,默认为0。

多个onfailure按失败顺序依次执行,当失败实数超过onfailure标签数量时,重复执行最后一个onfailure标签指定的操作。

resetfailure:

重置故障计数的时间,如该标签值为"1 hour"表示服务持续正常运行超过一小时则故障计数会重置为0。

serviceaccount:

指定服务运行时使用的账户,默认使用LocalSystem内置账户;
嵌套username标签指定用户名(格式DomainName\UserName或者UserName@DomainName),当前内置域使用".\UserName";
显示的使用内置账户(内置账户没有密码,即使提供密码也会被忽略)的几个值:“LocalSystem”,“NT AUTHORITY\LocalService”,“NT AUTHORITY\NetworkService”,

  • 嵌套password指定用户的密码
  • 嵌套allowservicelogon表示是否自动为指定帐户设置“允许作为服务登录”权限
  • 嵌套prompt表示提示输入用户名和密码,该值格式为<prompt>dialog|console</prompt>
dialog:

使用对话框提示

console:

在控制台上提示

workingdirectory:

指定服务运行时的工作目录

autoRefresh:

服务启动,停止,重启,测试(test)时是否自动刷新服务属性

  • 3
    点赞
  • 6
    收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
©️2022 CSDN 皮肤主题:技术黑板 设计师:CSDN官方博客 返回首页
评论

打赏作者

安夜的cookie

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值