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.

Syntax

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 :

  • N’importe quel 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.

  • Hôte Hyper-V 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 vous pouvez 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. Cette opération annule la liaison du réseau virtuel à l’ordinateur hôte, ce qui empêche tout ordinateur virtuel attaché à ce réseau virtuel d’accéder à l’ordinateur hôte par le biais de 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClusterVirtualNetwork

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

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

-ConvertToLogicalSwitch

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

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

-Description

Spécifie une description du réseau virtuel.

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

-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

-Name

Spécifie le nom d’un objet VMM.

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

-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

-VirtualNetwork

Spécifie un objet réseau virtuel.

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

-VMHostNetworkAdapters

Spécifie un tableau d’un ou plusieurs objets carte réseau physique d’un ordinateur hôte auxquels les ordinateurs virtuels déployés sur cet ordinateur hôte peuvent se connecter.

Exemple de format : -VMHostNetworkAdapters $VMHostNICs

Type:HostNetworkAdapter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Sorties

VirtualNetwork

Cette applet de commande retourne un objet VirtualNetwork .