Move-SCVMHostCluster

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

Syntax

Move-SCVMHostCluster [-VMHostCluster] <HostCluster> [-JobVariable <String>] [-PROTipID <Guid>]
 -ParentHostGroup <HostGroup> [-RunAsynchronously] [<CommonParameters>]

Description

The Move-SCVMHostCluster cmdlet moves a host cluster object managed by 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.

Examples

Example 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.

Parameters

-JobVariable

Specifies that job progress is tracked and stored in the variable named by this parameter.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Type:Guid
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ParentHostGroup

Specifies the parent host group that contains one or more hosts, host groups, or host clusters.

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

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

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

Specifies a VMM host cluster object.

Type:HostCluster
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

VMHostCluster

This cmdlet returns a **VMHostCluster** object.