Dela via

Set-SCVirtualNetwork

  • Referens
Modul:
VirtualMachineManager

Ändrar egenskaperna för ett virtuellt nätverk som konfigurerats på en värd som hanteras av 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

Cmdleten Set-SCVirtualNetwork ändrar egenskaperna för ett virtuellt nätverk som konfigurerats på en värd som hanteras av Virtual Machine Manager (VMM).

Egenskaper för virtuellt nätverk som du kan ändra är:

  • Valfri värd. För ett virtuellt nätverk som har konfigurerats för virtuella datorer som distribuerats på en värd som stöds av VMM (en Hyper-V-, VMware ESX- eller Citrix XenServer-värd) kan du ange eller ändra namnet eller beskrivningen.

  • Endast Hyper-V-värd. Om värden är en Hyper-V-värd kan du också konfigurera om virtuella datorer är bundna till värden (och därmed kan komma åt värdoperativsystemet), och du kan ange en numerisk identifierare för ett virtuellt lokalt nätverk (VLAN) på värden.

Exempel

Exempel 1: Ta bort bindning av ett virtuellt nätverk från en värd

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

Det första kommandot hämtar värdobjektet med namnet VMHost01 och lagrar objektet i variabeln $VMHost.

Det andra kommandot hämtar det virtuella nätverksobjektet med namnet InternalVNet01 från VMHost01 och lagrar objektet i variabeln $VirtualNetwork.

Det senaste kommandot byter namn på det virtuella nätverket till UnboundVNet01 och anger VMHostBound till $False. Detta avbindar det virtuella nätverket från värden, vilket förhindrar att virtuella datorer som är anslutna till det här virtuella nätverket kommer åt värden via det här nätverket.

Parametrar

-BoundToVMHost

Anger om ett virtuellt nätverk är bundet till en värd. Genom att binda ett virtuellt nätverk till en värd kan du använda nätverkskommunikation till värden.

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

-ClusterVirtualNetwork

Anger ett virtuellt klusternätverksobjekt.

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

-ConvertToLogicalSwitch

Anger att denna cmdlet konverterar det virtuella nätverket till en logisk växel.

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

-Description

Anger en beskrivning av det virtuella nätverket.

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

-HostBoundVLanId

Tilldelar ett VLAN till det virtuella nätverkskort som skapades för värden för det angivna virtuella nätverket.

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

-JobGroup

Anger en identifierare för en serie kommandon som ska köras som en uppsättning precis innan det sista kommandot som innehåller samma jobbgruppsidentifierare körs.

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

-JobVariable

Anger att jobb förloppet spåras och lagras i variabeln med namnet av den här parametern.

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

-LogicalSwitch

Anger ett logiskt växelobjekt.

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

-Name

Anger namnet på ett VMM-objekt.

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

-PROTipID

Anger ID för tipset om prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-VirtualNetwork

Anger ett virtuellt nätverksobjekt.

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

-VMHostNetworkAdapters

Anger en matris med ett eller flera fysiska nätverkskortsobjekt på en värd som virtuella datorer som distribuerats på den värden kan ansluta till.

Exempelformat: -VMHostNetworkAdapters $VMHostNICs

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

Utdata

VirtualNetwork

Den här cmdleten returnerar ett VirtualNetwork-objekt .