6.0

Table Of Contents
Getting Started with vSphere Command-Line Interfaces
118 VMware, Inc.
Whenworkingwithvirtualswitchesandportgroups,performthefollowingtasks:
1Findoutwhichvirtualswitchesareavailableand(optionally)whattheassociatedMTUandCDP(Cisco
DiscoveryProtocol)settingsare.See“RetrievingInformationaboutVirtualSwitcheswithESXCLI”on
page 118and“RetrievingInformationaboutVirtualSwitcheswithvicfgvswitch”
onpage 118.
2Addavirtualswitch.See“A d d i n g andDeletingVirtualSwitcheswithESXCLI”onpage 119and“A d d i n g
andDeletingVirtualSwitcheswithvicfgvswitch”onpage 119.
3Foranewlyaddedswitch,performthesetasks:
aAddaportgroup.See“ManagingPortGroupswithESXCLI”onpage 120and“ManagingPort
Groupswith
vicfgvswitch”onpage 120.
b (Optional)SettheportgroupVLANID.See“SettingthePortGroupVLANIDwithESXCLI”on
page 121and“SettingthePortGroupVLANIDwithvicfgvswitch”onpage 122.
cAddanuplinkadapter.See“LinkingandUnlinkingUplinkAdapterswithESXCLI”onpage 124and
“LinkingandUnlinking
UplinkAdapterswithvicfgvswitch”onpage 124.
d (Optional)ChangetheMTUorCDPsettings.See“SettingSwitchAttributeswithesxclinetwork
vswitchstandard”onpage 119and“SettingSwitchAttributeswithvicfgvswitch”onpage 120.
Retrieving Information About Virtual Switches
YoucanretrieveinformationaboutvirtualswitchesbyusingESXCLIorvicfg-vswitch.Specifyoneofthe
optionslistedin“ConnectionOptionsforvCLIHostManagementCommands”onpage 18inplaceof
<conn_options>.
Retrieving Information about Virtual Switches with ESXCLI
Youcanretrieveinformationaboutvirtualswitchesbyusingesxcli network vswitchcommands.
Listallvirtualswitchesandassociatedportgroups.
esxcli <conn_options> network vswitch standard list
Thecommandprintsinformationaboutthevirtualswitch,whichmightincludeitsname,numberof
ports,MTU,portgroups,andotherinformation.TheoutputincludesinformationaboutCDPsettingsfor
thevirtualswitch.Thepreciseinformationdependsonthetargetsystem.Thedefaultportgroupsare
Management NetworkandVM Network.
Listthenetworkpolicysettings(securitypolicy,trafficshapingpolicy,andfailoverpolicy)forthevirtual
switch.Thefollowingcommandsaresupported.
esxcli <conn_options> network vswitch standard policy failover get
esxcli <conn_options> network vswitch standard policy security get
esxcli <conn_options> network vswitch standard policy shaping get
Retrieving Information about Virtual Switches with vicfg-vswitch
Youcanretrieveinformationaboutvirtualswitchesbyusingthevcifg-vswitchcommand.Specifyoneof
theoptionslistedin“ConnectionOptionsforvCLIHostManagementCommands”onpage 18inplaceof
<conn_options>.
CheckwhethervSwitch1exists.
vicfg-vswitch <conn_options> -c vSwitch1
Listallvirtualswitchesandassociatedportgroups.
vicfg-vswitch <conn_options> -l
Thecommandprintsinformationaboutthevirtualswitch,whichmightincludeitsname,numberof
ports,MTU,portgroups,andotherinformation.ThedefaultportgroupsareManagement Networkand
VM Network.
RetrievethecurrentCDP(CiscoDiscoveryProtocol)settingforthisvirtualswitch.