ansible.builtin.cmd – Windows Command Prompt

Note

This module is part of ansible-base and included in all Ansible installations. In most cases, you can use the short module name cmd even without specifying the collection: keyword. Despite that, we recommend you use the FQCN for easy linking to the module documentation and to avoid conflicting with other collections that may have the same module name.

New in version 2.8: of ansible.builtin

Synopsis

  • Used with the ‘ssh’ connection plugin and no DefaultShell has been set on the Windows host.

Parameters

Parameter Choices/Defaults Configuration Comments
async_dir
string
added in 2.8 of ansible.builtin
Default:
"%USERPROFILE%\\.ansible_async"
ini entries:

[powershell]
async_dir = %USERPROFILE%\.ansible_async

var: ansible_async_dir
Directory in which ansible will keep async job information.
Before Ansible 2.8, this was set to remote_tmp + "\.ansible_async".
environment
dictionary
Default:
{}
Dictionary of environment variables and their values to use when executing commands.
remote_tmp
string
Default:
"%TEMP%"
ini entries:

[powershell]
remote_tmp = %TEMP%

var: ansible_remote_tmp
Temporary directory to use on targets when copying files to the host.
set_module_language
boolean
    Choices:
  • no ←
  • yes
Controls if we set the locale for modules when executing on the target.
Windows only supports no as an option.