Set-SCVMHostNetworkAdapter
Modifie les propriétés liées au réseau pour une carte réseau physique sur un hôte géré par VMM.
Syntaxe
Set-SCVMHostNetworkAdapter
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-Description <String>]
[-VLanMode <VlanMode>]
[-AvailableForPlacement <Boolean>]
[-UsedForManagement <Boolean>]
[-SubnetVLan <SubnetVLan[]>]
[-RemoveUnassignedVLan <UInt16[]>]
[-AddOrSetLogicalNetwork <LogicalNetwork>]
[-RemoveLogicalNetwork <LogicalNetwork>]
[-EnableNetworkVirtualization <Boolean>]
[-UplinkPortProfileSet <UplinkPortProfileSet>]
[-RemoveUplinkPortProfileSet]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCVMHostNetworkAdapter
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-Description <String>]
[-VLanEnabled <Boolean>]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-AvailableForPlacement <Boolean>]
[-UsedForManagement <Boolean>]
[-RemoveUnassignedVLan <UInt16[]>]
[-EnableNetworkVirtualization <Boolean>]
[-UplinkPortProfileSet <UplinkPortProfileSet>]
[-RemoveUplinkPortProfileSet]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
L’applet de commande set-SCVMHostNetworkAdapter modifie les propriétés liées au réseau pour une carte réseau physique sur un hôte géré par Virtual Machine Manager (VMM).
Les propriétés que vous pouvez modifier avec cette applet de commande sont les suivantes :
- Paramètres de réseau local virtuel : vous pouvez utiliser les paramètres VLAN pour créer ou modifier un seul réseau local virtuel ou plusieurs réseaux locaux virtuels. Pour obtenir une illustration de la façon de spécifier des paramètres de réseau local virtuel, consultez les exemples.
Pour plus d’informations sur les réseaux locaux virtuels et des exemples supplémentaires qui illustrent les paramètres VLAN, tapez Get-Help Add-SCVMHostNetworkAdapter -Detailed.
Exemples
Exemple 1 : Créer un réseau virtuel sur une carte réseau hôte et spécifier un ID de réseau local virtuel pour le réseau virtuel
PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost | where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35La 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 carte réseau hôte avec un nom qui commence par « Intel(R) PRO/1000 sur VMHost02 et stocke l’objet dans la variable $HostAdapter.
La troisième commande crée un réseau virtuel nommé VirtualNetwork01 sur VMHost02 lié à l’adaptateur hôte stocké dans $HostAdapter.
La dernière commande active un réseau local virtuel, définit le mode sur Access (qui route le trafic en interne au sein d’un seul réseau local virtuel) et affecte à la carte réseau un VLANID de 35.
Remarque : Cet exemple suppose que votre hôte est déjà connecté à un réseau local virtuel ou, si ce n’est pas le cas, 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.
Exemple 2 : Ajouter des balises VLan à une carte réseau hôte configurée en mode Jonction
PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTagsLa 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 carte réseau hôte en spécifiant le nom de la carte et en stockant l’objet dans la variable $VMHostNIC.
La troisième commande utilise la propriété VlanTags de l’objet de carte réseau hôte ($VMHostNIC.VlanTags) et concatène un nouveau tableau de balises. Le tableau mis à jour conserve les VlanTags exisiting et ajoute les balises répertoriées au tableau. Le résultat de la concaténation est stocké dans $NewVlanTags.
La dernière commande transmet la nouvelle liste de balises VLAN au paramètre VLANTrunkID de Set-VMHostNetworkAdapter.
Le paramètre VLANMode
Paramètres
-AddOrSetLogicalNetwork
Spécifie un réseau logique qui sera ajouté ou mis à jour.
| Type: | LogicalNetwork |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AvailableForPlacement
Indique si le processus de placement VMM considère cet hôte ou ce volume sur un hôte comme un emplacement possible sur lequel déployer des machines virtuelles. Si ce paramètre est défini sur $False, vous pouvez choisir de déployer des machines virtuelles sur cet hôte ou ce volume de toute façon. La valeur par défaut est $True. Ce paramètre ne s’applique pas aux hôtes VMware ESX.
Lorsque ce paramètre est utilisé avec des cartes réseau, s’il est défini sur $False, le placement ne prend pas en compte les réseaux logiques configurés sur cette carte réseau pour déterminer si l’hôte convient à la connexion d’une machine virtuelle.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Description
Indique une description de l’objet spécifié.
| 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 |
-EnableNetworkVirtualization
Spécifie si la virtualisation du réseau est activée. La valeur par défaut est $False.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-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 |
-RemoveLogicalNetwork
Spécifie un réseau logique qui sera supprimé.
| Type: | LogicalNetwork |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RemoveUnassignedVLan
Spécifie que les réseaux locaux virtuels spécifiés seront supprimés de la jonction VLAN de la carte s’ils ne sont pas associés à un réseau logique.
| 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 |
-RemoveUplinkPortProfileSet
Supprime le jeu de profils de port de liaison montante de la carte réseau hôte.
| 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 |
-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 |
-SubnetVLan
Spécifie un ou plusieurs ensembles de sous-réseaux IP et de réseaux locaux virtuels.
Pour plus d’informations sur la création d’un sous-réseau, tapez Get-Help New-SCSubNetVLan.
| Type: | SubnetVLan[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UplinkPortProfileSet
Spécifie un objet de jeu de profils de port de liaison montante.
Pour obtenir un objet de jeu de profils de port de liaison montante, utilisez l’applet de commande Get-SCUplinkPortProfileSet.
| Type: | UplinkPortProfileSet |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UsedForManagement
Indique si l’objet est utilisé pour gérer les hôtes.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| 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: | Boolean |
| 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.