Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

users

 

Syntax

Description

This command manages users, user passwords, and user group affiliations. If the specified user does not exist, the user is created.

Note

You must have superuser privileges to use this command.

Options

Parameter

Description

Range

Default Value

users username

The username of the account

Note: The system is installed with one predefined user called admin, which cannot be removed.

4 to 30 alphanumeric characters

None

password "password"

The password required to access the account.

This parameter is mandatory if you are creating a new user.

All alphanumeric and special characters. Since passwords are stored in digest form, there is no pre-determined limit on the length of the password.

Note: Use quotation marks around the password. See usage guidelines below.

None

group group

The group (or role) associated with the specified user.

This parameter is mandatory if you are creating a new user.

  • provisioning: Ability to configure the system but lacks the ability to manage other users

  • superuser: Full system access.

  • surveillance: Allowed to monitor system activity. This group does not have configuration privilege.

  • btiuser: Deprecated, do not use.

None

Additional Information

There are two methods to enter the password:

  • In clear text on the command line with enclosing quotation marks. If the password contains a quotation mark ("), then use the escape backslash (\) immediately preceding the quotation mark.

  • In hidden text via the interactive prompt. When you create a new user without specifying a password, the system prompts you for the password. Enter the password without the enclosing quotation marks.

See Inputting Character Strings and Passwords for information on entering special characters.

Required Privilege Level

Related Documentation

  • show running-config users

Sample Output

The following example creates the user user with password abc123\!@#def.

bti7800(config)# users user group superuser password "abc123\!@#def"

The following example creates the user user with password abc#123"def.

bti7800(config)# users user group superuser password "abc#123\"def"