Freigeben über

Set-SCVirtualNetwork

Modul:
VirtualMachineManager Module

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

Syntax

Host (Standardwert) 

Set-SCVirtualNetwork
    [-VirtualNetwork] <VirtualNetwork>
    [-Name <String>]
    [-Description <String>]
    [-BoundToVMHost <Boolean>]
    [-HostBoundVLanId <UInt16>]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

LogicalSwitch 

Set-SCVirtualNetwork
    [-VirtualNetwork] <VirtualNetwork>
    -LogicalSwitch <LogicalSwitch>
    [-VMHostNetworkAdapters <HostNetworkAdapter[]>]
    [-Description <String>]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

StandardSwitchToLogicalSwitch 

Set-SCVirtualNetwork
    [-VirtualNetwork] <VirtualNetwork>
    -LogicalSwitch <LogicalSwitch>
    [-Description <String>]
    [-JobGroup <Guid>]
    [-ConvertToLogicalSwitch]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Cluster 

Set-SCVirtualNetwork
    [-ClusterVirtualNetwork] <ClusterVirtualNetwork>
    [-Name <String>]
    [-Description <String>]
    [-BoundToVMHost <Boolean>]
    [-HostBoundVLanId <UInt16>]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Beschreibung

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

Zu den Eigenschaften virtueller Netzwerke, die Sie ändern können, gehören:

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

  • Hyper-V Nur Host. Wenn es sich bei dem Host um einen Hyper-V Host handelt, können Sie auch konfigurieren, ob virtuelle Maschinen an den Host gebunden sind (und somit auf das Host-Betriebssystem zugreifen können), und Sie können eine numerische Kennung für ein virtuelles lokales Netzwerk (VLAN) auf dem Host angeben.

Beispiele

Beispiel 1: Aufheben der Bindung eines virtuellen Netzwerks an einen 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 mit dem Namen VMHost01 ab und speichert das Objekt in der Variablen $VMHost.

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

Mit dem letzten Befehl wird das virtuelle Netzwerk in UnboundVNet01 umbenannt und VMHostBound auf $False festgelegt. Dadurch wird die Bindung des virtuellen Netzwerks an den Host aufgehoben, 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 mit dem Host.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Host
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Cluster
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ClusterVirtualNetwork

Gibt ein virtuelles Clusternetzwerkobjekt an.

Parametereigenschaften

Typ:ClusterVirtualNetwork
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Cluster
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConvertToLogicalSwitch

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

StandardSwitchToLogicalSwitch
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für das virtuelle Netzwerk an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-HostBoundVLanId

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

Parametereigenschaften

Typ:UInt16
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Host
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Cluster
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LogicalSwitch

Gibt ein logisches Switch-Objekt an.

Parametereigenschaften

Typ:LogicalSwitch
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

LogicalSwitch
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen eines VMM-Objekts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Host
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Cluster
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualNetwork

Gibt ein virtuelles Netzwerkobjekt an.

Parametereigenschaften

Typ:VirtualNetwork
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Host
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
LogicalSwitch
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHostNetworkAdapters

Gibt ein Array aus einem oder mehreren physischen Netzwerkadapterobjekten auf einem Host an, mit dem virtuelle Computer, die auf diesem Host bereitgestellt werden, eine Verbindung herstellen können.

Beispielformat: -VMHostNetworkAdapters $VMHostNICs

Parametereigenschaften

Typ:

HostNetworkAdapter[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

LogicalSwitch
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

VirtualNetwork

Dieses Cmdlet gibt ein VirtualNetwork-Objekt zurück.