Adding an ethernet adapter

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.


The following figure shows the sample for device-change-list for adding an ethernet adapter. For adding an ethernet adapter, the permissible values of the elements are:

Element

Definition

Required

<device-name>

Specifies the name of the device on the host system

Yes

<device type>

Specifies the type of the device on the host system

Valid value: VirtualPCNet32

No

<backing type>

Specifies the backing type of the device

Valid value: VirtualEthernetCardNetworkBackingInfo

Yes

<start-connected>

Specifies the flag specifying whether to connect the device when the virtual machine starts

No

<allow-guest-control>

Specifies the flag that allows the guest to control the device when the device is connected

No

<connected>

Specifies the flag that indicates whether the device is currently connected

This element is valid only when the virtual machine is running

No

<address-type>

Specifies the MAC address type

Valid values: manual, assigned

Manual indicates a statically assigned MAC address and assigned indicates that the MAC address is assigned by the Virtual Center.

Conditional

<mac-address>

Specifies the MAC address assigned to the virtual network adapter

Clients can set this property to any of the permissible address types. The server may override the specified value for Assigned, if the value does not fall within the acceptable ranges or if the value is determined to be a duplicate.

Conditional

<wake-on-lan-enabled>

Indicates whether the wake-on-LAN feature is enabled on the virtual network adapter

Clients can set this property to selectively enable or disable the wake-on-LAN feature.

No

XML Sample of device-change-list for adding an ethernet adapter

<device-change-list>
<device-change>
<operation>add</operation>
<device type="VirtualPCNet32">
<backing type="VirtualEthernetCardNetworkBackingInfo">
<device-name></device-name>
</backing>
<connectable>
<start-connected></start-connected>
<allow-guest-control></allow-guest-control>
<connected></connected>
</connectable>
<controller-key>0</controller-key>
<unit-number>0</unit-number>
<address-type></address-type>
<mac-address></mac-address>
<wake-on-lan-enabled></wake-on-lan-enabled>
</device>
</device-change>
</device-change-list>

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*