powershell – Windows PowerShell

Synopsis

  • The only option when using ‘winrm’ or ‘psrp’ as a connection plugin.
  • Can also be used when using ‘ssh’ as a connection plugin and the DefaultShell has been configured to PowerShell.

Parameters

Parameter Choices/Defaults Configuration Comments
async_dir
-
added in 2.8
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
-
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 moduels when executing on the target.
Windows only supports no as an option.

Status

Authors

  • UNKNOWN

Hint

If you notice any issues in this documentation, you can edit this document to improve it.

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.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/plugins/shell/powershell.html