Reference Guide › Command-Line Scripting › CA VMware vCenter Server CLI Commands › dpmvc virtualswitch Command--Manage Virtual Switches

dpmvc virtualswitch Command--Manage Virtual Switches

The dpmvc virtualswitch command lets you manage virtual switches.

• Create a new virtual switch
• Update the properties of a virtual switch
• Delete a virtual switch
• Create a new port group for a virtual switch
• Update the port group properties of a virtual switch
• Remove a port group from a virtual switch
• Rename a port group of a virtual switch

Note: This operation does not run asynchronously, and the result gets back immediately. However, the PMM treats the operation as a tasked operation. Therefore the response contains a task ID, but it is always an empty string (“”).

The command has the following formats:

dpmvc virtualswitch {-vs_add | -vs_update}
-vc_server vcservername
-esx_host_name esxhostname 
-switch_name switchname
-nic_names nicname1[,nicname2, ...]
[-sc sc_url] 
[-wait [timeout]] 
[-pre] 
[-post] 
[-locale iso639value]

dpmvc virtualswitch -vs_remove
-vc_server vcservername
-esx_host_name esxhostname 
-switch_name switchname
[-sc sc_url] 
[-wait [timeout]] 
[-pre] 
[-post] 
[-locale iso639value]

dpmvc virtualswitch -add_portgroup
-vc_server vcservername
-esx_host_name esxhostname 
-switch_name switchname
-portgroup_name portgroupname
[-vlan vlanID]
[-sc sc_url] 
[-wait [timeout]] 
[-pre] 
[-post] 
[-locale iso639value]

dpmvc virtualswitch -update_portgroup
-vc_server vcservername
-esx_host_name esxhostname 
-switch_name switchname
-portgroup_name portgroupname
[-portgroup_newname portgroupnewname]
[-vlan vlanID]
[-sc sc_url] 
[-wait [timeout]] 
[-pre] 
[-post] 
[-locale iso639value]

dpmvc virtualswitch -remove_portgroup
-vc_server vcservername
-esx_host_name esxhostname 
-portgroup_name portgroupname
[-vlan vlanID]
[-sc sc_url] 
[-wait [timeout]] 
[-pre] 
[-post] 
[-locale iso639value]

dpmvc virtualswitch -rename_portgroup
-vc_server vcservername
-esx_host_name esxhostname 
-switch_name switchname
-portgroup_name portgroupname
-portgroup_newname portgroupnewname
[-sc sc_url] 
[-wait [timeout]] 
[-pre] 
[-post] 
[-locale iso639value]

-vc_server vcservername

Specifies the vCenter Server to access when you have multiple vCenter Servers. Optional for single vCenter Server environments.

-esx_host_name esxhostname

Specifies the name of the ESX server that hosts a VM.

-switch_name switchname

Specifies the switch name to perform the operation on.

-nic_names nicname1 [,nicname2, ...]

Specifies a list of physical NICs seperated by a comma. If you specify multiple NICs, use double quotes to escape the argument, for example: "sc1,nfs1,mnic1,mnic2".

-portgroup_name portgroupname

Specifies the port group name.

-portgroup_newname portgroupnewname

Specifies the new port group name.

-vlan vlanID

(Optional) Specifies an Integer value (vlan ID) used for the virtual portgroup operations.

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-wait timeout

(Optional) Indicates whether to display the status of the job and not return until the operation completes, fails, or the timeout period is met (if you specify a timeout value). If you do not specify this option, the CLI returns without waiting for completion. If there is no response, the optional timeout value defines the timeout period in minutes. If you enter the wait option with no timeout value, the CLI uses the default wait time from the caimgconf.cfg file or defaults to 120 minutes. In addition to any positive integer, the following timeout values are also possible:

""

No timeout value.

0

Wait indefinitely.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

Example

This example creates a new virtual switch.

dpmvc virtualswitch -vs_add -vc_server vc5master -esx_host_name esx5 
-switch_name switch1 -nic_names "sc1,nfs1,mnic1,mnic2"