Data Object - VirtualMachineCloneSpec

Parameter to
CloneVM_Task
Extends
DynamicData
See also
CustomizationSpec, VirtualMachineConfigSpec, VirtualMachineRelocateSpec, VirtualMachineSnapshot

Data Object Description

Specification for a virtual machine cloning operation.

Properties

Name Type Description
config*VirtualMachineConfigSpecDeprecated. as of vSphere API 6.0. Use deviceChange in location instead for specifying any virtual device changes for disks and networks. All other VM configuration changes should use ReconfigVM_Task API after the clone operation finishes.

An optional specification of changes to the virtual hardware. For example, this can be used to, (but not limited to) reconfigure the networks the virtual switches are hooked up to in the cloned virtual machine.
customization*CustomizationSpec

An optional guest operating system customization specification. This value is ignored if a template is being created.
locationVirtualMachineRelocateSpec

A type of RelocateSpec that specifies the location of resources the newly cloned virtual machine will use. The location specifies:
  • A datastore where the virtual machine will be located on physical storage. This is always provided because it indicates where the newly created clone will be copied.
  • a resource pool and optionally a host. The resource pool determines what compute resources will be available to the clone and the host indicates which machine will host the clone.

powerOnxsd:boolean

Specifies whether or not the new VirtualMachine should be powered on after creation. As part of a customization, this flag is normally set to true, since the first power-on operation completes the customization process. This flag is ignored if a template is being created.
snapshot*ManagedObjectReference
to a VirtualMachineSnapshot

Snapshot reference from which to base the clone.

If this parameter is set, the clone is based off of the snapshot point. This means that the newly created virtual machine will have the same configuration as the virtual machine at the time the snapshot was taken.

If this property is not set then the clone is based off of the virtual machine's current configuration.

Setting this is only supported if the host this virtual machine is currently residing on supports cloning from a snapshot point. Such support does not need to exist on the destination host for the clone.

Setting this is only supported if the virtual machine supports reporting snapshot configuration information. See snapshotConfigSupported. Such support does not need to exist on the destination host for the clone.

Since vSphere API 4.0
templatexsd:boolean

Specifies whether or not the new virtual machine should be marked as a template.
Properties inherited from DynamicData
None
*Need not be set