Interfaz IVMNetworkAdapter
[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2)].
Actúa como interfaz para una tarjeta de interfaz de red virtual (NIC). Se usa para configurar cómo se reda una máquina virtual. Las tarjetas de interfaz de red se pueden agregar y quitar mediante IVMVirtualMachine::AddNetworkAdapter y IVMVirtualMachine::RemoveNetworkAdapter. También puede recuperar un objeto IVMNetworkAdapter de la colección IVMNetworkAdapterCollection devuelta desde las propiedades IVMVirtualMachine::NetworkAdapters o IVMVirtualNetwork::NetworkAdapters .
Miembros
La interfaz IVMNetworkAdapter hereda de la interfaz IDispatch . IVMNetworkAdapter también tiene estos tipos de miembros:
Métodos
La interfaz IVMNetworkAdapter tiene estos métodos.
Método | Descripción |
---|---|
_ID | Recupera el identificador interno de esta interfaz de red. |
AttachToVirtualNetwork | Asocia la interfaz de red a la red virtual especificada. |
DetachFromVirtualNetwork | Desasocia la interfaz de red de su red virtual. |
Propiedades
La interfaz IVMNetworkAdapter tiene estas propiedades.
Propiedad | Tipo de acceso | Descripción |
---|---|---|
EthernetAddress |
Lectura/escritura |
Dirección Ethernet (MAC) de la interfaz de red. |
IsEthernetAddressDynamic |
Lectura/escritura |
Indica si la dirección Ethernet se genera dinámicamente. |
VirtualMachine |
Solo lectura |
Máquina virtual asociada a esta interfaz de red. |
VirtualNetwork |
Solo lectura |
Red virtual a la que está conectada la interfaz de red. |
Comentarios
La dirección Ethernet predeterminada para una interfaz de red es "00-00-00-00-00-00", que la mayoría de los sistemas operativos considera una dirección Ethernet no válida. Si IsEthernetAddressDynamic está establecido en FALSE, EthernetAddress debe inicializarse con una dirección de red Ethernet válida.
En los procedimientos siguientes se explica cómo usar la interfaz IVMNetworkAdapter .
Para conectar una NIC virtual a una NIC de host
- Las NIC virtuales (invitadas) no están conectadas directamente a una NIC de host. En su lugar, la NIC virtual está conectada a una red virtual que está conectada a una NIC de host. Para obtener más información sobre cómo configurar redes virtuales, consulte IVMVirtualNetwork. Para conectar la NIC virtual a una red virtual, use el método AttachToVirtualNetwork .
Para desconectar una NIC virtual de la red virtual
- El método DetachFromVirtualNetwork desasociará la NIC virtual de la red virtual. Después de llamar a esta función, la propiedad VirtualNetwork devolverá un identificador de red virtual que no es válido.
Para quitar una NIC virtual de una máquina virtual si tiene el objeto NIC virtual
- Obtenga la máquina virtual asociada a la NIC virtual mediante la propiedad VirtualMachine .
- Utilice el objeto actual como parámetro para el método IVMVirtualMachine::RemoveNetworkAdapter .
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible |
Windows 7 [solo aplicaciones de escritorio] |
Servidor mínimo compatible |
No se admite ninguno |
Fin de compatibilidad de cliente |
Windows 7 |
Producto |
Windows Virtual PC |
Encabezado |
|
IID |
IID_IVMNetworkAdapter se define como e32e4165-22b8-4dc0-8d57-850171ae207a |