pn_role – CLI command to create/delete/modify role
pn_role – CLI command to create/delete/modify role
New in version 2.8.
Synopsis
- This module can be used to create, delete and modify user roles.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
pn_access string |
|
type of access. |
pn_cliswitch string |
Target switch to run the CLI on. | |
pn_delete_from_users boolean |
|
delete from users. |
pn_name string / required |
role name. | |
pn_running_config boolean |
|
display running configuration of switch. |
pn_scope string |
|
local or fabric. |
pn_shell boolean |
|
allow shell command. |
pn_sudo boolean |
|
allow sudo from shell. |
state string / required |
|
State the action to perform. Use |
Examples
- name: Role create
pn_role:
pn_cliswitch: 'sw01'
state: 'present'
pn_name: 'foo'
pn_scope: 'local'
pn_access: 'read-only'
- name: Role delete
pn_role:
pn_cliswitch: 'sw01'
state: 'absent'
pn_name: 'foo'
- name: Role modify
pn_role:
pn_cliswitch: 'sw01'
state: 'update'
pn_name: 'foo'
pn_access: 'read-write'
pn_sudo: true
pn_shell: true
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
changed boolean |
always |
indicates whether the CLI caused changes on the target.
|
command string |
always |
the CLI command run on the target node.
|
stderr list |
on error |
set of error responses from the role command.
|
stdout list |
always |
set of responses from the role command.
|
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Pluribus Networks (@rajaspachipulusu17)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/pn_role_module.html