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 virtuellen Netzwerkeigenschaften, 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 (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 damit 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 namens VMHost01 ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl ruft das virtuelle Netzwerkobjekt namens 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 die Bindung des virtuellen Netzwerks an den Host aufgehoben, sodass virtuelle Maschinen, die mit diesem virtuellen Netzwerk verbunden sind, nicht mehr über dieses Netzwerk auf den Host zugreifen können.

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.

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

-ClusterVirtualNetwork

Gibt ein virtuelles Clusternetzwerkobjekt an.

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

-ConvertToLogicalSwitch

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

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

-Description

Gibt eine Beschreibung für das virtuelle Netzwerk an.

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

-HostBoundVLanId

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

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-LogicalSwitch

Gibt ein logisches Switchobjekt an.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

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

-RunAsynchronously

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

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

-VirtualNetwork

Gibt ein virtuelles Netzwerkobjekt an.

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

-VMHostNetworkAdapters

Gibt ein Array aus einem oder mehreren physischen Netzwerkadapterobjekten auf einem Host an, mit dem auf diesem Host bereitgestellte virtuelle Maschinen Verbindungen herstellen können.

Beispielformat: -VMHostNetworkAdapters $VMHostNICs

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

Ausgaben

VirtualNetwork

Dieses Cmdlet gibt ein VirtualNetwork-Objekt zurück.