Freigeben über

Set-SCLogicalNetworkDefinition

  • Referenz
Modul:
VirtualMachineManager

Ändert eine logische Netzwerkdefinition.

Syntax

Set-SCLogicalNetworkDefinition
   [-VMMServer <ServerConnection>]
   [-LogicalNetworkDefinition] <LogicalNetworkDefinition>
   [-AddVMHostGroup <HostGroup[]>]
   [-RemoveVMHostGroup <HostGroup[]>]
   [-Name <String>]
   [-SubnetVLan <SubnetVLan[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-SCLogicalNetworkDefinition ändert eine logische Netzwerkdefinition. Sie können beispielsweise einer Hostgruppe eine Hostgruppe hinzufügen oder aus einer logischen Netzwerkdefinition entfernen (auch als Netzwerkstandort bezeichnet).

Beispiele

Beispiel 1: Ändern der Hostgruppen, die einer logischen Netzwerkdefinition zugeordnet sind

PS C:\> $LogicalNetwork = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $VMHostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production"}
PS C:\> $Definition = Get-SCLogicalNetworkDefinition -LogicalNetwork $LogicalNetwork -VMHostGroup $VMHostGroup -Name "Logical Network Definition 01"
PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup03\Production" }
PS C:\> Set-SCLogicalNetworkDefinition -LogicalnetworkDefinition $Definition -AddVMHostGroup $HostGroup

Der erste Befehl ruft das logische Netzwerk mit dem Namen "LogicalNetwork01" ab und speichert es in der $LogicalNetwork Variablen.

Der zweite Befehl ruft die Hostgruppe "Alle Hosts\HostGroup02\Production" ab und speichert sie in der $VMHostGroup Variablen.

Der dritte Befehl ruft die logische Netzwerkdefinition "Logical Network Definition 01" ab, die dem logischen Netzwerk zugeordnet ist, das in $LogicalNetwork gespeichert ist, und die in $VMHostGroup gespeicherte Hostgruppe.

Der vierte Befehl ruft das Hostgruppenobjekt mit dem Namen "All Hosts\HostGroup-3\Production" ab und speichert das Objekt in der $HostGroup Variablen.

Mit dem letzten Befehl wird die in $HostGroup gespeicherte Hostgruppe zum vorhandenen Hostgruppenarray für die logische Netzwerkdefinition hinzugefügt, die in $Definition gespeichert ist (Logische Netzwerkdefinition 01).

Parameter

-AddVMHostGroup

Gibt ein Array einer oder mehrerer Hostgruppen an, die einem vorhandenen Hostgruppenarray oder einer privaten Cloud hinzugefügt werden sollen.

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

-JobVariable

Gibt den Namen einer Variablen an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

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

-LogicalNetworkDefinition

Gibt eine logische Netzwerkdefinition (auch als Netzwerkstandort bezeichnet) an, die das Subnetz enthält, das vom IP-Adresspool bereitgestellt wird, wie durch den Parameter -SubnetVLan angegeben.

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

-Name

Gibt den Namen eines VMM-Objekts (Virtual Machine Manager) 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

-RemoveVMHostGroup

Gibt ein Array einer oder mehrerer Hostgruppen an, die aus einem Hostgruppenarray oder einer privaten Cloud entfernt werden sollen.

Typ:HostGroup[]
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

-SubnetVLan

Gibt ein Array eines oder mehrerer IP-Subnetz- und VLAN-Sätze an.

Informationen zum Erstellen eines Subnetzlans: Get-Help New-SCSubNetVLan.

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

-VMMServer

Gibt ein VMM-Serverobjekt (Virtual Machine Manager) an.

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

Ausgaben

LogicalNetworkDefiniton

Dieses Cmdlet gibt ein LogicalNetworkDefiniton-Objekt zurück.

Hinweise

  • Erfordert ein logisches VMM-Netzwerkdefinitionsobjekt, das Sie mithilfe des cmdlets Get-SCLogicalNetworkDefinition abrufen.