Partager via


New-SCVirtualNetworkAdapter

Crée une carte réseau virtuelle sur une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé dans VMM.

Syntaxe

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VM <VM>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMHost <Host>]
   [-LogicalSwitch <LogicalSwitch>]
   -JobGroup <Guid>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VMTemplate <Template>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -HardwareProfile <HardwareProfile>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   -VMHost <Host>
   -LogicalSwitch <LogicalSwitch>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

La cmdlet New-SCVirtualNetworkAdapter crée une carte réseau virtuelle sur une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé pour créer des machines virtuelles gérées par Virtual Machine Manager (VMM).

Emplacement réseau

Vous pouvez utiliser l’applet de commande New-SCVirtualNetworkAdapter pour spécifier un emplacement réseau et connecter la carte réseau virtuelle à un réseau virtuel configuré sur l’hôte lorsque vous créez la carte, ou vous pouvez les configurer et d’autres paramètres ultérieurement à l’aide de l’applet de commande set-SCVirtualNetworkAdapter.

Adresse MAC statique ou dynamique

Vous pouvez spécifier si la carte réseau virtuelle utilise une adresse MAC statique ou dynamique, et vous pouvez spécifier une adresse MAC statique.

Cartes réseau virtuelles émulées ou synthétiques

Vous pouvez utiliser l’applet de commande New-SCVirtualNetworkAdapter pour créer un adaptateur dont le type est émulé (valeur par défaut) ou synthétique.

Pour les machines virtuelles sur n’importe quel type d’hôte (Hyper-V, VMware ou XenServer), vous pouvez configurer une carte réseau virtuelle sur la machine virtuelle qui émule une carte réseau physique spécifique.

Pour les machines virtuelles sur Hyper-V hôtes, si le système d’exploitation invité installé sur une machine virtuelle est un système d’exploitation prenant en charge la virtualisation (par exemple, Windows Server 2008 ou Windows Server 2016 et certaines versions de Linux), VMM vous permet de configurer une carte réseau virtuelle synthétique haute performance sur la machine virtuelle pour communiquer avec le matériel physique sur l’hôte. Vous devez spécifier explicitement qu’une carte réseau virtuelle est synthétique à l’aide du paramètre synthétique.

Réseau local virtuel

VMM inclut la prise en charge de la configuration d’un ou plusieurs réseaux locaux virtuels (VLAN) sur un hôte pour une utilisation par les machines virtuelles déployées sur cet hôte. Vous pouvez utiliser l’applet de commande New-SCVirtualNetworkAdapter (ou l’applet de commande Set-SCVirtualNetworkAdapter) avec les paramètres VLAN pour attacher la carte réseau virtuelle sur une machine virtuelle à un réseau local virtuel. Pour configurer les paramètres VLAN correspondants sur la carte réseau hôte, utilisez l’applet de commande Add-SCVMHostNetworkAdapter ou l’applet de commande Set-SCVMHostNetworkAdapter.

Pour obtenir une illustration de la configuration des réseaux locaux virtuels, consultez les exemples de cette applet de commande et consultez les exemples de New-SCVMHostNetworkAdapterConfig et Set-SCVMHostNetworkAdapter.

Note

  • Un nouveau paramètre [-PhysicalNetworkAdapterName] est inclus dans VMM 2019 UR2 et versions ultérieures. Pour plus d’informations, consultez Parameters.
  • De nouveaux paramètres [-AllowedVLanList] et [-NativeVLanId] sont inclus dans VMM 2019 UR3 et versions ultérieures. Pour plus d’informations, consultez Parameters.

Exemples

Exemple 1 : Créer une carte réseau virtuelle sur une machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM

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

La deuxième commande crée une carte réseau virtuelle sur VM01.

Exemple 2 : Créer une carte réseau virtuelle sur un modèle de machine virtuelle

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualNetworkAdapter -VMTemplate $VMTemplate

La première commande obtient l’objet de modèle de machine virtuelle nommé VMTemplate01 et stocke l’objet dans la variable $VMTemplate.

La deuxième commande crée une carte réseau virtuelle sur VMTemplate01.

Exemple 3 : Créer une carte réseau virtuelle émulée et une carte réseau virtuelle synthétique sur un profil matériel

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile -Synthetic

La première commande obtient l’objet de profil matériel nommé NewHWProfile01 à partir de la bibliothèque VMM et stocke l’objet dans la variable $HWProfile.

La deuxième commande crée une carte réseau virtuelle (une carte « native » ou émulée) sur NewHWProfile01.

La dernière commande crée une carte réseau virtuelle synthétique sur NewHWProfile01.

Exemple 4 : Créer une carte réseau virtuelle sur une machine virtuelle et lui attribuer une adresse MAC unique

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $VNIC = New-SCVirtualNetworkAdapter -VM $VM
PS C:\> $MACPool = Get-SCMACAddressPool -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACPool -VirtualNetworkAdapter $VNIC

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

La deuxième commande crée une carte réseau virtuelle sur la machine virtuelle stockée dans $VM (VM04) et stocke l’objet dans la variable $VNIC.

La troisième commande obtient l’objet de pool d’adresses MAC nommé MAC Address Pool 01 et stocke l’objet dans la variable $MACPool.

La dernière commande obtient l’adresse MAC disponible suivante à partir du pool d’adresses stocké dans $MACPool et l’affecte à la carte réseau virtuelle stockée dans $VNIC.

Exemple 5 : Créer une carte réseau virtuelle avec une adresse MAC statique et un ID de réseau local virtuel spécifique

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $LogicalNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $VirtualNet = Get-SCVirtualNetwork -Name "ExternalVirtualNetwork01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM -LogicalNetwork $LogicalNet -VirtualNetwork $VirtualNet -MACAddress "00-16-D3-CC-00-1A" -MACAddressType "Static" -VLANEnabled $True -VLANId 3

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

