Freigeben über

Set-SCVirtualNetwork

  • Referenz
Modul:
VirtualMachineManager

Ändert die Eigenschaften eines virtuellen Netzwerks, das auf einem von VMM verwalteten Host konfiguriert ist.

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>]

Beschreibung

Das cmdlet Set-SCVirtualNetwork ändert die Eigenschaften eines virtuellen Netzwerks, das auf einem Host konfiguriert ist, der von Virtual Machine Manager (VMM) verwaltet wird.

Zu den eigenschaften des virtuellen Netzwerks, die Sie ändern können, gehören:

  • Jeder Host. Für ein virtuelles Netzwerk, das für virtuelle Computer konfiguriert ist, die auf einem beliebigen Host bereitgestellt werden, der von VMM (einem Hyper-V-, VMware ESX- oder Citrix XenServer-Host) unterstützt wird, können Sie den Namen oder die Beschreibung festlegen oder ändern.

  • nur Hyper-V Host. Wenn der Host ein Hyper-V-Host ist, können Sie auch konfigurieren, ob virtuelle Computer an den Host gebunden sind (und somit auf das Hostbetriebssystem zugreifen können), und Sie können einen numerischen Bezeichner für ein virtuelles Lokales Netzwerk (VLAN) auf dem Host angeben.

Beispiele

Beispiel 1: Aufheben der Verknüpfung eines virtuellen Netzwerks von einem Host

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

Der erste Befehl ruft das Hostobjekt "VMHost01" ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl ruft das virtuelle Netzwerkobjekt "InternalVNet01" von VMHost01 ab und speichert das Objekt in der $VirtualNetwork Variablen.

Der letzte Befehl benennt das virtuelle Netzwerk in UnboundVNet01 um und legt VMHostBound- auf $False fest. Dadurch wird das virtuelle Netzwerk vom Host getrennt, wodurch verhindert wird, dass virtuelle Computer, die an dieses virtuelle Netzwerk angefügt sind, über dieses Netzwerk auf den Host zugreifen.

Parameter

-BoundToVMHost

Gibt an, ob ein virtuelles Netzwerk an einen Host gebunden ist. Das Binden eines virtuellen Netzwerks an einen Host ermöglicht die Netzwerkkommunikation an den Host.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClusterVirtualNetwork

Gibt ein virtuelles Clusternetzwerkobjekt an.

Typ:ClusterVirtualNetwork
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ConvertToLogicalSwitch

Gibt an, dass dieses Cmdlet das virtuelle Netzwerk in einen logischen Switch konvertiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für das virtuelle Netzwerk an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HostBoundVLanId

Weist dem virtuellen Netzwerkadapter, der für den Host für das angegebene virtuelle Netzwerk erstellt wurde, ein VLAN zu.

Typ:UInt16
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LogicalSwitch

Gibt ein logisches Switch-Objekt an.

Typ:LogicalSwitch
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines VMM-Objekts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetwork

Gibt ein virtuelles Netzwerkobjekt an.

Typ:VirtualNetwork
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMHostNetworkAdapters

Gibt ein Array von mindestens einem physischen Netzwerkadapterobjekt auf einem Host an, mit dem virtuelle Computer, die auf diesem Host bereitgestellt werden, eine Verbindung herstellen können.

Beispielformat: -VMHostNetworkAdapters $VMHostNICs

Typ:HostNetworkAdapter[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualNetwork

Dieses Cmdlet gibt ein VirtualNetwork--Objekt zurück.