Table Of Contents
U Commands
username
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)# username user1 password Ci5co321 role network-admin
This example shows how to configure the SSH key for a user account:
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.
|