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 virtuella nätverk som du kan ändra är:

  • Valfri värd. För ett virtuellt nätverk som konfigurerats för virtuella datorer som distribueras på valfri 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: Koppla bort 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 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 binder bort 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. Att binda ett virtuellt nätverk till en värd möjliggör nätverkskommunikation till värden.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ClusterVirtualNetwork

Anger ett virtuellt klusternätverksobjekt.

Typ:ClusterVirtualNetwork
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ConvertToLogicalSwitch

Anger att den här cmdleten konverterar det virtuella nätverket till en logisk växel.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Anger en beskrivning för det virtuella nätverket.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HostBoundVLanId

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

Typ:UInt16
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobGroup

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

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln med namnet av den här parametern.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LogicalSwitch

Anger ett logiskt växelobjekt.

Typ:LogicalSwitch
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på ett VMM-objekt.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PROTipID

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

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VirtualNetwork

Anger ett virtuellt nätverksobjekt.

Typ:VirtualNetwork
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VMHostNetworkAdapters

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

Exempelformat: -VMHostNetworkAdapters $VMHostNICs

Typ:HostNetworkAdapter[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Utdata

VirtualNetwork

Den här cmdleten returnerar ett VirtualNetwork--objekt.