U Commands

This chapter describes the Cisco Nexus 1000V commands that begin with the letter U.

username

To create and configure a user account, use the username command. To remove a user account, use the no form of this command.

username user-id [expire date] [password [0 | 5] password] [role role-name]

username user-id [sshkey {key | file filename}]

no username user-id

Syntax Description

user-id

User identifier for the user account. The user-id argument is a case-sensitive, alphanumeric character string with a maximum length of 28 characters.

Note The NX-OS software does not allowed the "#" and "@" characters in the user-id argument text string.

expire date

(Optional) Specifies the expire date for the user account. The format for the date argument is YYYY-MM-DD.

password

(Optional) Specifies a password for the account. The default is no password.

0

(Optional) Specifies that the password is in clear text. Clear text passwords are encrypted before they are saved to the running configuration.

5

(Optional) Specifies that the password is in encrypted format. Encrypted passwords are not changed before they are saved to the running configuration.

password

Password string. The password is alphanumeric, case sensitive, and has a maximum of 64 characters.

Note Clear text passwords cannot include the dollar sign ($) special character.

role role-name

(Optional) Specifies the user role. The role-name argument is case sensitive.

sshkey

(Optional) Specifies an SSH key for the user account.

key

SSH key string.

file filename

Specifies the name of a file that contains the SSH key string.


Defaults

Unless specified, usernames have is no expire date, password, or SSH key.

The default role is the admin user role.

You cannot delete the default admin user role. Also, you cannot change the expire date or remove the network-admin role for the default admin user role.

Command Modes

Global Configuration (config)

Supported User Roles

network-admin

Command History

Release
Modification

4.0(4)SV1(1)

This command was introduced.


Usage Guidelines

The NX-OS software accepts only strong passwords when you have password-strength checking enabled using the password strength-check command. The characteristics of a strong password include the following:

•At least eight characters long

•Does not contain many consecutive characters (such as "abcd")

•Does not contain many repeating characters (such as "aaabbb")

•Does not contain dictionary words

•Does not contain proper names

•Contains both uppercase and lowercase characters

•Contains numbers

Caution If you do not specify a password for the user account, the user might not be able to log in to the account.

Examples

This example shows how to create a user account with a password and a user role: 

n1000v# config t

n1000v(config)# username user1 password Ci5co321 role network-admin

This example shows how to configure the SSH key for a user account: 

n1000v# config t

n1000v(config)# username user1 sshkey file bootflash:key_file

Related Commands

Command
Description

password strength-check

Checks the password security strength.

show user-account

Displays the user account configuration.