Freigeben über

Move-SCVMHostGroup

  • Referenz
Modul:
VirtualMachineManager

Verschiebt eine Hostgruppe von der aktuellen Position an einen neuen Speicherort unter einer anderen übergeordneten Hostgruppe.

Syntax

Move-SCVMHostGroup
    [-VMHostGroup] <HostGroup>
    [-JobGroup <Guid>]
    -ParentHostGroup <HostGroup>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Move-SCVMHostGroup Cmdlet verschiebt mindestens ein Hostgruppenobjekt, das virtuelle Computerhosts enthält, die vom Virtual Machine Manager (VMM) verwaltet werden, von dem aktuellen Speicherort an einen neuen Speicherort unter einem anderen übergeordneten Hostgruppenelement. Sie können Hostgruppen unter der Standardstammhostgruppe (Alle Hosts) oder unter einer anderen Hostgruppe platzieren, die von einem Administrator erstellt wurde.

Alle Hosts innerhalb einer verschobenen Hostgruppe erwerben einen neuen Hostpfad relativ zur Stammhostgruppe. Das Ändern der Struktur von Hostgruppen kann ändern, welche Self Service-Benutzer- oder delegierte Administratorbenutzerrollen Zugriff auf die Hosts haben, die in den betroffenen Hostgruppen enthalten sind, oder auf die virtuellen Computer, die auf diesen Hosts bereitgestellt werden.

Beispiele

Beispiel 1: Verschieben einer Hostgruppe in eine neue übergeordnete Hostgruppe

PS C:\> $OldHostGroup = Get-SCVMHostGroup -Name "OldHostGroup"
PS C:\> $NewHostGroup = Get-SCVMHostGroup -Name "NewHostGroup"
PS C:\> Move-SCVMHostGroup -VMHostGroup $OldHostGroup -ParentHostGroup $NewHostGroup

Der erste Befehl ruft die Hostgruppe "OldHostGroup" ab und speichert das Hostgruppenobjekt in der variablen $OldHostGroup.

Der zweite Befehl ruft die Hostgruppe "NewHostGroup" ab und speichert dieses Hostgruppenobjekt in der $NewHostGroup Variablen.

Der letzte Befehl verschiebt die in der $OldHostGroup Variable (OldHostGroup) gespeicherte Hostgruppe an einen Speicherort unter der neuen übergeordneten Hostgruppe, die in der variablen $NewHostGroup gespeichert ist.

Beispiel 2: Verschieben aller Hostgruppen in eine neue übergeordnete Hostgruppe

PS C:\> $AllGroups = Get-SCVMHostGroup
PS C:\> $HostGroup = New-SCVMHostGroup -Name "NewHostGroup01" 
PS C:\> $AllGroups | Move-SCVMHostGroup -ParentHostGroup $HostGroup

Der erste Befehl ruft alle Hostgruppenobjekte ab und speichert sie im $AllGroups Array. Dies schließt die standardmäßige übergeordnete Hostgruppe (Alle Hosts) ein.

Der zweite Befehl erstellt ein Hostgruppenobjekt namens NewHostGroup01 und speichert es in der $HostGroup Variablen.

Der letzte Befehl übergibt jedes Hostgruppenobjekt, das in der $AllGroups Variablen gespeichert ist, an das Cmdlet Move-VMHostGroup, das jedes Hostgruppenobjekt an den Speicherort verschiebt, der in der $HostGroup Variablen gespeichert ist, mit Ausnahme von "Alle Hosts", da "Alle Hosts" die standardmäßige übergeordnete Hostgruppe ist und nicht verschoben werden kann.

Parameter

-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

-ParentHostGroup

Gibt die übergeordnete Hostgruppe an, die einen oder mehrere Hosts, Hostgruppen oder Hostcluster enthält.

Typ:HostGroup
Aliase:ParentVMHostGroup
Position:Named
Standardwert:None
Erforderlich:True
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

-VMHostGroup

Gibt ein Hostgruppenobjekt eines virtuellen Computers an.

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

Ausgaben

HostGroup

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

Hinweise

  • Erfordert ein VMM-Hostgruppenobjekt, das mithilfe des cmdlets Get-SCVMHostGroup abgerufen werden kann.