`) ``win_chocolatey: name=nssm`` Parameters ---------- .. raw:: html

Parameter	Choices/Defaults	Comments
app_environment dictionary added in 1.2.0		Key/Value pairs which will be added to the environment of the service application.
app_parameters string		A string representing a dictionary of parameters to be passed to the application when it starts. DEPRECATED since v2.8, please use arguments instead. This is mutually exclusive with arguments.
app_rotate_bytes integer	Default: 104858	NSSM will not rotate any file which is smaller than the configured number of bytes.
app_rotate_online integer	Choices: 0 ← 1	If set to 1, nssm can rotate files which grow to the configured file size limit while the service is running.
app_stop_method_console integer		Time to wait after sending Control-C.
app_stop_method_skip integer	Choices: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	To disable service shutdown methods, set to the sum of one or more of the numbers 1 - Don't send Control-C to the console. 2 - Don't send WM_CLOSE to windows. 4 - Don't send WM_QUIT to threads. 8 - Don't call TerminateProcess().
application path		The application binary to run as a service Required when state is `present`, `started`, `stopped`, or `restarted`.
arguments string		Parameters to be passed to the application when it starts. This can be either a simple string or a list. This is mutually exclusive with app_parameters. aliases: app_parameters_free_form
dependencies list		Service dependencies that has to be started to trigger startup, separated by comma.
description string		The description to set for the service.
display_name string		The display name to set for the service.
executable path	Default: "nssm.exe"	The location of the NSSM utility (in case it is not located in your PATH).
name string / required		Name of the service to operate on.
password string		Password to be used for service startup. This is not required for the well known service accounts and group managed service accounts.
start_mode string	Choices: auto ← delayed disabled manual	If `auto` is selected, the service will start at bootup. `delayed` causes a delayed but automatic start after boot. `manual` means that the service will start only when another service needs it. `disabled` means that the service will stay off, regardless if it is needed or not.
state string	Choices: absent present ← started stopped restarted	State of the service on the system.
stderr_file path		Path to receive error output.
stdout_file path		Path to receive output.
username string		User to be used for service startup. Group managed service accounts must end with `$`. Before `1.8.0`, this parameter was just `user`. aliases: user
working_directory path		The working directory to run the service executable from (defaults to the directory containing the application binary) aliases: app_directory, chdir

Notes ----- .. note:: - The service will NOT be started after its creation when ``state=present``. - Once the service is created, you can use the :ref:`ansible.windows.win_service ` module to start it or configure some additionals properties, such as its startup type, dependencies, service account, and so on. See Also -------- .. seealso:: :ref:`ansible.windows.win_service_module` The official documentation on the **ansible.windows.win_service** module. Examples -------- .. code-block:: yaml - name: Install the foo service community.windows.win_nssm: name: foo application: C:\windows\foo.exe # This will yield the following command: C:\windows\foo.exe bar "true" - name: Install the Consul service with a list of parameters community.windows.win_nssm: name: Consul application: C:\consul\consul.exe arguments: - agent - -config-dir=C:\consul\config # This is strictly equivalent to the previous example - name: Install the Consul service with an arbitrary string of parameters community.windows.win_nssm: name: Consul application: C:\consul\consul.exe arguments: agent -config-dir=C:\consul\config # Install the foo service, and then configure and start it with win_service - name: Install the foo service, redirecting stdout and stderr to the same file community.windows.win_nssm: name: foo application: C:\windows\foo.exe stdout_file: C:\windows\foo.log stderr_file: C:\windows\foo.log - name: Configure and start the foo service using win_service ansible.windows.win_service: name: foo dependencies: [ adf, tcpip ] username: foouser password: secret start_mode: manual state: started - name: Install a script based service and define custom environment variables community.windows.win_nssm: name: application: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe arguments: - -