Posted On 2012-03-31 by dwirch
Tags: VMWare Products Tutorial Glossary ESX
Views: 1352

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.


vicfg-nics --auto <nic>
vicfg-nics --duplex [full|half] <nic>
vicfg-nics --help
vicfg-nics --list
vicfg-nics --speed [10 | 100 | 1000 | 10000] <nic>
vicfg-nics --vihost <esx_host>]


--auto | -a Sets the NIC to auto-negotiate its speed and duplex settings Requires a NIC parameter.
connection_optionsSpecifies 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.
--helpPrints 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 | -lLists 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 | -hWhen 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.


The following examples assume you are specifying connection options, either explicitly or, for example, by specifying the server, user name, 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

About the Author

dwirch has posted a total of 190 articles.

Comments On This Post

No comments on this post yet!

Do you have a thought relating to this post? You can post your comment here. If you have an unrelated question, you can use the Q&A section to ask it.

Or you can drop a note to the administrators if you're not sure where you should post.

Your IP address is:

Before you can post, you need to prove you are human. If you log in, this test goes away.

Code Links