Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All
     

    Related Documentation

    • show running-config users
     

    users

    Syntax

    [no] users username { password "password" | group group }

    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"

    Modified: 2017-04-25