Move-Inventory
This cmdlet moves a vCenter Server inventory object or template to the location that is specified by the Destination parameter.
Syntax
[-Destination]
<VIContainer>
-Item <InventoryItem[]>
[-DestinationSslThumbprint <String>]
[-RunAsync]
[-Server <VIServer[]>]
[CommonParameters]
-Item <InventoryItem[]>
[-DestinationSslThumbprint <String>]
[-RunAsync]
[-Server <VIServer[]>]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
VIContainer | 1 |
|
Specifies the location where you want to move the inventory items. | required |
|
InventoryItem[] | named |
|
Specifies the Folder, ResourcePool, Datacenter, VirtualMachine, VMHost, Template, or Cluster objects you want to move to another location. | optional |
|
String | named |
|
Specifies the SSL thumbprint of the destination server when moving virtual machines between vCenter Server systems. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. |
Output
VMware.VimAutomation.ViCore.Types.V1.Inventory.InventoryItem
Examples
Example 1
$vm = Get-VM -Name VM*
Move-Inventory -Item $vm -Destination Folder
Moves the virtual machines whose names start with VM to the Folder folder.
Example 2
Get-Folder Folder1 | Get-Inventory -NoRecursion | Move-Inventory -Destination Folder2
Moves all objects from the Folder1 folder to the Folder2 folder.
Related Commands
Inventory
This cmdlet retrieves the inventory items available on a vCenter Server system.
This cmdlet moves a vCenter Server inventory item from one location to another.
This cmdlet removes the specified inventory items from their locations.
