Move-SCVMHost
Verschiebt einen von VMM verwalteten Host einer virtuellen Maschine von einer Hostgruppe in eine andere.
Syntax
Default (Standardwert)
Move-SCVMHost
[-VMHost] <Host>
-ParentHostGroup <HostGroup>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Move-SCVMHost werden ein oder mehrere VM-Hosts, die von Virtual Machine Manager (VMM) verwaltet werden, von der aktuellen Hostgruppe in eine neue übergeordnete Hostgruppe verschoben. Bevor Sie einen Host verschieben können, muss die neue übergeordnete Hostgruppe vorhanden sein.
Wenn es sich bei dem Host um einen Computer handelt, der von Mitgliedern einer Benutzerrolle "Self-Service Benutzer" oder "Delegierter Administrator" verwaltet wird, kann sich das Verschieben des Hosts von einer Hostgruppe in eine andere auf die Rollen auswirken, die Zugriff auf den Host oder auf virtuelle Maschinen 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 mit dem Namen VMHost01 ab und speichert ihn in der Variablen $VMHost.
Der zweite Befehl ruft das Hostgruppenobjekt mit dem Namen NewHostGroup ab und speichert es in der Variablen $NewHG.
Mit dem letzten Befehl wird der Host, der in der Variablen $VMHost (VMHost01) gespeichert ist, in die Hostgruppe verschoben, die in der Variablen $NewHG (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 mit dem Namen NewHostGroup02 ab und speichert sie in der Variablen $NewHG.
Mit dem letzten Befehl werden alle Hostobjekte im $AllHosts Array in die neue übergeordnete Hostgruppe verschoben, die in der Variablen $NewHG (NewHostGroup02) gespeichert ist.
Beispiel 3: Verschieben einer Gruppe von Hosts von 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 holt sich alle Host-Objekte, deren Hostgruppe den String "OldGroup" enthält, und speichert sie in der Variablen $SpecificHosts.
Der zweite Befehl ruft die Hostgruppe mit dem Namen NewHostGroup03 ab und speichert sie in der Variablen $NewHG.
Der letzte Befehl verschiebt jedes Hostobjekt, das in $SpecificHosts gespeichert ist, 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.
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 |
-ParentHostGroup
Gibt die übergeordnete Hostgruppe an, die einen oder mehrere Hosts, Hostgruppen oder Hostcluster enthält.
Parametereigenschaften
| Typ: | HostGroup |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Übergeordnete VMHostGruppe |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| 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 |
-VMHost
Gibt ein Hostobjekt für eine virtuelle Maschine an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.
Weitere Informationen zu den einzelnen Hosttypen finden Sie unter dem Cmdlet Add-SCVMHost .
Parametereigenschaften
| Typ: | Host |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| 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
Host
Dieses Cmdlet gibt ein Host-Objekt zurück.
Hinweise
- Erfordert ein VMM-Hostobjekt, das mit dem Cmdlet Get-SCVMHost abgerufen werden kann.