vSphere PowerCLI Reference

Move-ResourcePool

Synopsis

Moves a resource pool from one location to another.

Syntax

Move-ResourcePool [-ResourcePool] <ResourcePool[]> [-Destination] <VIContainer> [-Server <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-ResourcePool
New-ResourcePool
Remove-ResourcePool
Set-ResourcePool

Detailed Description

Moves a vSphere resource pool to the location that is specified by the -Destination parameter. To specify a server different from the default one, use the -Server parameter. Moving a resource pool is only supported when the objects assigned to the -ResourcePool and -Destination parameters are passed through connections to one and the same server with the same credentials.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
ResourcePoolResourcePool[]Specify the resource pools you want to move to another location.truetrue (ByValue)
DestinationVIContainerSpecify the location where you want to move the resource pools. If a host or a cluster is specified for the -Destination parameter, the resource pool is moved into a resource pool named Resources. The Resources resource pool is a system resource pool and is guaranteed to exist.truefalse
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse$true
ServerVIServer[]Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falsefalse
WhatIfSwitchParameterIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

ResourcePool

Notes

Examples

-------------- Example 1 --------------

Move-ResourcePool -ResourcePool ResourcePool -Destination Host

Moves the resource pool named ResourcePool to the virtual machine host Host.


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.