La deuxième commande obtient l’objet réseau logique nommé LogicalNetwork01 et stocke l’objet dans la variable $LogicalNet.

La troisième commande obtient l’objet de réseau virtuel nommé ExternalVirtualNetwork01 et stocke l’objet dans la variable $VirtualNet.

La dernière commande crée une carte réseau virtuelle pour VM05, connecte la carte au réseau logique stocké dans $LogicalNet et le réseau virtuel stocké dans $VirtualNet. La commande fournit une adresse MAC statique pour la carte réseau virtuelle, active le réseau local virtuel et spécifie un ID de réseau local virtuel de 3.

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.

Paramètres

-AdapterFlags

{{Fill AdapterFlags Description}}

Type:VirtualNetworkAdapterFlags
Valeurs acceptées:None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowedVLanList

Spécifie une liste de réseaux locaux virtuels autorisés sur une carte réseau de machine virtuelle.

Note

Ce paramètre s’applique à VMM 2019 UR3 et versions ultérieures.

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

-DevicePropertiesAdapterName

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

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

-DevicePropertiesAdapterNameMode

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

Type:DevicePropertiesAdapterNameMode
Valeurs acceptées:Disabled, VMNetwork, Custom
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableGuestIPNetworkVirtualizationUpdates

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

Type:Boolean
Alias:GuestIPNetworkVirtualizationUpdatesEnabled
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableMACAddressSpoofing

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

Type:Boolean
Alias:MACAddressesSpoofingEnabled
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableVMNetworkOptimization

Active, lorsqu’elle est définie 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 le déchargement de file d’attente de machines virtuelles (VMQ) ou TCP Chimney. VMQ permet de créer une file d’attente réseau unique pour chaque carte réseau virtuelle. Tcp Stack Offload permet au traitement du trafic réseau d’être déchargé à partir de la pile réseau.

Type:Boolean
Alias:VMNetworkOptimizationEnabled
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-HardwareProfile

Spécifie un objet de profil matériel.

Type:HardwareProfile
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InheritsAddressFromPhysicalNetworkAdapter

Indique si la carte réseau hérite de son adresse d’une carte réseau physique.

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

-IPv4Address

Spécifie une adresse IPv4.

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

-IPv4AddressPool

Spécifie un pool d’adresses statiques qui contient des adresses IPv4.

Type:StaticIPAddressPool
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IPv4AddressType

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

  • Dynamique
  • Statique
Type:EthernetAddressType
Valeurs acceptées:Dynamic, Static
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IPv6Address

Spécifie une adresse IPv6.

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

-IPv6AddressPool

Spécifie un pool d’adresses statiques qui contient des adresses IPv6.

Type:StaticIPAddressPool
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IPv6AddressType

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

  • Dynamique
  • Statique
Type:EthernetAddressType
Valeurs acceptées:Dynamic, Static
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:True
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

-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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LogicalSwitch

Spécifie un objet de commutateur logique.

Type:LogicalSwitch
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Alias:EthernetAddress, PhysicalAddress
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MACAddressType

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

Type:String
Alias:EthernetAddressType, PhysicalAddressType
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet réseau.

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

-NativeVLanId

Spécifie l’identificateur local virtuel natif pour une carte réseau de machine virtuelle.

Note

Ce paramètre s’applique à VMM 2019 UR3 et versions ultérieures.

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

-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 hôte.

Exemples de formats : -NetworkLocation $NetLoc ($NetLoc peut contenir Corp.Contoso.com) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"

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

-NetworkTag

Spécifie un mot ou une expression à associer à une carte réseau virtuelle configurée pour se connecter à un réseau interne ou externe spécifique sur l’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 (le cas échéant) lorsqu’il évalue les hôtes 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
Alias:Tag
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NoConnection

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

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

-NoVMNetwork

Indique qu’un réseau de machines virtuelles n’est pas spécifié.

Type:SwitchParameter
Alias:NoLogicalNetwork
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PhysicalNetworkAdapterName

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

Note

Ce paramètre s’applique à VMM 2019 UR2 et versions ultérieures.

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

-PortACL

Spécifie un objet ACL de port.

Type:PortACL
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PortClassification

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

Type:PortClassification
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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

-Synthetic

Spécifie qu’un appareil, tel qu’une carte réseau virtuelle, sur une machine virtuelle déployée sur un hôte Hyper-V est un appareil synthétique hautes performances. Nécessite un système d’exploitation invité prenant en compte la virtualisation sur la machine virtuelle.

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:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 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’externe lorsque le mode VLan est Access.

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 -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

-VM

Spécifie un objet de machine virtuelle.

Type:VM
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMHost

Spécifie un objet hôte de machine virtuelle. VMM prend en charge les hôtes Hyper-V, les hôtes VMware ESX et les hôtes Citrix XenServer.

Pour plus d’informations sur chaque type d’hôte, consultez l’applet de commande Add-SCVMHost .

Type:Host
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 get-SCVMNetwork.

Type:VMNetwork
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMNetworkServiceSetting

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

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

-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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMTemplate

Spécifie un objet de modèle VMM utilisé pour créer des machines virtuelles.

Type:Template
Alias:Template
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMwarePortGroup

Spécifie le groupe de ports VMware.

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

Sorties

VirtualNetworkAdapter

Cette applet de commande retourne un objet VirtualNetworkAdapter.

Notes

  • Nécessite un objet de machine virtuelle VMM, un objet de modèle de machine virtuelle ou un objet de profil matériel, qui peut être récupéré à l’aide des Get-SCVirtualMachine, Get-SCVMTemplateet Get-SCHardwareProfile applets de commande, respectivement.