cisco.ise.personas_update_roles_services module – Update the roles and services of a node

Note

This module is part of the cisco.ise collection (version 2.5.2).

To install it, use: ansible-galaxy collection install cisco.ise. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: cisco.ise.personas_update_roles_services.

New in version 2.4.0: of cisco.ise

Synopsis

  • Update the roles and services of a node

Note

This module has a corresponding action plugin.

Requirements

The below requirements are needed on the host that executes this module.

  • requests >= 2.25.1

  • python >= 3.5

Parameters

Parameter

Comments

hostname

string

The hostname of the node.

ip

string

The IP address of the node to be updated.

ise_verify

boolean

Whether or not to verify the identity of the node.

Choices:

  • false

  • true

ise_version

string

The version of the ISE node.

ise_wait_on_rate_limit

boolean

Whether or not to wait on rate limit

Choices:

  • false

  • true

password

string

The password to log into the node.

roles

list / elements=string

The roles to be fulfilled by this node. Possible roles are PrimaryAdmin, SecondaryAdmin, PrimaryMonitoring, SecondaryMonitoring, PrimaryDedicatedMonitoring, SecondaryDedicatedMonitoring, Standalone

services

list / elements=string

The services this node will run. Possible services are Session, Profiler, TC-NAC, SXP, DeviceAdmin, PassiveIdentity, pxGrid, pxGridCloud

username

string

The username to log into the node.

Notes

Note

  • Does not support check_mode

See Also

See also

cisco.ise.plugins.modules.personas_update_roles_services

The official documentation on the cisco.ise.plugins.modules.personas_update_roles_services module.

Examples

- name: Remove the Primary Monitoring role and the Session and Profiler services from the primary node
  cisco.ise.personas_update_roles_services:
    ip: 10.1.1.1
    username: admin
    password: C1sco123
    hostname: ise-pan-server-1
    roles:
      - PrimaryAdmin
    services: []

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

ise_response

string

A string stating that the node was successfully updated

Returned: always

Sample: “Node ise-pan-server-1 updated successfully”

Authors

  • Rafael Campos (@racampos)