role name

Creates or modifies a non-default role.

Syntax

role name role_name [ desc description ]
no role name role_name [ desc description ]

Parameters

role_name
Specifies the name of the role.
desc description
Specifies an optional role description.

Modes

Global configuration mode

Usage Guidelines

For each role that you create, you define one or more rules. Each user is associated with one—and only one—role.

Role names are from 4 through 32 characters, must begin with a letter, and can contain alphanumeric characters and underscores. The name cannot be same as that of an existing user.

The description field supports up to 64 characters and can include any printable ASCII character, except for the following characters: single quotation mark (‘), double quotation mark ("), exclamation point (!), colon (:), and semi-colon (;). If the description contains spaces, enclose the text in double quotation marks.

The maximum number of roles supported is 64, including the user and admin default roles.

To delete a role description, enter no role name role_name desc.

To delete a role, enter no role name role_name.

Examples

The following example creates a role.

device# configure terminal
device(config)# role name tempAdmin desc "Daily admin functions"

The following example deletes the role.

device# configure terminal
device(config)# no role name tempAdmin