Partager via

Set-SCVirtualNetworkAdapter

  • Référence
Module:
VirtualMachineManager

Modifie les propriétés d’une carte réseau virtuelle associée à une machine virtuelle, à un modèle de machine virtuelle ou à un profil matériel utilisé pour créer des machines virtuelles dans VMM.

Syntax

Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   -SlotID <Int32>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   -JobGroup <Guid>
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   [-JobGroup <Guid>]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-IPv4Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv6Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv4AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-IPv6AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-VMMServer <ServerConnection>]
   [[-VirtualNetworkAdapter] <VirtualNetworkAdapter>]
   -VirtualNetwork <String>
   [-Checkpoint]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Set-SCVirtualNetworkAdapter modifie une ou plusieurs propriétés d’une carte réseau virtuelle associée à une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé pour créer des machines virtuelles dans un environnement Virtual Machine Manager (VMM).

Les opérations que vous pouvez effectuer sont les suivantes :

  • connexion d'une carte réseau virtuelle à un réseau virtuel.

  • Déconnectez une carte réseau virtuelle d’un réseau virtuel.

  • Spécifiez un emplacement réseau et une balise réseau sur une carte réseau virtuelle.

  • Spécifiez une adresse MAC sur la carte réseau virtuelle.

  • Activez l’utilisation d’un réseau local virtuel (VLAN) et spécifiez un ID de réseau local virtuel (identificateur numérique) pour ce réseau local virtuel sur la carte réseau virtuelle.

Notes

  • Un nouveau paramètre [-PhysicalNetworkAdapterName] est inclus dans VMM 2019 UR2. Pour plus d’informations, consultez Paramètres.
  • Les nouveaux paramètres [-AllowedVLanList] et [-NativeVLanId] sont inclus dans VMM 2019 UR3. Pour plus d’informations, consultez Paramètres.

Exemples

Exemple 1 : Connecter une carte réseau virtuelle à un réseau virtuel

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VirtualNetwork "ExternalVirtualNetwork01"

La première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.

La deuxième commande obtient tous les objets de carte réseau virtuelle sur VM01, sélectionne l’objet de carte avec l’adresse physique (MAC) de 00:16:D3:CC:00:1B, puis stocke l’objet dans la variable $Adapter.

La dernière commande connecte la carte réseau virtuelle stockée dans $Adapter au réseau virtuel nommé ExternalVirtualNetwork01 sur l’hôte qui contient VM01.

Exemple 2 : Spécifier une adresse MAC statique pour une carte réseau virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.ID -eq "5c0ee80a-731f-41c8-92f0-85a1619f9a1b" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -PhysicalAddressType "Static" -PhysicalAddress "00:16:D3:CC:00:1C"

La première commande obtient l’objet de machine virtuelle nommé VM02 et stocke l’objet dans la variable $VM.

La deuxième commande obtient tous les objets de carte réseau virtuelle sur VM02, sélectionne la carte réseau virtuelle avec l’ID spécifié, puis stocke l’objet dans la variable $Adapter. Cet exemple suppose que cet adaptateur a actuellement une adresse MAC dynamique.

La dernière commande spécifie que la carte réseau virtuelle stockée dans $Adapter utiliser l’adresse MAC statique 00:16:D3:CC:00:1C.

Exemple 3 : Spécifier une adresse MAC statique et l’affecter à une carte réseau virtuelle existante

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter (Get-VirtualNetworkAdapter -VM $VM | where { $_.ID -eq "95e9cfda-861c-44a3-b2ba-2f796dfe691c"}) -MACAddressType "Static" -MACAddress "00-00-00-00-00-00"

La première commande obtient l’objet de machine virtuelle nommé VM03 et stocke l’objet dans la variable $VM.

La deuxième commande obtient l’objet de carte réseau virtuelle sur VM03 par ID, spécifie que l’adaptateur utilise un type d’adresse MAC statique et l’affecte à une adresse MAC.

Exemple 4 : Déconnecter la carte réseau virtuelle spécifiée du réseau virtuel

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapters[1] -NoConnection

La première commande obtient l’objet de machine virtuelle nommé VM04 et stocke l’objet dans la variable $VM.

