esxcfg-vswitch

Section: Maintenance Commands (8)
Index Return to Main Contents

BSD mandoc
VMware ESX 4.0  

NAME

esxcfg-vswitch - VMware ESX Virtual Switch Configuration tool  

SYNOPSIS

esxcfg-vswitch OPTIONS [VSWITCH]  

DESCRIPTION

esxcfg-vswitch provides an interface for adding, removing, and modifying virtual switches and their settings. By default, there is a single virtual switch called vSwitch0.  

OPTIONS

-a -add
Add a new virtual switch to the system. It requires a virtual switch name to be provided.
-d -delete
Delete a virtual switch. This will fail if any ports on the virtual switch are still in use by VMkernel networks, vswifs, or VMs.
-l -list
List all virtual switches and their portgroups.
-L -link
Add an uplink to a virtual switch. This will attach a new unused physical NIC to a virtual switch.
-U -unlink
Remove an uplink from a virtual switch. This will remove a NIC from the uplink list of a virtual switch. If it is the last uplink, physical network connectivity for that switch will be lost.
-R -restore-uplinks
Restore uplinks for all virtual switches from config file. This will restore all uplinks for each virtual switch from configurtion file. INTERNAL USE ONLY.
-M -add-pg-uplink
Add an uplink to the list of uplinks for a portgroup
-N -del-pg-uplink
Delete an uplink from the list of uplinks for a portgroup
-P -add-dvp-uplink
Add an uplink to a DVPort on a DVSwitch. Must specify --dvp in the same commnad.
-Q -del-dvp-uplink
Delete an uplink from a DVPort on a DVSwitch. Must specify --dvp in the same commnad.
-p -pg
Provide the name of the portgroup. For the '--vlan' option, "ALL" can be specified to operate on all portgroups of a virtual switch.
-V -dvp
Provide the DVPort ID of a DVSwitch.
-v -vlan
Set the VLAN ID for a specific portgroup of a virtuals switch Using the option "0" will disable VLAN for this portgroup. Requires that the --pg option is also specified.
-c -check
Check to see if a virtual switch exists. The program prints a "1" if it exists; otherwise it prints "0".
-A -add-pg
Add a new portgroup to a virtual switch with the given name.
-D -del-pg
Delete a portgroup. This operation will fail if the portgroup is in use.
-C -check-pg
Check whether the specified name is in use for a portgroup. Prints "1" if the name is in use, prints "0" otherwise.
-B -set-cdp
Set the CDP status for a given virtual switch. To set pass one of "down", "listen", "advertise", "both".
-b -get-cdp
Print the current CDP setting for this switch.
-X -set-maxactive
Set the max active uplinks for the virtual switch.
-x -get-maxactive
Get the max active uplinks for the virtual switch.
-m -mtu
Set the MTU for the vswitch. This affects all the NICs attached to the vswitch.
-r -restore
Used at system startup to restore configuration. INTERNAL USE ONLY.
-h -help
Print a simple help message.

 

EXAMPLES

Add a Virtual Switch:

esxcfg-vswitch \fIOPTIONS [VSWITCH]\fR --add vSwitch1

Add a Portgroup to vSwitch0:

esxcfg-vswitch \fIOPTIONS [VSWITCH]\fR --add-pg="New Portgroup" vSwitch0  

COPYRIGHT

VMware ESX is Copyright 1998-2009 VMware, Inc. All rights reserved.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
COPYRIGHT

This document was created by man2html, using the manual pages. Brought to you by Bouke Groenescheij, www.jume.nl
Time: 15:25:08 GMT, May 26, 2009