Reference Guide › Command-Line Scripting › CA VMware vCenter Server CLI Commands › dpmvc addvmvnic Command--Add Virtual NIC

dpmvc addvmvnic Command--Add Virtual NIC

The dpmvc addvmvnic command adds a virtual NIC to a VM.

This command has the following format:

dpmvc addvmvnic
[-datacenter_name datacentername]
-vm_name vmname
-vc_server vcservername
[-sc sc_url]
[-wait timeout]
[-pre]
[-post]
-devicetype {e1000 | vmxnet}
-network_name networkname
[-mac_address macaddress]
-wake_on_lan_enabled {no | yes}
[-locale iso639value]

-datacenter_name datacentername

(Optional) Specifies the data center where the VM is located.

-vm_name vmname

Specifies the VM.

-vc_server vcservername

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

-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.

-devicetype {e1000 | vmxnet}

Indicates the type of network device.

-network_name networkname

Specifies the virtual network the NIC must be connected to. You can distinguish the names of Standard Switches and Distributed Virtual Switches based on the following naming convention:

• For Standard Switches, the name is the network name.
• For Distributed Virtual Switches, the name is a concatenation of the dvPort group name followed by the Distributed Virtual Switch name enclosed in parentheses: dvPortGroupName (dvSwitchName)

-mac_address macaddress

(Optional) Specifies the MAC (Media Access Control) address of the network device.

-wake_on_lan_enabled {no | yes}

Indicates whether to start the VM when LAN is enabled.

-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: Add a vNIC

This example adds a virtual NIC to a VM.

dpmvc addvmvnic -vm_name myvm -vc_server myvcenterserver -devicetype vmxnet
-network_name net1 -wake_on_lan_enabled no