La deuxième commande obtient tous les objets de carte réseau virtuelle sur VM04 et stocke les objets de carte dans $Adapters. Cet exemple suppose que VM04 a au moins deux cartes réseau virtuelles.

La dernière commande utilise le paramètre NoConnection pour déconnecter la deuxième carte réseau virtuelle (cartes[1]) de n’importe quel réseau virtuel auquel elle est connectée.

Exemple 5 : Spécifier un groupe de ports VMware pour une machine virtuelle existante

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapter = $VM.VirtualNetworkAdapters[0]
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VMwarePortGroup "VM Network"

La première commande obtient l’objet de machine virtuelle nommé VM05 et stocke l’objet dans la variable $VM.

La deuxième commande stocke la première carte réseau virtuelle [0] sur VM05 dans la variable $Adapter.

La dernière commande définit la carte réseau virtuelle de la carte stockée dans $Adapter au réseau de machines virtuelles, qui est le nom du groupe de ports VMware auquel vous souhaitez que cette carte se connecte.

Paramètres

-AdapterFlags

{{Fill AdapterFlags Description}}

Type:VirtualNetworkAdapterFlags
Accepted values:None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowedVLanList

Spécifie une liste de réseaux locaux virtuels autorisés sur une carte réseau d'ordinateur virtuel.

Notes

Ce paramètre s’applique à VMM 2019 UR3.

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

-Checkpoint

Indique d’utiliser l’autorisation Can Checkpoint.

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

-DevicePropertiesAdapterName

Spécifie le nom d’une carte réseau.

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

-DevicePropertiesAdapterNameMode

Spécifie le mode de nom de l’adaptateur.

Type:DevicePropertiesAdapterNameMode
Accepted values:Disabled, VMNetwork, Custom
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableGuestIPNetworkVirtualizationUpdates

Indique si les mises à jour de virtualisation du réseau IP par un invité sont activées.

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

-EnableMACAddressSpoofing

Active, lorsqu’elle est définie sur $True, usurpation d’adresse MAC.

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

-EnableVMNetworkOptimization

Active, lorsqu’il est défini sur $True, l’optimisation du réseau de machines virtuelles.

Cette fonctionnalité améliore les performances réseau des machines virtuelles avec des cartes réseau qui prennent en charge la file d’attente de machines virtuelles (VMQ) ou le déchargement TCP Chimney. VMQ permet de créer une file d’attente réseau unique pour chaque carte réseau virtuelle. Le déchargement TCP Chimney permet au traitement du trafic réseau d’être déchargé à partir de la pile réseau.

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

-IPv4Addresses

Spécifie une liste d’adresses IPv4.

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv4Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressPools

Spécifie une liste de pools d’adresses IPv4.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv4AddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressType

Spécifie un type d’adresse IPv4. Les valeurs valides pour ce paramètre sont :

  • Dynamique
  • statique
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6Addresses

Spécifie une liste d’adresses IPv6.

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv6Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressPools

Spécifie une liste de pools d’adresses IPv6.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv6AddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressType

Spécifie un type d’adresse IPv6. Les valeurs valides pour ce paramètre sont :

  • Dynamique
  • statique
Type:EthernetAddressType
Accepted values:Dynamic, Static
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:True
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

-LogicalNetwork

Spécifie un réseau logique. Un réseau logique est un regroupement nommé de sous-réseaux IP et de réseaux locaux virtuels utilisés pour organiser et simplifier les affectations de réseau.

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

-MACAddress

Spécifie l’adresse MAC ou un ensemble d’adresses MAC pour une carte réseau physique ou virtuelle sur un ordinateur.

  • Exemple de format pour une seule adresse MAC : -MACAddress "00-15-5D-B4-DC-00"
  • Exemple de format pour un ensemble d’adresses MAC : -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Type:String
Aliases:EthernetAddress, PhysicalAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MACAddressType

Spécifie le type d’adresse MAC à utiliser pour une carte réseau virtuelle. Les valeurs valides sont : statique, dynamique.

Type:String
Aliases:EthernetAddressType, PhysicalAddressType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NativeVLanId

Spécifie l'identificateur de réseau local virtuel natif pour une carte réseau d'ordinateur virtuel.

