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

提示

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