users command

Use this command to access all user accounts and their authority levels.

The users command is also used to create new user accounts and modify existing accounts. Running the users command with no options displays a list of users and some basic user information. The following table shows the arguments for the options.

Table 1. users command.
The following table is a multi-row three column table consisting of the options, option descriptions, and associated values for the options.
Option	Description	Values
-user_index	User account index number	1 through 12, inclusive, or all for all users.
-n	User account name	Unique string containing only numbers, letters, periods, and underscores. Minimum of 4 characters and maximum of 16 characters.
-p	User account password	String that contains at least one alphabetic and one non-alphabetic character. Minimum of 6 characters and maximum of 20 characters. Null creates an account without a password that the user must set during their first login.
-a	User authority level	super, ro, custom Where: super (supervisor) ro (read only) custom is followed by a colon and list of values that are separated by a pipe (\|), of the form custom:am\|rca. These values can be used in any combination. am (user account management access) rca (remote console access) rcvma (remote console and virtual media access) pr (remote server power/restart access) cel (ability to clear event logs) bc (adapter configuration - basic) nsc (adapter configuration - network and security) ac (Adapter configuration - advanced)
-ep	Encryption password (for backup/restore)	Valid password
-clear	Erase specified user account	User account index number to erase must be specified, following the form: users -clear -user_index
-curr	Display users currently logged in
-sauth	SNMPv3 authentication protocol	HMAC-SHA, none
-spriv	SNMPv3 privacy protocol	CBC-DES, AES, none
-spw	SNMPv3 privacy password	Valid password
-sepw	SNMPv3 privacy password (encrypted)	Valid password
-sacc	SNMPv3 access type	get, set
-strap	SNMPv3 trap hostname	Valid hostname
-pk	Display SSH public key for user	User account index number. Note Each SSH key assigned to the user is displayed, along with an identifying key index number. When using the SSH public key options, the -pk option must be used after the user index (-userindex option), of the form: users -2 -pk. All keys are in OpenSSH format.
-e	Display entire SSH key in OpenSSH format (SSH public key option)	This option takes no arguments and must be used exclusive of all other users -pk options. Note When using the SSH public key options, the -pk option must be used after the user index (-userindex option), of the form: users -2 -pk -e.
-remove	Remove SSH public key from user (SSH public key option)	Public key index number to remove must be given as a specific -key_index or -all for all keys assigned to the user. Note When using the SSH public key options, the -pk option must be used after the user index (-userindex option), of the form: users -2 -pk -remove -1.
-add	Add SSH public key for user (SSH public key option)	Quote-delimited key in OpenSSH format Note The -add option is used exclusive of all other users -pk command options. When using the SSH public key options, the -pk option must be used after the user index (-userindex option), of the form: users -2 -pk -add "AAAAB3NzC1yc2EAAAABIwAAA QEAvfnTUzRF7pdBuaBy4dO/aIFasa/Gtc+o/wlZnuC4aD HMA1UmnMyLOCiIaNOy4OOICEKCqjKEhrYymtAoVtfKApv Y39GpnSGRC/qcLGWLM4cmirKL5kxHNOqIcwbT1NPceoKH j46X7E+mqlfWnAhhjDpcVFjagM3Ek2y7w/tBGrwGgN7DP HJU1tzcJy68mEAnIrzjUoR98Q3/B9cJD77ydGKe8rPdI2 hIEpXR5dNUiupA1Yd8PSSMgdukASKEd3eRRZTBl3SAtMu cUsTkYjlXcqex1OQz4+N50R6MbNcwlsx+mTEAvvcpJhug a70UNPGhLJMl6k7jeJiQ8Xd2p XbOZQ=="
-upld	Upload an SSH public key (SSH public key option)	Requires the -i and -l options to specify key location. Note The -upld option is used exclusive of all other users -pk command options (except for -i and -l). To replace a key with a new key, you must specify a -key_index. To add a key to the end of the list of current keys, do not specify a key index. When using the SSH public key options, the -pk option must be used after the user index (-userindex option), of the form: users -2 -pk -upld -i tftp://9.72.216.40/ -l file.key.
-dnld	Download the specified SSH public key (SSH public key option)	Requires a -key_index to specify the key to download and the -i and -l options to specify the download location on another computer running a TFTP server. Note The -dnld option is used exclusive of all other users -pk command options (except for -i, -l, and -key_index). When using the SSH public key options, the -pk option must be used after the user index (-userindex option), of the form: users -2 -pk -dnld -1 -i tftp://9.72.216.40/ -l file.key.
-i	IP address of TFTP/SFTP server for uploading or downloading a key file (SSH public key option)	Valid IP address Note The -i option is required by the users -pk -upld and users -pk -dnld command options.
-pn	Port number of TFTP/SFTP server (SSH public key option)	Valid port number (default 69/22) Note An optional parameter for the users -pk -upld and users -pk -dnld command options.
-u	User name for SFTP server (SSH public key option)	Valid user name Note An optional parameter for the users -pk -upld and users -pk -dnld command options.
-pw	Password for SFTP server (SSH public key option)	Valid password Note An optional parameter for the users -pk -upld and users -pk -dnld command options.
-l	File name for uploading or downloading a key file via TFTP or SFTP (SSH public key option)	Valid file name Note The -l option is required by the users -pk -upld and users -pk -dnld command options.
-af	Accept connections from host (SSH public key option)	A comma-separated list of hostnames and IP addresses, limited to 511 characters. Valid characters include: alphanumeric, comma, asterisk, question mark, exclamation point, period, hyphen, colon and percent sign.
-cm	Comment (SSH public key option)	Quote-delimited string of up to 255 characters. Note When using the SSH public key options, the -pk option must be used after the user index (-userindex option), of the form: users -2 -pk -cm "This is my comment.".

