ansible.builtin.powershell shell – Windows PowerShell

注意

此 shell 插件是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，您可以使用简短的插件名称 powershell。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.powershell，以便轻松链接到插件文档并避免与可能具有相同 shell 插件名称的其他集合发生冲突。

概要

  • 当使用“winrm”或“psrp”作为连接插件时，唯一的选项。

  • 当使用“ssh”作为连接插件并且 DefaultShell 已配置为 PowerShell 时，也可以使用。

别名：formerly_core_powershell

参数

参数

注释

async_dir

字符串

在 Ansible 2.8 中添加

Ansible 将在其中保留异步作业信息的目录。

在 Ansible 2.8 之前，此设置为 remote_tmp + "\.ansible_async"。

默认值： "%USERPROFILE%\\.ansible_async"

配置

  • INI 条目

    [powershell]
async_dir = %USERPROFILE%\.ansible_async

  • 变量：ansible_async_dir

remote_tmp

字符串

将文件复制到主机时，在目标上使用的临时目录。

默认值： "%TEMP%"

配置

  • INI 条目

    [powershell]
remote_tmp = %TEMP%

  • 变量：ansible_remote_tmp

set_module_language

布尔值

控制在目标上执行模块时是否设置模块的区域设置。

Windows 仅支持 no 作为选项。

选项

  • false ← (默认)

  • true

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。