Data Object - ConverterAgentInternalManagedVMOptions

Extends
ConverterAgentInternalVMOptions
See also
ConverterAgentInternalLoginCredentials, Datastore, Folder, HostSystem, ResourcePool
Since
Converter API 1.0

Data Object Description

ConverterAgentInternalManagedVMOptions defines options for creating a managed (ESX/VC) virtual machine.

Properties

Name Type Description
datastore*ManagedObjectReference
to a Datastore

Datastore to store the new VM. If not specified, the default datastore associated with the resource pool is used. VMX files are stored in this datastore - individual backing stores may be specified using datastoreLocations
datastoreLocations*ManagedObjectReference[]
to a Datastore[]

DatastoreLocations for each disk in the new VM. If not specified, the datastore is used for all disks in the new VM If insufficient entries are specified, the last entry will be used for all the rest. VMX files are stored in datastore even when individual backing stores are specified using datastoreLocations When one or more of these locations are not accessible, all the disks will be created on the datastore
doNotCreateUnspecifiedDevices*xsd:boolean

ManagedVMCreatorImpl::PopulateConfig creates unspecified but necessary devices, by default.

So, if corresponding devices are not specified in the VirtualMachineConfigSpec, the ManagedVMCreator will create the following:

The following devices seem to always be present in the default config, among others. They don't need to be created. It is not clear whether duplicates will need to be deleted. However, the issue has not come up:
  • Primary IDE controller
  • Secondary IDE controller

Set this optional flag in order to turn off that behavior. We've made this an option that has to be requested, rather than the default, so that tests and code that depend on the old behavior won't start to fail.

host*ManagedObjectReference
to a HostSystem

The target HostSystem on which the virtual machine will run. This must specify a host that is a member of the ComputeResource indirectly specified by the pool. For a stand-alone host or a cluster with DRS, host can be omitted, and the system selects a default.
loginConverterAgentInternalLoginCredentials

How to log into the destination.
resourcePool*ManagedObjectReference
to a ResourcePool

ResourcePool to assign the new VM to. If not specified, the default ResourcePool associated with the datacenter selected by vmFolder is used.
vmFolder*ManagedObjectReference
to a Folder

VirtualMachine Folder to create the new VM. If not specified, the default VM folder is used.
Properties inherited from ConverterAgentInternalVMOptions
basicHardwareParams, config, networkParams, preserveDeviceBacking, preserveIdentity, targetStorageLayout, vmName, vmxnetPresent
Properties inherited from DynamicData
None
*Need not be set