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
- Die DetachFromVirtualNetwork-Methode trennt die virtuelle NIC vom virtuellen Netzwerk. Nach dem Aufruf dieser Funktion gibt die VirtualNetwork-Eigenschaft eine ungültige ID des virtuellen Netzwerks zurück.
So entfernen Sie eine virtuelle NIC von einem virtuellen Computer, wenn Sie über das virtuelle NIC-Objekt verfügen
- Abrufen des virtuellen Computers, der der virtuellen NIC zugeordnet ist, mithilfe der VirtualMachine-Eigenschaft.
- 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 |
|
| IID |
IID _ IVMNetworkAdapter ist als e32e4165-22b8-4dc0-8d57-850171ae207a definiert. |