Interface IVMNetworkAdapter
[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]
Sert d’interface à une carte d’interface réseau virtuelle (NIC). Il est utilisé pour configurer la façon dont une machine virtuelle est mise en réseau. Les cartes d’interface réseau peuvent être ajoutées et supprimées à l’aide d’IVMVirtualMachine::AddNetworkAdapter et IVMVirtualMachine::RemoveNetworkAdapter. Vous pouvez également récupérer un objet IVMNetworkAdapter à partir de la collection IVMNetworkAdapterCollection retournée à partir des propriétés IVMVirtualMachine::NetworkAdapters ou IVMVirtualNetwork::NetworkAdapters .
Membres
L’interface IVMNetworkAdapter hérite de l’interface IDispatch. IVMNetworkAdapter possède également les types de membres suivants :
Méthodes
L’interface IVMNetworkAdapter contient ces méthodes.
Méthode | Description |
---|---|
_ID | Récupère l’identificateur interne de cette interface réseau. |
AttachToVirtualNetwork | Attache l’interface réseau au réseau virtuel spécifié. |
DetachFromVirtualNetwork | Détache l’interface réseau de son réseau virtuel. |
Propriétés
L’interface IVMNetworkAdapter possède ces propriétés.
Propriété | Type d’accès | Description |
---|---|---|
EthernetAddress |
Lecture/écriture |
Adresse Ethernet (MAC) de l’interface réseau. |
IsEthernetAddressDynamic |
Lecture/écriture |
Indique si l’adresse Ethernet est générée dynamiquement. |
VirtualMachine |
Lecture seule |
Machine virtuelle associée à cette interface réseau. |
VirtualNetwork |
Lecture seule |
Réseau virtuel auquel l’interface réseau est attachée. |
Notes
L’adresse Ethernet par défaut pour une interface réseau est « 00-00-00-00-00-00 », qui est considérée comme une adresse Ethernet non valide par la plupart des systèmes d’exploitation. Si IsEthernetAddressDynamic a la valeur FALSE, EthernetAddress doit être initialisé avec une adresse réseau Ethernet valide.
Les procédures suivantes expliquent comment utiliser l’interface IVMNetworkAdapter .
Pour attacher une carte réseau virtuelle à une carte réseau hôte
- Les cartes réseau virtuelles (invitées) ne sont pas attachées directement à une carte réseau hôte. Au lieu de cela, la carte réseau virtuelle est attachée à un réseau virtuel attaché à une carte réseau hôte. Pour plus d’informations sur la configuration des réseaux virtuels, consultez IVMVirtualNetwork. Pour attacher la carte réseau virtuelle à un réseau virtuel, utilisez la méthode AttachToVirtualNetwork .
Pour déconnecter une carte réseau virtuelle du réseau virtuel
- La méthode DetachFromVirtualNetwork détache la carte réseau virtuelle du réseau virtuel. Une fois cette fonction appelée, la propriété VirtualNetwork retourne un ID de réseau virtuel non valide.
Pour supprimer une carte réseau virtuelle d’une machine virtuelle si vous avez l’objet de carte réseau virtuelle
- Obtenez la machine virtuelle associée à la carte réseau virtuelle à l’aide de la propriété VirtualMachine .
- Utilisez l’objet actuel comme paramètre de la méthode IVMVirtualMachine::RemoveNetworkAdapter .
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows 7 [applications de bureau uniquement] |
Serveur minimal pris en charge |
Aucun pris en charge |
Fin de la prise en charge des clients |
Windows 7 |
Produit |
Windows Virtual PC |
En-tête |
|
IID |
IID_IVMNetworkAdapter est défini comme e32e4165-22b8-4dc0-8d57-850171ae207a |