Share via

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.