vicfg-user - manage users
vicfg-user <[conn_options>] -e <user> |-o <add | modify | delete | list> [options]
Note: The syntax of this command differs from other vSphere CLI commands.
An ESX/ESXi system grants access to its resources when a known user with appropriate permissions logs on to the system with a password that matches the one stored for that user. The vicfg-user command supports creating, modifying, deleting, and listing local direct access users on an ESX/ESXi host. You cannot run this command against a vCenter Server system.
User management is discussed in detail in the vSphere Security publication.
vicfg-user --help
for a list of all connection options.
add
, modify
, delete
, or list
. When you list users, the command returns a maximum of 100 users.
admin
, read-only
, or no-access
.
yes
and no
.
The following examples assume you are specifying connection options, either
explicitly or, for example, by specifying the server, user name, and password.
Run vicfg-user --help
for a list of common options including connection options.
Add a user with login ID user27:
vicfg-user <conn_options> -e user -o add -l user27 -p 27_password
Modify password, user ID, and user name for the user with login ID user27:
vicfg-user.pl <conn_options> -e user -o modify -l user27 -p 27_password -i <new user id> -n <new user name>
Assign the role read-only to user27 and prompt for a password.
vicfg-user <conn_options> -e user -o modify -l user27 --role read-only --promptpassword
Remove the user with user name user27:
vicfg-user <conn_options> -e user -o delete -l user27