community.network.pn_role 模块 – 用于创建/删除/修改角色的 CLI 命令

注意

此模块是 community.network 集合 (版本 5.1.0) 的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.network。

要在剧本中使用它，请指定： community.network.pn_role。

注意

community.network 集合已弃用，并将从 Ansible 12 中移除。有关更多信息，请参阅 讨论主题。

已弃用

在以下版本中移除：

6.0.0 版本

原因：

此集合及其中的所有内容均未维护且已弃用。

替代方案：

未知。

概要

  • 此模块可用于创建、删除和修改用户角色。

别名：network.netvisor.pn_role

参数

参数

注释

pn_access

字符串

访问类型。

选项

  • "只读"

  • "读写"

pn_cliswitch

字符串

运行 CLI 的目标交换机。

pn_delete_from_users

布尔值

从用户中删除。

选项

  • false

  • true

pn_name

字符串 / 必需

角色名称。

pn_running_config

布尔值

显示交换机的运行配置。

选项

  • false

  • true

pn_scope

字符串

本地或结构。

选项

  • "本地"

  • "结构"

pn_shell

布尔值

允许 shell 命令。

选项

  • false

  • true

pn_sudo

布尔值

允许从 shell 使用 sudo。

选项

  • false

  • true

state

字符串 / 必需

要执行的操作的状态。使用 present 创建角色，使用 absent 删除角色，使用 update 修改角色。

选项

  • "present"

  • "absent"

  • "update"

示例

- name: Role create
  community.network.pn_role:
    pn_cliswitch: 'sw01'
    state: 'present'
    pn_name: 'foo'
    pn_scope: 'local'
    pn_access: 'read-only'

- name: Role delete
  community.network.pn_role:
    pn_cliswitch: 'sw01'
    state: 'absent'
    pn_name: 'foo'

- name: Role modify
  community.network.pn_role:
    pn_cliswitch: 'sw01'
    state: 'update'
    pn_name: 'foo'
    pn_access: 'read-write'
    pn_sudo: true
    pn_shell: true

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键

描述

changed

布尔值

指示 CLI 是否对目标造成更改。

返回：始终

command

字符串

在目标节点上运行的 CLI 命令。

返回：始终

stderr

列表 / 元素=字符串

角色命令的一组错误响应。

返回：发生错误时

stdout

列表 / 元素=字符串

角色命令的一组响应。

返回：始终

状态

  • 此模块将在 6.0.0 版本中移除。[已弃用]

  • 有关更多信息，请参见 已弃用。

作者

  • Pluribus Networks (@rajaspachipulusu17)