Move-SCVMHostCluster

Moves a host cluster object managed by VMM from one host group to another.

Description

The Move-SCVMHostCluster cmdlet moves a host cluster object managed by System Center Virtual Machine Manager (VMM) from one host group to another. 

You cannot use the Move-SCVMHostCluster cmdlet to move a VMware host cluster. Instead, use vCenter Server to move a VMware host cluster.

For more information about Move-SCVMHostCluster, type: "Get-Help Move-SCVMHostCluster -online".

Parameters

VMHostCluster

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0
Specifies a VMM host cluster object.

ParentHostGroup

Required? true
Accept Pipeline Input? false
Position? named
Specifies the parent host group that contains one or more hosts, host groups, or host clusters.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named
Specifies that job progress is tracked and stored in the variable named by this parameter. 

PROTipID

Required? false
Accept Pipeline Input? false
Position? named
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named
Indicates that the job runs asynchronously so that control returns to the command shell immediately. 

Examples

1: Move a specified host cluster to a new parent host group.
PS C:\> $VMHostCluster = Get-SCVMHostCluster -Name "VMHostCluster01.Contoso.com"
PS C:\> $DestinationHG = Get-SCVMHostGroup -Name "Production"
PS C:\> Move-SCVMHostCluster -VMHostCluster $VMHostCluster -ParentHostGroup $DestinationHG
The first command gets the host cluster object named VMHostCluster01.Contoso.com and stores the object in the $VMHostCluster variable.

The second command gets the host group object named Production and stores the object in the $DestinationHG variable.

The last command moves host cluster VMHostCluster01.Contoso.com, stored in $VMHostCluster, from its current host group to the host group named Production, stored in $DestinationHG.

See Also