Add-SCVMHostNetworkAdapter
Ajoute une carte réseau physique sur un hôte géré par VMM à un réseau virtuel.
Syntax
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 ordinateur hôte peut se connecter à plusieurs cartes réseau virtuelles d’ordinateurs virtuels déployés sur cet ordinateur hôte.
VMM pour System Center 2019 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 l’applet de commande New-SCVirtualNetworkAdapter ou l’applet de commande Set-SCVirtualNetworkAdapter .
Pour une illustration de chaque type de réseau local virtuel, voir les exemples propres à chaque cmdlet.
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 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. Par conséquent, la dernière commande échoue 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 restreint l’accès à ExternalNetwork03 à VLANID 22.
Remarque : vous ne pouvez ajouter qu’une seule carte hôte 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é.
Attention : Cet exemple part du principe 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 la procédure indiquée dans cet exemple sur un ordinateur hôte possédant une seule carte réseau si vous installez d’abord la carte de bouclage Microsoft sur votre serveur.
Paramètres
-JobGroup
Spécifie un identificateur pour une série de commandes qui seront exécutées ensemble juste avant que la commande finale qui comprend le même identificateur de groupe de travaux soit exécutée.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualNetwork
Spécifie un objet réseau virtuel.
| Type: | VirtualNetwork |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 d’accès) ou sur plusieurs réseaux locaux virtuels (mode jonction). Les valeurs valides sont : Access, Trunk.
| Type: | VlanMode |
| Accepted values: | Access, Trunk, Invalid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VLanTrunkID
Affecte une liste d’identificateurs numériques dans la plage 1-4094 à une carte réseau physique sur un ordinateur hôte Hyper-V.
Exemple de format : -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Type: | UInt16[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Sorties
VMHostNetworkAdapter
Cette applet de commande retourne un objet VMHostNetworkAdapter .