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

注意

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

Ansible 2.8 中的新增功能

摘要

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

参数

参数

注释

become_flags

字符串

传递给 runas 的选项,一个用空格分隔的键值对列表

默认值: ""

配置

  • 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)

提示

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