NAME

vicfg-nics - get information, set speed and duplex for ESX/ESXi physical NICs


SYNOPSIS

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


DESCRIPTION

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.


OPTIONS

--auto | -a <nic>

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] <nic>

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 <speed> <nic>

Sets the speed at which a given network adapter should run. Valid values for <speed> 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, 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 <conn_options> -l

Set vmknic02 to auto-negotiate its speed and duplex settings:

 vicfg-nics <conn_options> -a vmnic02

Set the duplex setting for vmnic0 to full and the speed to 100:

 vicfg-nics <conn_options> -d full -s 100 vmnic0