Freigeben über

Move-SCVMHost

  • Referenz
Modul:
VirtualMachineManager

Verschiebt einen von VMM verwalteten virtuellen Computerhost von einer Hostgruppe in eine andere.

Syntax

Move-SCVMHost
    [-VMHost] <Host>
    -ParentHostGroup <HostGroup>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Move-SCVMHost verschiebt einen oder mehrere virtuelle Computerhosts, die vom Virtual Machine Manager (VMM) verwaltet werden, von der aktuellen Hostgruppe in eine neue übergeordnete Hostgruppe. Bevor Sie einen Host verschieben können, muss die neue übergeordnete Hostgruppe vorhanden sein.

Wenn der Host ein Computer ist, der von Mitgliedern einer Self-Service Benutzer- oder delegierter Administratorrolle verwaltet wird, wirkt sich das Verschieben des Hosts von einer Hostgruppe in eine andere möglicherweise auf die Rollen aus, die Zugriff auf den Host oder auf virtuelle Computer auf diesem Host haben.

Beispiele

Beispiel 1: Verschieben eines einzelnen Hosts in eine neue übergeordnete Hostgruppe

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup01" 
PS C:\> Move-SCVMHost -VMHost $VMHost -ParentHostGroup $NewHG

Der erste Befehl ruft den Host "VMHost01" ab und speichert ihn in der variablen $VMHost.

Der zweite Befehl ruft das Hostgruppenobjekt namens NewHostGroup ab und speichert es in der variablen $NewHG.

Der letzte Befehl verschiebt den in der $VMHost Variablen (VMHost01) gespeicherten Host in die Hostgruppe, die in der $NewHG Variablen (NewHostGroup) gespeichert ist.

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

PS C:\> $AllHosts = Get-SCVMHost  
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup02"
PS C:\> $AllHosts | Move-SCVMHost -ParentHostGroup $NewHG

Der erste Befehl ruft alle Hostobjekte ab und speichert sie im $AllHosts Array.

Der zweite Befehl ruft die Hostgruppe "NewHostGroup02" ab und speichert sie in der variablen $NewHG.

Der letzte Befehl verschiebt jedes Hostobjekt im $AllHosts Array in die neue übergeordnete Hostgruppe, die in der variablen $NewHG (NewHostGroup02) gespeichert ist.

Beispiel 3: Verschieben einer Gruppe von Hosts aus einer Hostgruppe in eine neue übergeordnete Hostgruppe

PS C:\> $SpecificHosts = Get-SCVMHost | where { $_.VMHostGroup -like "*OldGroup*" }
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup03" 
PS C:\> $SpecificHosts | Move-SCVMHost -ParentHostGroup $NewHG

Der erste Befehl ruft alle Hostobjekte ab, deren Hostgruppe die Zeichenfolge "OldGroup" enthält, und speichert sie in der $SpecificHosts Variablen.

Der zweite Befehl ruft die Hostgruppe "NewHostGroup03" ab und speichert sie in der variablen $NewHG.

Der letzte Befehl verschiebt jedes in $SpecificHosts gespeicherte Hostobjekt in die Hostgruppe, die in der Variablen $NewHG (NewHostGroup03) gespeichert ist.

Parameter

-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:True
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

-VMHost

Gibt ein Hostobjekt eines virtuellen Computers an. VMM unterstützt Hyper-V Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im cmdlet Add-SCVMHost.

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

Ausgaben

Host

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

Hinweise

  • Erfordert ein VMM-Hostobjekt, das mithilfe des cmdlets Get-SCVMHost abgerufen werden kann.