VirtualNetworkAdapter

System Center
 

Updated: June 27, 2017

Applies To: System Center 2016 - Service Provider Foundation, System Center Technical Preview

Gets, creates, updates, or deletes virtual network adapters in Virtual Machine Manager (VMM).

GETPOSTPUTDELETE
YesYesYesYes

GET

Gets the specified virtual network adapters.

If you supply the ID property, the virtual network adapter with that identifier is returned.

If you supply the VMId property, the virtual network adapters that are assigned to the identified virtual machine are returned.

If you supply the TemplateId property, the virtual network adapters that are assigned to the identified virtual machine template are returned.

If you supply only the StampId property, all virtual network adapters for every virtual machine and virtual machine template that are assigned to that stamp are returned.

Entity Properties

NameTypeMandatoryDescription
StampIdEdm.GuidYesThe identifier of the stamp that restricts the query.
TemplateIdEdm.GuidNoThe identifier of the virtual machine template.
VMIdEdm.GuidYesThe identifier of the virtual machine that contains the virtual network adapter.

POST

Creates a new virtual network adapter.

Entity Properties

NameTypeMandatoryDescription
StampIdEdm.GuidYesThe identifier of the stamp that restricts the query.
VMNetworkIdEdm.GuidNoThe identifier of the network that is assigned to this adapter.
VMIdEdm.StringNoThe identifier of the virtual machine.
IsSyntheticEdm.BooleanNoWhen this property is set to false, the virtual network adapter is created as an emulated virtual network adapter; otherwise, it is a high-performance Hyper-V virtual network adapter.

PUT

Updates an existing virtual network adapter.

Entity Properties

NameTypeMandatoryDescription
IDEdm.GuidYesThe identifier of the object to update.
StampIdEdm.GuidYesThe identifier of the stamp that restricts the query.
IPv4AddressTypeEdm.StringNoSets the IPv4 addressing type. Use either “Dynamic” or “Static.”
IPv6AddressTypeEdm.StringNoSets the IPv6 addressing type. Use either “Dynamic” or “Static.”
VMNetworkNameEdm.StringNoSpecifies the virtual machine network (VMNetwork) that the virtual network adapter is assigned to. Use an empty string to specify “no connection.”
VMNetworkIdEdm.GuidNoThe identifier of the network that is assigned to this adapter.
VMSubnetIdEdm.GuidNoThe identifier of the virtual machine subnet.
MACAddressTypeEdm.StringNoSets the media access control (MAC) addressing type. Use either “Dynamic” or “Static.”
MACAddressEdm.StringNoA comma-delimited list of MAC address values.
EnableMACAddressSpoofingEdm.BooleanNoSet to true to enable MAC address spoofing.

DELETE

Deletes the specified virtual network adapter.

Entity Properties

NameTypeMandatoryDescription
IDEdm.GuidNoThe identifier of the object to delete.
StampIdEdm.GuidYesThe identifier of the stamp that restricts the query.

VMM Collections Reference R2

Show: