Move-SCVMHostGroup

Verschiebt eine Hostgruppe vom aktuellen Speicherort in einen neuen Speicherort unter einem anderen übergeordneten Hostgruppe.

Syntax

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

Beschreibung

Das Cmdlet Move-SCVMHostGroup verschiebt eine oder mehrere Hostgruppenobjekte, die virtuelle Computerhosts enthalten, die von Virtual Machine Manager (VMM) verwaltet werden, von der aktuellen Position in 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 in einer verschobenen Hostgruppe erhalten einen neuen Hostpfad, der relativ zur Stammhostgruppe ist. Durch das Ändern der Struktur von Hostgruppen wird möglicherweise geändert, welche Self-Service-Benutzerrollen oder Benutzerrollen für einen delegierten Administrator über Zugriff auf die in der betroffenen Hostgruppe enthaltenen Hosts oder auf diesen Hosts bereitgestellten virtuellen Maschinen verfügen.

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 $OldHostGroup Variablen.

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 in einen Speicherort unter der neuen übergeordneten Hostgruppe, die in der $NewHostGroup Variablen 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 umfasst die Standardmäßige übergeordnete Hostgruppe (Alle Hosts).

Der zweite Befehl erstellt ein Hostgruppenobjekt namens NewHostGroup01 und speichert ihn in der $HostGroup Variable.

Der letzte Befehl übergibt jedes in der $AllGroups Variable gespeicherte Hostgruppenobjekt an das Cmdlet Move-VMHostGroup , das jedes Hostgruppenobjekt an den Speicherort verschiebt, der in der $HostGroup-Variable gespeichert ist, außer für alle Hosts, da alle Hosts die Standard-übergeordnete Hostgruppe sind und nicht verschoben werden können.

Parameter

-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

-ParentHostGroup

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

Type:HostGroup
Aliases:ParentVMHostGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die 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, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-VMHostGroup

Gibt ein Hostgruppenobjekt für virtuelle Maschinen an.

Type:HostGroup
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.