IVMNetworkAdapter-Schnittstelle

[Windows Der virtuelle PC ist ab Windows 8 nicht mehr für die Verwendung verfügbar. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Dient als Schnittstelle zu einer virtuellen Netzwerkschnittstellenkarte (NIC). Sie wird verwendet, um einzurichten, wie ein virtueller Computer vernetzt wird. Netzwerkschnittstellenkarten können mithilfe von IVMVirtualMachine::AddNetworkAdapter und IVMVirtualMachine::RemoveNetworkAdapterhinzugefügt und entfernt werden. Sie können auch ein IVMNetworkAdapter-Objekt aus der IVMNetworkAdapterCollection-Auflistung abrufen, die von den Eigenschaften IVMVirtualMachine::NetworkAdapters oder IVMVirtualNetwork::NetworkAdapters zurückgegeben wird.

Member

Die IVMNetworkAdapter-Schnittstelle erbt von der IDispatch-Schnittstelle. IVMNetworkAdapter verfügt auch über diese Typen von Membern:

Methoden

Die IVMNetworkAdapter-Schnittstelle verfügt über diese Methoden.

Methode BESCHREIBUNG
_Id Ruft den internen Bezeichner dieser Netzwerkschnittstelle ab.
AttachToVirtualNetwork Fügt die Netzwerkschnittstelle an das angegebene virtuelle Netzwerk an.
DetachFromVirtualNetwork Trennt die Netzwerkschnittstelle von ihrem virtuellen Netzwerk.

Eigenschaften

Die IVMNetworkAdapter-Schnittstelle verfügt über diese Eigenschaften.

Eigenschaft Zugriffstyp BESCHREIBUNG
EthernetAddress
Lesen/Schreiben
Die Ethernet-Adresse (MAC) der Netzwerkschnittstelle.
IsEthernetAddressDynamic
Lesen/Schreiben
Gibt an, ob die Ethernet-Adresse dynamisch generiert wird.
VirtualMachine
Schreibgeschützt
Der virtuelle Computer, der dieser Netzwerkschnittstelle zugeordnet ist.
VirtualNetwork
Schreibgeschützt
Das virtuelle Netzwerk, an das die Netzwerkschnittstelle angefügt ist.

Hinweise

Die Standard-Ethernet-Adresse für eine Netzwerkschnittstelle ist "00-00-00-00-00-00", was von den meisten Betriebssystemen als ungültige Ethernet-Adresse angesehen wird. Wenn IsEthernetAddressDynamic auf FALSE festgelegt ist, muss EthernetAddress mit einer gültigen Ethernet-Netzwerkadresse initialisiert werden.

In den folgenden Verfahren wird die Verwendung der IVMNetworkAdapter-Schnittstelle erläutert.

So fügen Sie eine virtuelle NIC an eine Host-NIC an

  • Virtuelle NICs (Gast-NICs) werden nicht direkt an eine Host-NIC angefügt. Stattdessen wird die virtuelle NIC an ein virtuelles Netzwerk angefügt, das an eine Host-NIC angefügt ist. Weitere Informationen zum Konfigurieren virtueller Netzwerke finden Sie unter IVMVirtualNetwork. Um die virtuelle NIC an ein virtuelles Netzwerk anzufügen, verwenden Sie die AttachToVirtualNetwork-Methode.

So trennen Sie eine virtuelle NIC vom virtuellen Netzwerk

So entfernen Sie eine virtuelle NIC von einem virtuellen Computer, wenn Sie über das virtuelle NIC-Objekt verfügen

  1. Abrufen des virtuellen Computers, der der virtuellen NIC zugeordnet ist, mithilfe der VirtualMachine-Eigenschaft.
  2. Verwenden Sie das aktuelle -Objekt als Parameter für die IVMVirtualMachine::RemoveNetworkAdapter-Methode.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
nur Windows 7 [ Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Ende des Supports (Client)
Windows 7
Product (Produkt)
Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
IID _ IVMNetworkAdapter ist als e32e4165-22b8-4dc0-8d57-850171ae207a definiert.