New in version 2.2.
win_commandmodule takes the command name followed by a list of space-delimited arguments.
$env:HOMEand operations like
";"will not work (use the win_shell module if you need these features).
set the specified path as the current working directory before executing a command
a path or path filter pattern; when the referenced path exists on the target host, the task will be skipped.
the win_command module takes a free form command to run. There is no parameter actually named 'free form'. See the examples!
a path or path filter pattern; when the referenced path does not exist on the target host, the task will be skipped.
# Example from Ansible Playbooks. - win_command: whoami register: whoami_out # Run the command only if the specified file does not exist. - win_command: wbadmin -backupTarget:C:\backup\ creates=C:\backup\ # You can also use the 'args' form to provide the options. This command # will change the working directory to C:\somedir\\ and will only run when # C:\backup\ doesn't exist. - win_command: wbadmin -backupTarget:C:\backup\ creates=C:\backup\ args: chdir: C:\somedir\ creates: C:\backup\
Common return values are documented here Return Values, the following are the fields unique to this module:
|end||The command execution end time||always||string||2016-02-25 09:18:26.755339|
|stdout||The command standard output||always||string||Clustering node [email protected] with [email protected] ...|
|cmd||The command executed by the task||always||string||rabbitmqctl join_cluster [email protected]|
|start||The command execution start time||always||string||2016-02-25 09:18:26.429568|
|delta||The command execution delta time||always||string||0:00:00.325771|
|stderr||The command standard error||always||string||ls: cannot access foo: No such file or directory|
|rc||The command return code (0 means success)||always||int||0|
|stdout_lines||The command standard output split in lines||always||list of strings||["u'Clustering node [email protected] with [email protected] ...'"]|
|, etc), you actually want the win_shell module instead. The
win_commandmodule is much more secure as it’s not affected by the user’s environment.
chdircan be specified after the command. For instance, if you only want to run a command if a certain file does not exist, use this.
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.