Partager via

New-SCVirtualNetworkAdapter

  • Référence
Module:
VirtualMachineManager

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.

Syntax

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

L’applet de commande 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.

Adaptateurs de Réseau virtuel synthétiques ou émulés

Vous pouvez utiliser l’applet de commande New-SCVirtualNetworkAdapter pour créer un adaptateur dont le type est émulé (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 des hôtes Hyper-V, 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 du réseau local virtuel 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 pour New-SCVMHostNetworkAdapterConfig et Set-SCVMHostNetworkAdapter.

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 : 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 part du principe 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 a 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
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

-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

-HardwareProfile

Spécifie un objet profil matériel.

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

-InheritsAddressFromPhysicalNetworkAdapter

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

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

-IPv4Address

Spécifie une adresse IPv4.

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

-IPv4AddressPool

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

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

-IPv6Address

Spécifie une adresse IPv6.

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

-IPv6AddressPool

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

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

-LogicalSwitch

Spécifie un objet de commutateur logique.

Type:LogicalSwitch
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-Name

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

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

-NoVMNetwork

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

Type:SwitchParameter
Aliases:NoLogicalNetwork
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:True
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

-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. L’ordinateur virtuel doit posséder un système d’exploitation invité prenant en charge la virtualisation.

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:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanEnabled

Indique s’il faut activer un réseau local virtuel (VLAN) pour une utilisation 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
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é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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

Spécifie un objet ordinateur virtuel.

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

-VMHost

Spécifie un objet ordinateur hôte d’ordinateur virtuel. 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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:True
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

-VMTemplate

Spécifie un objet modèle VMM utilisé pour créer des ordinateurs virtuels.

Type:Template
Aliases:Template
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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 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 applets de commande Get-SCVirtualMachine, Get-SCVMTemplate et Get-SCHardwareProfile , respectivement.