Partager via

Set-SCVirtualNetwork

  • Référence
Module:
VirtualMachineManager

Modifie les propriétés d’un réseau virtuel configuré sur un hôte géré par VMM.

Syntaxe

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-VMHostNetworkAdapters <HostNetworkAdapter[]>]
   [-Description <String>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-Description <String>]
   [-JobGroup <Guid>]
   [-ConvertToLogicalSwitch]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-ClusterVirtualNetwork] <ClusterVirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Set-SCVirtualNetwork modifie les propriétés d’un réseau virtuel configuré sur un hôte géré par Virtual Machine Manager (VMM).

Les propriétés de réseau virtuel que vous pouvez modifier sont les suivantes :

  • Tout hôte. Pour un réseau virtuel configuré pour les machines virtuelles déployées sur n’importe quel hôte pris en charge par VMM (un hôte Hyper-V, VMware ESX ou Citrix XenServer), vous pouvez définir ou modifier le nom ou la description.

  • Hyper-V hôte uniquement. Si l’hôte est un hôte Hyper-V, vous pouvez également configurer si les machines virtuelles sont liées à l’hôte (et peuvent ainsi accéder au système d’exploitation hôte) et spécifier un identificateur numérique pour un réseau local virtuel (VLAN) sur l’hôte.

Exemples

Exemple 1 : Dissocier un réseau virtuel à partir d’un hôte

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> Set-SCVirtualNetwork -VirtualNetwork $VirtualNetwork -Name "UnboundVNet01" -BoundToVMHost $False

La première commande obtient l’objet hôte nommé VMHost01 et stocke l’objet dans la variable $VMHost.

La deuxième commande obtient l’objet de réseau virtuel nommé InternalVNet01 à partir de VMHost01 et stocke l’objet dans la variable $VirtualNetwork.

La dernière commande renomme le réseau virtuel en UnboundVNet01 et définit vmHostBound sur $False. Cela dissocie le réseau virtuel de l’hôte, ce qui empêche les machines virtuelles attachées à ce réseau virtuel d’accéder à l’hôte via ce réseau.

Paramètres

-BoundToVMHost

Indique si un réseau virtuel est lié à un hôte. La liaison d’un réseau virtuel à un hôte permet la communication réseau à l’hôte.

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

-ClusterVirtualNetwork

Spécifie un objet de réseau virtuel de cluster.

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

-ConvertToLogicalSwitch

Indique que cette applet de commande convertit le réseau virtuel en commutateur logique.

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

-Description

Spécifie une description du réseau virtuel.

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

-HostBoundVLanId

Affecte un réseau local virtuel à la carte réseau virtuelle créée pour l’hôte pour le réseau virtuel spécifié.

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

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

-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

-Name

Spécifie le nom d’un objet VMM.

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

-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

-VirtualNetwork

Spécifie un objet de réseau virtuel.

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

-VMHostNetworkAdapters

Spécifie un tableau d’un ou plusieurs objets de carte réseau physique sur un hôte auquel les machines virtuelles déployées sur cet hôte peuvent se connecter.

Exemple de format : -VMHostNetworkAdapters $VMHostNICs

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

Sorties

VirtualNetwork

Cette applet de commande retourne un objet VirtualNetwork.