6.5
Table Of Contents
- vSphere Command-Line Interface Concepts and Examples
- Contents
- About This Book
- vSphere CLI Command Overviews
- Introduction
- List of Available Host Management Commands
- Targets and Protocols for vCLI Host Management Commands
- Supported Platforms for vCLI Commands
- Commands with an esxcfg Prefix
- ESXCLI Commands Available on Different ESXi Hosts
- Trust Relationship Requirement for ESXCLI Commands
- Using ESXCLI Output
- Connection Options for vCLI Host Management Commands
- Connection Options for DCLI Commands
- vCLI Host Management Commands and Lockdown Mode
- Managing Hosts
- Managing Files
- Managing Storage
- Introduction to Storage
- Examining LUNs
- Detach a Device and Remove a LUN
- Reattach a Device
- Working with Permanent Device Loss
- Managing Paths
- Managing Path Policies
- Scheduling Queues for Virtual Machine I/O
- Managing NFS/NAS Datastores
- Monitor and Manage FibreChannel SAN Storage
- Monitoring and Managing Virtual SAN Storage
- Monitoring vSphere Flash Read Cache
- Monitoring and Managing Virtual Volumes
- Migrating Virtual Machines with svmotion
- Configuring FCoE Adapters
- Scanning Storage Adapters
- Retrieving SMART Information
- Managing iSCSI Storage
- iSCSI Storage Overview
- Protecting an iSCSI SAN
- Command Syntax for esxcli iscsi and vicfg-iscsi
- iSCSI Storage Setup with ESXCLI
- iSCSI Storage Setup with vicfg-iscsi
- Listing and Setting iSCSI Options
- Listing and Setting iSCSI Parameters
- Enabling iSCSI Authentication
- Set Up Ports for iSCSI Multipathing
- Managing iSCSI Sessions
- Managing Third-Party Storage Arrays
- Managing Users
- Managing Virtual Machines
- Managing vSphere Networking
- Introduction to vSphere Networking
- Retrieving Basic Networking Information
- Troubleshoot a Networking Setup
- Setting Up vSphere Networking with vSphere Standard Switches
- Setting Up Virtual Switches and Associating a Switch with a Network Interface
- Retrieving Information About Virtual Switches
- Adding and Deleting Virtual Switches
- Checking, Adding, and Removing Port Groups
- Managing Uplinks and Port Groups
- Setting the Port Group VLAN ID
- Managing Uplink Adapters
- Adding and Modifying VMkernel Network Interfaces
- Managing VMkernel Network Interfaces with ESXCLI
- Add and Configure an IPv4 VMkernel Network Interface with ESXCLI
- Add and Configure an IPv6 VMkernel Network Interface with ESXCLI
- Managing VMkernel Network Interfaces with vicfg-vmknic
- Add and Configure an IPv4 VMkernel Network Interface with vicfg-vmknic
- Add and Configure an IPv6 VMkernel Network Interface with vicfg-vmknic
- Setting Up vSphere Networking with vSphere Distributed Switch
- Managing Standard Networking Services in the vSphere Environment
- Setting the DNS Configuration
- Manage an NTP Server
- Manage the IP Gateway
- Setting Up IPsec
- Manage the ESXi Firewall
- Monitor VXLAN
- Monitoring ESXi Hosts
- Index
vicfg-user Command Syntax
The vicfg-user syntax diers from other vCLI commands.
You specify operations by using the following syntax.
vicfg-user <conn_options> -e <user> -o <add|modify|delete|list>
If you create a user without specifying the role (--role), the user has no permissions. You cannot change the
user's role, you can only change the user's permission.
I You cannot use the vicfg-user command to modify users created with the vSphere Client in
vSphere 6.0 or earlier.
Options
The vicfg-user command-specic options manipulate users. You must also specify connection options. See
“Connection Options for vCLI Host Management Commands,” on page 19.
Option Description
--adduser <user_list>
-u <user_list>
Adds the specied users. Takes a comma-separated list of users.
--entity <user>
-e <user>
Entity to perform the operation on. Starting with vSphere 5.1, entity is
always user.
--login <login_id>
-l <login_id>
Login ID of the user.
--newpassword <p_wd>
-p <p_wd>
Password for the target user.
--newuserid <UUID>
-i <UUID>
New UUID for the target user.
--newusername <name>
-n <name>
New user name for the target user.
--operation
-o
Operation to perform. Specify add, modify, delete, or list.
--role <admin|read-only|no-
access>
-r <admin|read-only|no-access>
Role for the target user. Specify one of admin, read-only, or no-access.
Users that you create without assigning permissions have no permissions.
--shell
-s
Grant shell access to the target user. Default is no shell access. Use this
command to change the default or to revoke shell access rights after they
have been granted.
Valid values are yes and no.
This option is not supported against vSphere 5.0 systems. The option is
supported only against ESX. The option is not supported against ESXi.
Managing Users with vicfg-user
A user is an individual authorized to log in to an ESXi or vCenter Server system.
vSphere does not explicitly restrict users with the same authentication credentials from accessing and taking
action within the vSphere environment simultaneously.
vSphere Command-Line Interface Concepts and Examples
118 VMware, Inc.