Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The IVMNetworkAdapter interface is the interface to a virtual network interface card (NIC). It is used to set up how a virtual machine is networked. Network interface cards can be added and removed by using IVMVirtualMachine::AddNetworkAdapter and IVMVirtualMachine::RemoveNetworkAdapter. You can also retrieve an IVMNetworkAdapter object from the IVMNetworkAdapterCollection collection returned from the IVMVirtualMachine::NetworkAdapters property.
When to use
The following procedures explain how to use the IVMNetworkAdapter interface.
To attach a virtual NIC to a host NIC
- Virtual (guest) NICs are not attached directly to a host NIC. Instead, the virtual NIC is attached to a virtual network that is attached to a host NIC. For more information about configuring virtual networks, see IVMVirtualNetwork. To attach the virtual NIC to a virtual network, use the AttachToVirtualNetwork method.
To disconnect a virtual NIC from the virtual network
- The DetachFromVirtualNetwork method will detach the virtual NIC from the virtual network. After this function is called, the VirtualNetwork property will return a virtual network ID that is not valid.
To remove a virtual NIC from a virtual machine if you have the virtual NIC object
- Get the virtual machine associated with the virtual NIC by using the VirtualMachine property.
- Use the current object as a parameter to the IVMVirtualMachine::RemoveNetworkAdapter method.
Note
The default Ethernet address for a network interface is "00-00-00-00-00-00", which is considered an invalid Ethernet address by most operating systems. If IsEthernetAddressDynamic is set to FALSE, use EthernetAddress to specify a valid Ethernet address.
Members
The IVMNetworkAdapter interface inherits from the IDispatch interface. IVMNetworkAdapter also has these types of members:
Methods
The IVMNetworkAdapter interface has these methods.
| Method | Description |
|---|---|
| AttachToVirtualNetwork | Attaches the virtual NIC to the specified virtual network by using the virtual network's ID. |
| DetachFromVirtualNetwork | Detaches the virtual NIC from its virtual network. |
Properties
The IVMNetworkAdapter interface has these properties.
| Property | Access type | Description |
|---|---|---|
| _ID |
Read-only |
The internal ID of this network adapter. |
| EthernetAddress |
Read/write |
The Ethernet (MAC/Physical/Network) address of the virtual NIC. |
| IsEthernetAddressDynamic |
Read/write |
Indicates whether the Ethernet address is dynamically generated. |
| VirtualMachine |
Read-only |
The virtual machine associated with this virtual NIC. |
| VirtualNetwork |
Read-only |
The virtual network to which the virtual NIC is attached. |
Remarks
The default Ethernet address for a network interface is "00-00-00-00-00-00", which is considered an invalid Ethernet address by most operating systems. If IsEthernetAddressDynamic is set to FALSE, EthernetAddress must be initialized with a valid Ethernet network address.
Requirements
| Product |
Microsoft Virtual Server 2005 onWindows Server 2003 |
| Download |
Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003 |
| Header |
|