Get information, set speed and duplex for ESX/ESXi physical NICs. The vicfg-nics command manages uplink adapters, that is, the Ethernet switches used by an ESX/ESXi host. You can use vicfg-nics to list the VMkernel name for the uplink adapter, its PCI ID, driver, link state, speed, duplex setting, MAC address and a short PCI description of the card. You can also specify speed and duplex settings for an uplink adapter.
Syntax
vicfg-nics --auto vicfg-nics --duplex [full|half] vicfg-nics --help vicfg-nics --list vicfg-nics --speed [10 | 100 | 1000 | 10000] vicfg-nics --vihost ]
Keys
switch | description |
–auto | -a | Sets the NIC to auto-negotiate its speed and duplex settings Requires a NIC parameter. |
connection_options | Specifies the target server and authentication information if required. Run vicfg-nics –help for a list of all connection options. |
–duplex | -d [full|half] | Sets the duplex value at which a given network adapter should run to either full (transmit data in both directions at the same time) or half (transmit data in one direction at a time). Requires a NIC parameter. |
–help | Prints a help message for each command-specific and each connection option. Calling the script with no arguments or with –help has the same effect. |
–list | -l | Lists the NICs in the system and, for each NIC, the PCI bus, driver, speed, duplex information, MAC address, and a description. Also shows whether the link is up. |
–speed | -s | Sets the speed at which a given network adapter should run. Valid values for are 10, 100, 1000, or 10000. Requires a NIC parameter. |
–vihost | -h | When you run a vCLI command with the –server option pointing to a vCenter Server system, use –vihost to specify the ESX/ESXi host to run the command against. |
Examples
The following examples assume you are specifying connection options, either explicitly or, for example, by specifying the server, username, and password. Run vicfg-nics –help for a list of common options including connection options. List the NICs in the system and print their current and configured speed and duplex settings:
vicfg-nics -l
Set vmknic02 to auto-negotiate its speed and duplex settings:
vicfg-nics -a vmnic02
Set the duplex setting for vmnic0 to full and the speed to 100:
vicfg-nics -d full -s 100 vmnic0