Syntax:

users [<em className="ph i">options</em>]
 options:
   -<em className="ph i">user_index</em>
   -n <em className="ph i">username</em>
   -p <em className="ph i">password</em>
   -a <em className="ph i">authority_level</em>
   -ep <em className="ph i">encryption_password</em>
   -clear
   -curr
   -sauth <em className="ph i">protocol</em>
   -spriv <em className="ph i">protocol</em>
   -spw <em className="ph i">password</em>
   -sepw <em className="ph i">password</em>
   -sacc <em className="ph i">state</em>
   -strap <em className="ph i">hostname</em>

users -pk [<em className="ph i">options</em>]
 options:
   -e
   -remove <em className="ph i">index</em>
   -add <em className="ph i">key</em>
   -upld
   -dnld
   -i <em className="ph i">ip_address</em>
   -pn <em className="ph i">port_number</em>
   -u <em className="ph i">username</em>
   -pw <em className="ph i">password</em>
   -l <em className="ph i">filename</em>
   -af <em className="ph i">list</em>
   -cm <em className="ph i">comment</em>

Example:

system> users
1. USERID Read/Write 
Password Expires: no expiration
2. manu Read Only 
Password Expires: no expiration
3. eliflippen Read Only 
Password Expires: no expiration
4.  <not used>
5. jacobyackenovic custom:cel|ac 
Password Expires: no expiration 
system> users -7 -n sptest -p PASSW0RD -a custom:am|rca|cel|nsc|ac 
ok 
system> users
1. USERID  Read/Write
Password Expires: no expiration
2. test    Read/Write
Password Expires: no expiration
3. test2   Read/Write
Password Expires: no expiration
4. <not used>
5. jacobyackenovic custom:cel|ac 
Password Expires: no expiration 
6. <not used>
7. sptest  custom:am|rca|cel|nsc|ac
Password Expires: no expiration
8. <not used>
9. <not used>
10. <not used>
11. <not used>
12. <not used>
system>

Give feedback