Partager via

Set-SCVMHostNetworkAdapter

  • Référence
Module:
VirtualMachineManager

Modifie les propriétés liées au réseau pour une carte réseau physique sur un hôte géré par VMM.

Syntax

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 cmdlet sont notamment :

  • Paramètres VLAN : vous pouvez utiliser les paramètres VLAN pour créer ou modifier un seul réseau virtuel ou plusieurs réseaux virtuels. Pour obtenir une illustration de la façon de spécifier des paramètres VLAN, consultez les exemples.

Pour plus d’informations sur les réseaux 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 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 35

La 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é à la carte hôte stockée dans $HostAdapter.

La dernière commande active un réseau local virtuel, définit le mode Access (qui route le trafic en interne au sein d’un seul réseau 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 l’adaptateur à 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 $NewVLanTags

La 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 en cours d’exisinant 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 des balises VLAN au paramètre VLANTrunkID de Set-VMHostNetworkAdapter. Le paramètre VLANMode doit spécifier la valeur « Trunk » chaque fois que le paramètre VLANTrunkID est utilisé pour modifier la liste des identificateurs numériques de jonction VLAN.

Paramètres

-AddOrSetLogicalNetwork

Spécifie un réseau logique qui sera ajouté ou mis à jour.

Type:LogicalNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 pour connecter une machine virtuelle.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Indique une description de l’objet spécifié.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableNetworkVirtualization

Spécifie si la virtualisation réseau est activée. La valeur par défaut est $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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 du conseil d’optimisation des performances et des ressources 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

-RemoveLogicalNetwork

Spécifie un réseau logique qui sera supprimé.

Type:LogicalNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveUnassignedVLan

Spécifie que les réseaux 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveUplinkPortProfileSet

Supprime le profil de port de liaison montante défini à partir de la carte réseau hôte.

Type:SwitchParameter
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

-SubnetVLan

Spécifie un ou plusieurs ensembles de sous-réseaux IP et de réseaux virtuels.

Pour plus d’informations sur la création d’un Sous-réseauVLan, tapez Get-Help New-SCSubNetVLan.

Type:SubnetVLan[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 uplink, utilisez l’applet de commande Get-SCUplinkPortProfileSet .

Type:UplinkPortProfileSet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsedForManagement

Indique si l’objet est utilisé pour gérer les hôtes.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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 virtuel : -VLANEnabled -VLANMode "Access" -VLANID 35
  • Exemple de format pour plusieurs réseaux virtuels : -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Type:Boolean
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 en externe 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 virtuel (mode d’accès) ou sur plusieurs réseaux 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 .