# <servicecontroller>

[This is preliminary documentation and subject to change.]

Allows a Windows service to be controlled.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
action | ActionType | The action that should be performed on the service. | True
service | string | The name of the service that should be controlled. | True
machine | string | The name of the computer on which the service resides. The default is the local computer. | False
timeout | double | The time, in milliseconds, the task will wait for the service to reach the desired status. The default is 5000 milliseconds. | False
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False
unless | bool | Opposite of `if`. If false then the task will be executed; otherwise, skipped. The default is false. | False
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False

### Examples

- Starts the World Wide Web Publishing Service on the local computer.

                  <servicecontroller action="Start" service="w3svc" />

- Stops the Alerter service on computer 'MOTHER'.

                  <servicecontroller action="Stop" service="Alerter" machine="MOTHER" />

### Requirements

Assembly: NAnt.MSNetTasks (0.91.3881.0)