Interfaccia IVMNetworkAdapter
[Windows Virtual PC non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]
Funge da interfaccia a una scheda di interfaccia di rete virtuale. Viene usato per configurare la modalità di rete di una macchina virtuale. Le schede di interfaccia di rete possono essere aggiunte e rimosse usando IVMVirtualMachine::AddNetworkAdapter e IVMVirtualMachine::RemoveNetworkAdapter. È anche possibile recuperare un oggetto IVMNetworkAdapter dall'insieme IVMNetworkAdapterCollection restituito dalle proprietà IVMVirtualMachine::NetworkAdapters o IVMVirtualNetwork::NetworkAdapters.
Membri
L'interfaccia IVMNetworkAdapter eredita dall'interfaccia IDispatch . IVMNetworkAdapter include anche questi tipi di membri:
Metodi
L'interfaccia IVMNetworkAdapter include questi metodi.
| Metodo | Descrizione |
|---|---|
| _ID | Recupera l'identificatore interno di questa interfaccia di rete. |
| AttachToVirtualNetwork | Collega l'interfaccia di rete alla rete virtuale specificata. |
| DetachFromVirtualNetwork | Scollega l'interfaccia di rete dalla rete virtuale. |
Proprietà
L'interfaccia IVMNetworkAdapter ha queste proprietà.
| Proprietà | Tipo di accesso | Descrizione |
|---|---|---|
|
EthernetAddress |
Lettura/Scrittura |
Indirizzo Ethernet (MAC) dell'interfaccia di rete. |
|
IsEthernetAddressDynamic |
Lettura/Scrittura |
Indica se l'indirizzo Ethernet viene generato dinamicamente. |
|
VirtualMachine |
Sola lettura |
Macchina virtuale associata a questa interfaccia di rete. |
|
VirtualNetwork |
Sola lettura |
Rete virtuale a cui è collegata l'interfaccia di rete. |
Commenti
L'indirizzo Ethernet predefinito per un'interfaccia di rete è "00-00-00-00-00-00", considerato un indirizzo Ethernet non valido da parte della maggior parte dei sistemi operativi. Se IsEthernetAddressDynamic è impostato su FALSE, EthernetAddress deve essere inizializzato con un indirizzo di rete Ethernet valido.
Le procedure seguenti illustrano come usare l'interfaccia IVMNetworkAdapter .
Per collegare una scheda di interfaccia di rete virtuale a una scheda di interfaccia di rete host
- Le schede di interfaccia di rete virtuali (guest) non sono collegate direttamente a una scheda di interfaccia di rete host. La scheda di interfaccia di rete virtuale viene invece collegata a una rete virtuale collegata a una scheda di interfaccia di rete host. Per altre informazioni sulla configurazione di reti virtuali, vedere IVMVirtualNetwork. Per collegare la scheda di interfaccia di rete virtuale a una rete virtuale, usare il metodo AttachToVirtualNetwork .
Per disconnettere una scheda di interfaccia di rete virtuale dalla rete virtuale
- Il metodo DetachFromVirtualNetwork scollega la scheda di interfaccia di rete virtuale dalla rete virtuale. Dopo aver chiamato questa funzione, la proprietà VirtualNetwork restituirà un ID di rete virtuale non valido.
Per rimuovere una scheda di interfaccia di rete virtuale da una macchina virtuale se si dispone dell'oggetto NIC virtuale
- Ottenere la macchina virtuale associata alla scheda di interfaccia di rete virtuale usando la proprietà VirtualMachine .
- Utilizzare l'oggetto corrente come parametro per il metodo IVMVirtualMachine::RemoveNetworkAdapter .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 7 [solo app desktop] |
| Server minimo supportato |
Nessuno supportato |
| Fine del supporto client |
Windows 7 |
| Prodotto |
Windows Virtual PC |
| Intestazione |
|
| IID |
IID_IVMNetworkAdapter è definito come e32e4165-22b8-4dc0-8d57-850171ae207a |