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