Notes

Ce paramètre s’applique à VMM 2019 UR3.

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

-NetworkLocation

Spécifie l’emplacement réseau d’une carte réseau physique ou d’une carte réseau virtuelle, ou modifie l’emplacement réseau par défaut de la carte réseau physique d’un ordinateur hôte.

Exemples de formats :

  • -NetworkLocation $NetLoc ($NetLoc peut contenir des Corp.Contoso.com)
  • -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkTag

Spécifie un mot ou une phrase à associer à une carte réseau virtuelle configurée pour la connexion à un réseau interne ou externe spécifique sur l’ordinateur hôte.

Le paramètre NetworkTag identifie toutes les machines virtuelles ayant le même NetworkTag que les membres du même réseau. VMM utilise un NeworkTag (s’il en existe) lorsqu’il évalue les hôtes comme candidats possibles sur lesquels déployer une machine virtuelle. Si l’hôte n’inclut pas de machines virtuelles sur le réseau avec le même NetworkTag que la machine virtuelle à placer, l’hôte reçoit zéro étoile dans le processus de placement.

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

-NoConnection

Déconnecte une carte réseau virtuelle d’un réseau virtuel.

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

-NoLogicalNetwork

Indique qu’aucun réseau logique n’est associé à cette carte réseau virtuelle.

Type:SwitchParameter
Aliases:NoVMNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoPortClassification

Indique qu’une classification de port n’est pas fournie.

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

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur spécifié par ce paramètre.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-PhysicalNetworkAdapterName

Spécifie le nom de la carte réseau physique.

Notes

Ce paramètre s’applique à VMM 2019 UR2.

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

-PortACL

Spécifie un objet ACL de port.

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

-PortClassification

Spécifie la classification de port du commutateur auquel la carte réseau virtuelle se connecte.

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

-RemovePortACL

Indique que cette opération supprime la liste de contrôle d’accès au port (ACL).

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

-RequiredBandwidth

Spécifie la bande passante réseau requise par une carte réseau.

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

-SlotID

Spécifie un ID numérique utilisé pour identifier un appareil.

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

-VirtualNetwork

Spécifie un objet réseau virtuel.

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

-VirtualNetworkAdapter

Spécifie un objet carte réseau virtuelle pour un ordinateur virtuel.

Les types d’hôtes prennent en charge le nombre suivant de cartes réseau virtuelles :

  • Hyper-V. Jusqu’à quatre adaptateurs émulés par machine virtuelle. Il n’existe aucun pilote disponible pour une carte réseau émulée sur un système d’exploitation invité Windows Server 2003 x64.

  • Hyper-V. Jusqu’à huit adaptateurs synthétiques par machine virtuelle.

  • VMware ESX. Jusqu’à quatre adaptateurs émulés par machine virtuelle.

  • Citrix XenServer. Jusqu’à sept adaptateurs émulés par machine virtuelle.

Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VLanEnabled

Indique s’il faut activer un réseau local virtuel (VLAN) à utiliser par des machines virtuelles sur un hôte Hyper-V ou Citrix XenServer.

  • Exemple : -VLANEnabled -VLANID 35
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 une carte réseau virtuelle d’une machine virtuelle liée à une carte réseau physique sur l’hôte ou liée à un réseau virtuel interne sur l’hôte.

Exemple de format : -VLanEnabled -VLANID 35

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

-VMMServer

Spécifie un objet serveur VMM.

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

-VMNetwork

Spécifie un objet réseau de machine virtuelle.

Pour obtenir un objet réseau de machine virtuelle, utilisez l’applet de commande Get-SCVMNetwork .

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

-VMNetworkServiceSetting

Spécifie un paramètre de service réseau de machine virtuelle.

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

-VMSubnet

Spécifie un objet de sous-réseau de machine virtuelle.

Pour obtenir un objet VMSubnet , utilisez l’applet de commande Get-SCVMSubnet .

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

-VMwarePortGroup

Spécifie le groupe de ports VMware.

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

Sorties

VirtualNetworkAdapter

Cette applet de commande retourne un objet VirtualNetworkAdapter .

Notes

  • Nécessite un objet de carte réseau virtuelle VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualNetworkAdapter .