f735fd672a
* Copy in incidental windows tests. * Update incidental test aliases. * Add support plugins. * Update target references. * Update sanity ignores. * Update integration-aliases test. * Add to CI.
136 lines
4.4 KiB
Python
136 lines
4.4 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright: (c) 2016, Ansible, inc
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['preview'],
|
|
'supported_by': 'core'}
|
|
|
|
DOCUMENTATION = r'''
|
|
---
|
|
module: win_command
|
|
short_description: Executes a command on a remote Windows node
|
|
version_added: 2.2
|
|
description:
|
|
- The C(win_command) module takes the command name followed by a list of space-delimited arguments.
|
|
- The given command will be executed on all selected nodes. It will not be
|
|
processed through the shell, so variables like C($env:HOME) and operations
|
|
like C("<"), C(">"), C("|"), and C(";") will not work (use the M(win_shell)
|
|
module if you need these features).
|
|
- For non-Windows targets, use the M(command) module instead.
|
|
options:
|
|
free_form:
|
|
description:
|
|
- The C(win_command) module takes a free form command to run.
|
|
- There is no parameter actually named 'free form'. See the examples!
|
|
type: str
|
|
required: yes
|
|
creates:
|
|
description:
|
|
- A path or path filter pattern; when the referenced path exists on the target host, the task will be skipped.
|
|
type: path
|
|
removes:
|
|
description:
|
|
- A path or path filter pattern; when the referenced path B(does not) exist on the target host, the task will be skipped.
|
|
type: path
|
|
chdir:
|
|
description:
|
|
- Set the specified path as the current working directory before executing a command.
|
|
type: path
|
|
stdin:
|
|
description:
|
|
- Set the stdin of the command directly to the specified value.
|
|
type: str
|
|
version_added: '2.5'
|
|
output_encoding_override:
|
|
description:
|
|
- This option overrides the encoding of stdout/stderr output.
|
|
- You can use this option when you need to run a command which ignore the console's codepage.
|
|
- You should only need to use this option in very rare circumstances.
|
|
- This value can be any valid encoding C(Name) based on the output of C([System.Text.Encoding]::GetEncodings()).
|
|
See U(https://docs.microsoft.com/dotnet/api/system.text.encoding.getencodings).
|
|
type: str
|
|
version_added: '2.10'
|
|
notes:
|
|
- If you want to run a command through a shell (say you are using C(<),
|
|
C(>), C(|), etc), you actually want the M(win_shell) module instead. The
|
|
C(win_command) module is much more secure as it's not affected by the user's
|
|
environment.
|
|
- C(creates), C(removes), and C(chdir) can be specified after the command. For instance, if you only want to run a command if a certain file does not
|
|
exist, use this.
|
|
seealso:
|
|
- module: command
|
|
- module: psexec
|
|
- module: raw
|
|
- module: win_psexec
|
|
- module: win_shell
|
|
author:
|
|
- Matt Davis (@nitzmahone)
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
- name: Save the result of 'whoami' in 'whoami_out'
|
|
win_command: whoami
|
|
register: whoami_out
|
|
|
|
- name: Run command that only runs if folder exists and runs from a specific folder
|
|
win_command: wbadmin -backupTarget:C:\backup\
|
|
args:
|
|
chdir: C:\somedir\
|
|
creates: C:\backup\
|
|
|
|
- name: Run an executable and send data to the stdin for the executable
|
|
win_command: powershell.exe -
|
|
args:
|
|
stdin: Write-Host test
|
|
'''
|
|
|
|
RETURN = r'''
|
|
msg:
|
|
description: changed
|
|
returned: always
|
|
type: bool
|
|
sample: true
|
|
start:
|
|
description: The command execution start time
|
|
returned: always
|
|
type: str
|
|
sample: '2016-02-25 09:18:26.429568'
|
|
end:
|
|
description: The command execution end time
|
|
returned: always
|
|
type: str
|
|
sample: '2016-02-25 09:18:26.755339'
|
|
delta:
|
|
description: The command execution delta time
|
|
returned: always
|
|
type: str
|
|
sample: '0:00:00.325771'
|
|
stdout:
|
|
description: The command standard output
|
|
returned: always
|
|
type: str
|
|
sample: 'Clustering node rabbit@slave1 with rabbit@master ...'
|
|
stderr:
|
|
description: The command standard error
|
|
returned: always
|
|
type: str
|
|
sample: 'ls: cannot access foo: No such file or directory'
|
|
cmd:
|
|
description: The command executed by the task
|
|
returned: always
|
|
type: str
|
|
sample: 'rabbitmqctl join_cluster rabbit@master'
|
|
rc:
|
|
description: The command return code (0 means success)
|
|
returned: always
|
|
type: int
|
|
sample: 0
|
|
stdout_lines:
|
|
description: The command standard output split in lines
|
|
returned: always
|
|
type: list
|
|
sample: [u'Clustering node rabbit@slave1 with rabbit@master ...']
|
|
'''
|