Remove-Inventory
This cmdlet removes the specified inventory items and their children from their locations.
Syntax
Parameters
Required | Parameter Name | Type | Position | Features | Description |
---|---|---|---|---|---|
required |
|
InventoryItem[] | named |
|
Specifies the inventory items you want to remove. This parameter accepts Folder, ResourcePool, Datacenter, VirtualMachine, VMHost, Cluster, Template, and VApp objects. | 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
Examples
Example 1
Get-Folder Folder| Get-Inventory -NoRecursion | Remove-Inventory
Removes all objects from the Folder 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.