ansible.builtin.runas become – 以用户身份运行

注意

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

Ansible 2.8 中的新功能

概要

  • 此 become 插件允许您的远程/登录用户通过 windows runas 功能以其他用户身份执行命令。

参数

参数

注释

become_flags

字符串

传递给 runas 的选项，一个以空格分隔的 k=v 对列表

默认值： ""

配置

  • INI 条目

    [privilege_escalation]
become_flags = ""

    [runas_become_plugin]
flags = ""

  • 环境变量：ANSIBLE_BECOME_FLAGS

  • 环境变量：ANSIBLE_RUNAS_FLAGS

  • 变量：ansible_become_flags

  • 变量：ansible_runas_flags

  • 关键字：become_flags

become_pass

字符串

密码

配置

  • INI 条目

    [runas_become_plugin]
password = VALUE

  • 环境变量：ANSIBLE_BECOME_PASS

  • 环境变量：ANSIBLE_RUNAS_PASS

  • 变量：ansible_become_password

  • 变量：ansible_become_pass

  • 变量：ansible_runas_pass

become_user

字符串 / 必需

您“成为”以执行任务的用户

配置

  • INI 条目

    [privilege_escalation]
become_user = VALUE

    [runas_become_plugin]
user = VALUE

  • 环境变量：ANSIBLE_BECOME_USER

  • 环境变量：ANSIBLE_RUNAS_USER

  • 变量：ansible_become_user

  • 变量：ansible_runas_user

  • 关键字：become_user

备注

注意

  • runas 实际上是在 powershell 模块处理程序中实现的，因此只能与 winrm 连接一起使用。

  • 此插件会忽略“become_exe”设置，因为它使用的是 API 而不是可执行文件。

  • 必须运行辅助登录服务 (seclogon) 才能使用 runas

作者

  • ansible (@core)

提示

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