ansible / ansible.builtin / v2.3.0.0-1 / module / command Executes a command on a remote node | "added in version" historical of ansible.builtin" Authors: Ansible Core Team, Michael DeHaan stableinterface | supported by coreansible.builtin.command (v2.3.0.0-1) — module
pip
Install with pip install ansible==2.3.0.0.post1
The C(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($HOME) and operations like C("<"), C(">"), C("|"), C(";") and C("&") will not work (use the M(shell) module if you need these features).
- name: return motd to registered var command: cat /etc/motd register: mymotd
- name: Run the command if the specified file does not exist. command: /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database
# You can also use the 'args' form to provide the options. - name: This command will change the working directory to somedir/ and will only run when /path/to/database doesn't exist. command: /usr/bin/make_database.sh arg1 arg2 args: chdir: somedir/ creates: /path/to/database
- name: safely use templated variable to run command. Always use the quote filter to avoid injection issues. command: cat {{ myfile|quote }} register: myoutput
warn: default: true description: - if command warnings are on in ansible.cfg, do not warn about this particular line if set to no/false. required: false version_added: '1.8' version_added_collection: ansible.builtin chdir: default: null description: - cd into this directory before running the command required: false version_added: '0.6' version_added_collection: ansible.builtin creates: default: null description: - a filename or (since 2.0) glob pattern, when it already exists, this step will B(not) be run. required: false removes: default: null description: - a filename or (since 2.0) glob pattern, when it does not exist, this step will B(not) be run. required: false version_added: '0.8' version_added_collection: ansible.builtin free_form: default: null description: - the command module takes a free form command to run. There is no parameter actually named 'free form'. See the examples! required: true executable: default: null description: - change the shell used to execute the command. Should be an absolute path to the executable. required: false version_added: '0.9' version_added_collection: ansible.builtin