Add-SCVMHostNetworkAdapter
Ajoute une carte réseau physique sur un hôte géré par VMM à un réseau virtuel.
Syntaxe
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
L’applet de commande add-SCVMHostNetworkAdapter ajoute une carte réseau physique (également appelée carte d’interface réseau ou carte réseau) sur un hôte géré par Virtual Machine Manager (VMM) à un réseau virtuel. Chaque machine virtuelle sur cet hôte peut également se connecter via une carte réseau virtuelle à ce réseau virtuel.
Un réseau virtuel configuré sur un hôte peut se connecter à plusieurs cartes réseau virtuelles sur des machines virtuelles déployées sur cet hôte.
VMM pour System Center 2019 et versions ultérieures inclut la prise en charge de la mise en réseau virtuelle pour la configuration d’un ou plusieurs réseaux locaux virtuels (VLAN) sur un hôte. Vous pouvez utiliser l’applet de commande Add-SCVMHostNetworkAdapter ou l’applet de commande Set-SCVMHostNetworkAdapter pour configurer un seul réseau local virtuel ou plusieurs réseaux locaux virtuels sur un hôte. Pour configurer les paramètres VLAN correspondants sur une machine virtuelle, utilisez la cmdlet New-SCVirtualNetworkAdapter ou l’applet de commande Set-SCVirtualNetworkAdapter.
Pour obtenir une illustration de chaque type de réseau local virtuel, consultez les exemples de cette applet de commande.
Exemples
Exemple 1 : Ajouter une carte réseau hôte physique à un réseau virtuel
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapterLa première commande obtient l’objet hôte nommé VMHost01 et stocke l’objet dans la variable $VMHost.
La deuxième commande obtient l’objet de réseau virtuel nommé ExternalVirtualNetwork01 sur VMHost01 et stocke l’objet dans la variable $VirtualNetwork.
La troisième commande obtient l’objet de carte réseau physique nommé HostAdapter01 sur VMHost01 et stocke l’objet dans la variable $VMHostNetworkAdapter.
La dernière commande ajoute HostAdapter01 à ExternalVirtualNetwork01.
Remarque : vous ne pouvez ajouter qu’une seule carte hôte physique par réseau virtuel. Par conséquent, la dernière commande échoue si une carte est déjà associée au réseau virtuel spécifié. Pour ajouter une nouvelle carte au réseau virtuel, vous devez d’abord supprimer la carte hôte existante.
Exemple 2 : Ajouter une carte réseau hôte physique à un réseau local virtuel qui utilise le mode « Jonction »
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124La première commande obtient l’objet hôte nommé VMHost02 et stocke l’objet dans la variable $VMHost.
La deuxième commande obtient l’objet de réseau virtuel nommé ExternalNetwork02 sur VMHost02 et stocke l’objet dans la variable $VirtualNetwork.
La troisième commande obtient l’objet de carte réseau nommé HostAdapter02 sur VMHost02 et stocke l’objet adaptateur dans la variable $VMHostNetworkAdapter.
La dernière commande ajoute HostAdapter02 au réseau virtuel ExternalNetwork02 et active l’accès à partir de ExternalNetwork02 à un appareil de mise en réseau externe à l’aide des réseaux virtuels étiquetés 802.1Q 1, 2, 100, 200 et 1124.
Remarque : Vous ne pouvez ajouter qu’une seule carte hôte par réseau virtuel. La dernière commande échoue donc si une carte est déjà associée au réseau virtuel spécifié.
Exemple 3 : Ajouter une carte réseau hôte physique à un réseau local virtuel qui utilise le mode « Access »
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22La première commande obtient l’objet hôte nommé VMHost03 et stocke l’objet dans la variable $VMHost.
La deuxième commande obtient l’objet de réseau virtuel nommé ExternalNetwork03 sur VMHost03 et stocke l’objet dans la variable $VirtualNetwork.
La troisième commande obtient l’objet de carte réseau nommé HostAdapter03 sur VMHost03 et stocke l’objet adaptateur dans la variable $VMHostNetworkAdapter.
La dernière commande ajoute HostAdapter03 au réseau virtuel ExternalNetwork03 et limite l’accès à ExternalNetwork03 à VLANID 22.
Remarque : Vous ne pouvez ajouter qu’une seule carte hôte par réseau virtuel. La dernière commande échoue donc si une carte est déjà associée au réseau virtuel spécifié.
Attention : Cet exemple suppose que votre hôte est déjà connecté à un réseau local virtuel ou, si ce n’est pas le cas, assurez-vous que votre hôte dispose de deux cartes réseau. Si votre hôte dispose d’une carte réseau unique, l’affectation de la carte à un réseau local virtuel indisponible au serveur VMM empêche VMM de gérer l’hôte. Vous pouvez effectuer les étapes décrites dans cet exemple sur un hôte qui n’a qu’une seule carte réseau si vous installez d’abord l’adaptateur de bouclage Microsoft sur votre serveur.
Paramètres
-JobGroup
Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobVariable
Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PROTipID
Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunAsynchronously
Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VirtualNetwork
Spécifie un objet de réseau virtuel.
| Type: | VirtualNetwork |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-VLanEnabled
Active un réseau local virtuel (VLAN) à utiliser par des machines virtuelles sur un hôte Hyper-V ou Citrix XenServer.
Exemple de format pour un seul réseau local virtuel : -VLANEnabled -VLANMode "Access" -VLANID 35 Exemple de format pour plusieurs réseaux locaux virtuels : -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VLanID
Affecte un identificateur numérique de la plage 1 à 4094 à une carte réseau virtuelle sur une machine virtuelle ou à une carte réseau physique sur un hôte de machine virtuelle.
Configurez un VLanID sur un hôte Hyper-V, VMware ESX ou Citrix XenServer :
- Sur une carte réseau physique liée à l’extérieur lorsque le mode VLan est Access.
Configurez un VLanID sur une carte réseau virtuelle d’une machine virtuelle :
- Lié à une carte réseau physique sur l’hôte, ou
- Lié à un réseau virtuel interne sur l’hôte.
Exemple de format : -VLanEnabled``-VLanMode "Access" -VLANID 35
| Type: | UInt16 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VLanMode
Spécifie si un réseau local virtuel (VLAN) sur un hôte de machine virtuelle prend en charge le trafic sur un seul réseau local virtuel (mode Access) ou sur plusieurs réseaux locaux virtuels (mode jonction). Les valeurs valides sont : Access, Trunk.
| Type: | VlanMode |
| Valeurs acceptées: | Access, Trunk, Invalid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VLanTrunkID
Affecte une liste d’identificateurs numériques de la plage 1 à 4094 à une carte réseau physique sur un hôte Hyper-V.
Exemple de format : -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Type: | UInt16[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VMHostNetworkAdapter
Spécifie un objet de carte réseau physique sur un hôte auquel les machines virtuelles déployées sur cet hôte peuvent se connecter.
Exemple de format : -VMHostNetworkAdapter $VMHostNIC
| Type: | HostNetworkAdapter |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
Sorties
VMHostNetworkAdapter
Cette applet de commande retourne un objet VMHostNetworkAdapter.