vicfg-nics

By | 2012-03-31

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

switchdescription
–auto | -aSets 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 | -sSets 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.

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

Author: dwirch

Derek Wirch is a seasoned IT professional with an impressive career dating back to 1986. He brings a wealth of knowledge and hands-on experience that is invaluable to those embarking on their journey in the tech industry.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.