ansible.builtin.cmd shell – Windows Command Prompt

Note

This shell plugin is part of ansible-core and included in all Ansible installations. In most cases, you can use the short plugin name cmd even without specifying the collections: keyword. However, we recommend you use the FQCN for easy linking to the plugin documentation and to avoid conflicting with other collections that may have the same shell plugin 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

Comments

async_dir

string

added in 2.8 of ansible.builtin

Directory in which ansible will keep async job information.

Before Ansible 2.8, this was set to remote_tmp + "\.ansible_async".

Default: “%USERPROFILE%\\.ansible_async”

Configuration:

  • INI entry:

    [powershell]
    async_dir = %USERPROFILE%\.ansible_async
    
  • Variable: ansible_async_dir

environment

list / elements=dictionary

List of dictionaries of environment variables and their values to use when executing commands.

Default: [{}]

remote_tmp

string

Temporary directory to use on targets when copying files to the host.

Default: “%TEMP%”

Configuration:

  • INI entry:

    [powershell]
    remote_tmp = %TEMP%
    
  • Variable: ansible_remote_tmp

set_module_language

boolean

Controls if we set the locale for modules when executing on the target.

Windows only supports no as an option.

Choices:

  • no ← (default)

  • yes

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.