ansible.builtin.cmd shell – Windows 命令提示符

注意

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

Ansible 2.8 中的新增功能

概要

  • 与“ssh”连接插件一起使用，并且在 Windows 主机上未设置 DefaultShell。

参数

参数

注释

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

environment

列表 / 元素=字典

执行命令时要使用的环境变量及其值的字典列表。

默认值： [{}]

remote_tmp

字符串

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

默认值： "%TEMP%"

配置

  • INI 条目

    [powershell]
remote_tmp = %TEMP%

  • 变量：ansible_remote_tmp

set_module_language

布尔值

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

Windows 仅支持 no 作为选项。

选项

  • false ← (默认)

  • true

提示

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