Move-SCVMHostCluster

Reference

Module:: VirtualMachineManager

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

Syntax

Move-SCVMHostCluster
    [-VMHostCluster] <HostCluster>
    -ParentHostGroup <HostGroup>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<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
Position:	Named
Default value:	None
Required:	False
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
Position:	Named
Default value:	None
Required:	True
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
Position:	Named
Default value:	None
Required:	False
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
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMHostCluster

Specifies a VMM host cluster object.

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

Outputs

VMHostCluster

This cmdlet returns a VMHostCluster object.