Delen via

Set-SCVirtualNetwork

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een virtueel netwerk dat is geconfigureerd op een host die wordt beheerd door 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

De cmdlet Set-SCVirtualNetwork wijzigt de eigenschappen van een virtueel netwerk dat is geconfigureerd op een host die wordt beheerd door Virtual Machine Manager (VMM).

Eigenschappen van het virtuele netwerk die u kunt wijzigen, zijn onder andere:

  • Elke host. Voor een virtueel netwerk dat is geconfigureerd voor virtuele machines die zijn geïmplementeerd op elke host die wordt ondersteund door VMM (een Hyper-V-, VMware ESX- of Citrix XenServer-host), kunt u de naam of beschrijving instellen of wijzigen.

  • Alleen Hyper-V-host. Als de host een Hyper-V-host is, kunt u ook configureren of virtuele machines zijn gebonden aan de host (en dus toegang hebben tot het hostbesturingssysteem) en u kunt een numerieke id opgeven voor een VLAN (Virtual Local Area Network) op de host.

Voorbeelden

Voorbeeld 1: Een virtueel netwerk van een host los koppelen

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

Met de eerste opdracht wordt het hostobject met de naam VMHost01 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht wordt het virtuele netwerkobject met de naam InternalVNet01 opgehaald uit VMHost01 en wordt het object opgeslagen in de $VirtualNetwork variabele.

Met de laatste opdracht wordt de naam van het virtuele netwerk gewijzigd in UnboundVNet01 en wordt VMHostBound ingesteld op $False. Hierdoor wordt het virtuele netwerk van de host losgekoppeld, waardoor virtuele machines die aan dit virtuele netwerk zijn gekoppeld, geen toegang krijgen tot de host via dit netwerk.

Parameters

-BoundToVMHost

Geeft aan of een virtueel netwerk is gebonden aan een host. Door een virtueel netwerk aan een host te binden, kan netwerkcommunicatie naar de host worden ingeschakeld.

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

-ClusterVirtualNetwork

Hiermee geeft u een virtueel clusternetwerkobject op.

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

-ConvertToLogicalSwitch

Geeft aan dat met deze cmdlet het virtuele netwerk wordt geconverteerd naar een logische switch.

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

-Description

Hiermee geeft u een beschrijving voor het virtuele netwerk.

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

-HostBoundVLanId

Wijst een VLAN toe aan de virtuele netwerkadapter die is gemaakt voor de host voor het opgegeven virtuele netwerk.

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

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

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

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

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

-LogicalSwitch

Hiermee geeft u een logisch switchobject op.

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

-Name

Hiermee geeft u de naam van een VMM-object.

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

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

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

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

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

-VirtualNetwork

Hiermee geeft u een virtueel netwerkobject op.

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

-VMHostNetworkAdapters

Hiermee geeft u een matrix op van een of meer fysieke netwerkadapterobjecten op een host waarop virtuele machines die op die host zijn geïmplementeerd, verbinding kunnen maken.

Voorbeeldindeling: -VMHostNetworkAdapters $VMHostNICs

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

Uitvoerwaarden

VirtualNetwork

Met deze cmdlet wordt een VirtualNetwork-object geretourneerd.