• A folder can contain a child folder of the same type as the parent folder.
• All VcDatacenter objects contain dedicated folders for:
  • VcVirtualApp objects.
  • VcComputeResource hierarchies.
  • VcDistributedVirtualSwitch, and VcDistributedVirtualPortgroup objects.
  • VcDatastore objects.
• A folder can contain child objects of type VcFolder. Virtual machine and network entity folders can also contain additional object types.
• The root folder is a data center folder.

The VcFolder managed object also acts as a factory object, meaning it creates new entities in a folder. The object provides methods to create child folders and objects, methods to add existing objects to folders, and methods to remove objects from folders and to delete folders.

VcManagedEntity method. VcManagedEntity is a recursive operation that removes all child objects and folders. When you call VcManagedEntity to destroy a folder, the system uses the specified folder as a root and traverses its descendant hierarchy, calling VcManagedEntity on each object. VcManagedEntity is a single operation that treats each recursive call as a single transaction, committing each call to remove an object individually. If VcManagedEntity fails on an object, the method terminates at that point with an exception, leaving some or all of the objects still in the inventory.

Notes on the folder destroy method:

• Calling VcManagedEntity on a virtual machine folder recursively calls VcManagedEntity on all the child virtual machines and vApps, which are then removed from disk. Use VcFolder to unregister virtual machines or vApps recursively without removing them from the disk.
• For virtual machine folders, the VcManagedEntity method requires the VirtualMachine.Delete privilege on the folder as well as all virtual machines to be destroyed. It also requires the VirtualApp.Delete privilege on all VirtualApp objects to be destroyed.
• Destroying a host folder or datacenter folder unregisters all child hosts and virtual machines from vCenter. The hosts are simply removed from the inventory, along with their virtual machines. The virtual machines are not removed from disk nor are their runtime states changed.
• You can remove network and datastore folders only if they are empty.
• You cannot destroy, rename, or move the virtual machine, compute resource, network entity, and datastore child folders of a Datacenter.