Windows Service Manager - Installs and deploys a windows service or TopShelf service on a target machine or a deployment group target.
Locates the service by the Service Name
Stops the service
If Stop Process is selected and the Timeout is reached, the process of the service will be stopped.
If Clean Install is selected, removes all files in the parent directory of the .exe file
Starts the service
Install and Run
After installing the Windows Service Manager extension, open a release and add the 'Windows Service Manager' task.
Task Options
Task Options for Deployment Group
Display Name - The name of the task.
Deployment Type - Deploying with either an Agent or a Deployment Group Target.
Service Name - The name of the Windows Service installed on the Deployment Group Target.
Artifact Path - The path to the Artifact that contains the Windows Service binaries.
Timeout - The number of seconds to wait for the service to stop.
Task Options for Agent
Display Name - The name of the task.
Machines - Provide a comma separated list of machine IP addresses or FQDNs. Or provide output variable of other tasks. Eg: $(variableName).
Admin Login - Administrator login for the target machines.
Password - Password for administrator login for the target machines. It can accept variable defined in Build/Release definitions as '$(passwordVariable)'. You may mark variable type as 'secret' to secure it.
Service Name - The name of the Windows Service installed on the Deployment Group Target.
Artifact Path - The path to the Artifact that contains the Windows Service binaries.
Timeout - The number of seconds to wait for the service to stop.
Advanced Task Options
Stop Process - Stops the process if the service does not respond within the timeout.
Clean Install - Removes all files inside the parent directory of the .exe file prior to copying the Artifact.
Installation Task Options
Install the windows service - Enables service installation.
Installation Path - The path to the executable file.
Run As Username - The username the service should run as.
Run As Password - The password for the Run As Username. It can accept variable defined in Build/Release definitions as '$(passwordVariable)'. You may mark variable type as 'secret' to secure it.
Install as a TopShelf Service - Enables TopShelf installation.
Instance Name - The name of the TopShelf instance.
Install Arguments - The TopShelf installation arguments.
Release Notes
Version 4
Implemented support for installing TopShelf windows services.
Version 3
Implemented feature request for installing a service and resolved bug for multiple machine support.
Version 2
Resolved bug for service name matching, service name will only support exact names.
Version 1
Supports deployment groups and agents using WinRM.
