Data Object Description

Properties

Name	Type	Description
alternateGuestName	xsd:string	Used as display name for the operating system if guestId is `other` or `other-64`. See guestFullName *Since* VI API 2.5
annotation*	xsd:string	Description for the virtual machine.
bootOptions*	VirtualMachineBootOptions	Configuration options for the boot behavior of the virutal machine. *Since* VI API 2.5
changeVersion	xsd:string	The changeVersion is a unique identifier for a given version of the configuration. Each change to the configuration updates this value. This is typically implemented as an ever increasing count or a time-stamp. However, a client should always treat this as an opaque string.
consolePreferences*	VirtualMachineConsolePreferences	Legacy console viewer preferences when doing power operations.
cpuAffinity*	VirtualMachineAffinityInfo	Affinity settings for CPU.
cpuAllocation*	ResourceAllocationInfo	Resource limits for CPU.
cpuFeatureMask*	HostCpuIdInfo[]	Specifies CPU feature compatibility masks that override the defaults from the GuestOsDescriptor of the virtual machine's guest OS.
datastoreUrl*	VirtualMachineConfigInfoDatastoreUrlPair[]	Enumerates the set of datastores that this virtual machine is stored on, as well as the URL identification for each of these. Changes to datastores do not generate property updates on this property. However, when this property is retreived it returns the current datastore information.
defaultPowerOps	VirtualMachineDefaultPowerOpInfo	Configuration of default power operations.
extraConfig*	OptionValue[]	Additional configuration information for the virtual machine.
files	VirtualMachineFileInfo	Information about the files associated with a virtual machine. This information does not include files for specific virtual disks or snapshots.
flags	VirtualMachineFlagInfo	Additional flags for a virtual machine.
guestFullName	xsd:string	This is the full name of the guest operating system for the virtual machine. For example: Windows 2000 Professional. See alternateGuestName
guestId	xsd:string	Guest operating system configured on a virtual machine. This is a guest identifier that can be used to access the GuestOsDescriptor list for information about default configuration. For more information on possible values, see VirtualMachineGuestOsIdentifier.
hardware	VirtualHardware	Processor, memory, and virtual devices for a virtual machine.
locationId*	xsd:string	Hash incorporating the virtual machine's config file location and the UUID of the host assigned to run the virtual machine.
memoryAffinity*	VirtualMachineAffinityInfo	Affinity settings for memory.
memoryAllocation*	ResourceAllocationInfo	Resource limits for memory.
modified	xsd:dateTime	Last time a virtual machine's configuration was modified.
name	xsd:string	Display name of the virtual machine. Any / (slash), \ (backslash), character used in this name element is escaped. Similarly, any % (percent) character used in this name element is escaped, unless it is used to start an escape sequence. A slash is escaped as %2F or %2f. A backslash is escaped as %5C or %5c, and a percent is escaped as %25.
networkShaper*	VirtualMachineNetworkShaperInfo	Resource limits for network.
npivNodeWorldWideName*	xsd:long[]	A 64-bit node WWN (World Wide Name). These WWNs are paired with the npivPortWorldWideName to be used by the NPIV VPORTs instantiated for the virtual machine on the physical HBAs of the host. A pair of node and port WWNs serves as a unique identifier in accessing a LUN, so that it can be monitored or controlled by the storage administrator. If this property contains a single node WWN, the same node WWN is used to pair with all port WWNs listed in npivPortWorldWideName. If this property or npivPortWorldWideName is empty or unset, NPIV WWN is disabled for the virtual machine. *Since* VI API 2.5
npivPortWorldWideName*	xsd:long[]	A 64-bit port WWN (World Wide Name). For detail description on WWN, see npivNodeWorldWideName. *Since* VI API 2.5
npivWorldWideNameType*	xsd:string	The source that provides/generates the assigned WWNs. See VirtualMachineConfigInfoNpivWwnType *Since* VI API 2.5
swapPlacement*	xsd:string	Virtual machine swapfile placement policy. This will be unset if the virtual machine's swapPlacementSupported capability is false. If swapPlacementSupported is true, the default policy is "inherit". See VirtualMachineConfigInfoSwapPlacementType *Since* VI API 2.5
template	xsd:boolean	Flag indicating whether or not a virtual machine is a template.
tools*	ToolsConfigInfo	Configuration of VMware Tools running in the guest operating system.
uuid	xsd:string	128-bit SMBIOS UUID of a virtual machine represented as a hexadecimal string in "12345678-abcd-1234-cdef-123456789abc" format.
version	xsd:string	The version string for this virtual machine.
Properties inherited from DynamicData
dynamicProperty, dynamicType

Name

Type

Description

alternateGuestName

xsd:string

Used as display name for the operating system if guestId is other or other-64.
See guestFullName

Since VI API 2.5

annotation*

xsd:string

Description for the virtual machine.

bootOptions*

VirtualMachineBootOptions

Configuration options for the boot behavior of the virutal machine.

Since VI API 2.5

changeVersion

xsd:string

The changeVersion is a unique identifier for a given version of the configuration. Each change to the configuration updates this value. This is typically implemented as an ever increasing count or a time-stamp. However, a client should always treat this as an opaque string.

consolePreferences*

VirtualMachineConsolePreferences

Legacy console viewer preferences when doing power operations.

cpuAffinity*

VirtualMachineAffinityInfo

Affinity settings for CPU.

cpuAllocation*

ResourceAllocationInfo

Resource limits for CPU.

cpuFeatureMask*

HostCpuIdInfo[]

Specifies CPU feature compatibility masks that override the defaults from the GuestOsDescriptor of the virtual machine's guest OS.

datastoreUrl*

VirtualMachineConfigInfoDatastoreUrlPair[]

Enumerates the set of datastores that this virtual machine is stored on, as well as the URL identification for each of these.

Changes to datastores do not generate property updates on this property. However, when this property is retreived it returns the current datastore information.

defaultPowerOps

VirtualMachineDefaultPowerOpInfo

Configuration of default power operations.

extraConfig*

OptionValue[]

Additional configuration information for the virtual machine.

files

VirtualMachineFileInfo

Information about the files associated with a virtual machine. This information does not include files for specific virtual disks or snapshots.

flags

VirtualMachineFlagInfo

Additional flags for a virtual machine.

guestFullName

xsd:string

This is the full name of the guest operating system for the virtual machine. For example: Windows 2000 Professional.
See alternateGuestName

guestId

xsd:string

Guest operating system configured on a virtual machine. This is a guest identifier that can be used to access the GuestOsDescriptor list for information about default configuration. For more information on possible values, see VirtualMachineGuestOsIdentifier.

hardware

VirtualHardware

Processor, memory, and virtual devices for a virtual machine.

locationId*

xsd:string

Hash incorporating the virtual machine's config file location and the UUID of the host assigned to run the virtual machine.

memoryAffinity*

VirtualMachineAffinityInfo

Affinity settings for memory.

memoryAllocation*

ResourceAllocationInfo

Resource limits for memory.

modified

xsd:dateTime

Last time a virtual machine's configuration was modified.

name

xsd:string

Display name of the virtual machine.

Any / (slash), \ (backslash), character used in this name element is escaped. Similarly, any % (percent) character used in this name element is escaped, unless it is used to start an escape sequence. A slash is escaped as %2F or %2f. A backslash is escaped as %5C or %5c, and a percent is escaped as %25.

networkShaper*

VirtualMachineNetworkShaperInfo

Resource limits for network.

npivNodeWorldWideName*

xsd:long[]

A 64-bit node WWN (World Wide Name). These WWNs are paired with the npivPortWorldWideName to be used by the NPIV VPORTs instantiated for the virtual machine on the physical HBAs of the host. A pair of node and port WWNs serves as a unique identifier in accessing a LUN, so that it can be monitored or controlled by the storage administrator.

If this property contains a single node WWN, the same node WWN is used to pair with all port WWNs listed in npivPortWorldWideName. If this property or npivPortWorldWideName is empty or unset, NPIV WWN is disabled for the virtual machine.

Since VI API 2.5

npivPortWorldWideName*

xsd:long[]

A 64-bit port WWN (World Wide Name). For detail description on WWN, see npivNodeWorldWideName.

Since VI API 2.5

npivWorldWideNameType*

xsd:string

The source that provides/generates the assigned WWNs.
See VirtualMachineConfigInfoNpivWwnType

Since VI API 2.5

swapPlacement*

xsd:string

Virtual machine swapfile placement policy. This will be unset if the virtual machine's swapPlacementSupported capability is false. If swapPlacementSupported is true, the default policy is "inherit".
See VirtualMachineConfigInfoSwapPlacementType

Since VI API 2.5

template

xsd:boolean

Flag indicating whether or not a virtual machine is a template.

tools*

ToolsConfigInfo

Configuration of VMware Tools running in the guest operating system.

uuid

xsd:string

128-bit SMBIOS UUID of a virtual machine represented as a hexadecimal string in "12345678-abcd-1234-cdef-123456789abc" format.

version

xsd:string

The version string for this virtual machine.

Properties inherited from DynamicData

dynamicProperty, dynamicType

Need not be set

Show WSDL type definition

         <complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VirtualMachineConfigInfo">
            <complexContent>
               <extension base="vim25:DynamicData">
                  <sequence>
                     <element name="changeVersion" type="xsd:string"/>
                     <element name="modified" type="xsd:dateTime"/>
                     <element name="name" type="xsd:string"/>
                     <element name="guestFullName" type="xsd:string"/>
                     <element name="version" type="xsd:string"/>
                     <element name="uuid" type="xsd:string"/>
                     <element name="npivNodeWorldWideName" type="xsd:long" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="npivPortWorldWideName" type="xsd:long" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="npivWorldWideNameType" type="xsd:string" minOccurs="0"/>
                     <element name="locationId" type="xsd:string" minOccurs="0"/>
                     <element name="template" type="xsd:boolean"/>
                     <element name="guestId" type="xsd:string"/>
                     <element name="alternateGuestName" type="xsd:string"/>
                     <element name="annotation" type="xsd:string" minOccurs="0"/>
                     <element name="files" type="vim25:VirtualMachineFileInfo"/>
                     <element name="tools" type="vim25:ToolsConfigInfo" minOccurs="0"/>
                     <element name="flags" type="vim25:VirtualMachineFlagInfo"/>
                     <element name="consolePreferences" type="vim25:VirtualMachineConsolePreferences" minOccurs="0"/>
                     <element name="defaultPowerOps" type="vim25:VirtualMachineDefaultPowerOpInfo"/>
                     <element name="hardware" type="vim25:VirtualHardware"/>
                     <element name="cpuAllocation" type="vim25:ResourceAllocationInfo" minOccurs="0"/>
                     <element name="memoryAllocation" type="vim25:ResourceAllocationInfo" minOccurs="0"/>
                     <element name="cpuAffinity" type="vim25:VirtualMachineAffinityInfo" minOccurs="0"/>
                     <element name="memoryAffinity" type="vim25:VirtualMachineAffinityInfo" minOccurs="0"/>
                     <element name="networkShaper" type="vim25:VirtualMachineNetworkShaperInfo" minOccurs="0"/>
                     <element name="extraConfig" type="vim25:OptionValue" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="cpuFeatureMask" type="vim25:HostCpuIdInfo" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="datastoreUrl" type="vim25:VirtualMachineConfigInfoDatastoreUrlPair" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="swapPlacement" type="xsd:string" minOccurs="0"/>
                     <element name="bootOptions" type="vim25:VirtualMachineBootOptions" minOccurs="0"/>
                  </sequence>
               </extension>
            </complexContent>
         </complexType>

Data Object - VirtualMachineConfigInfo

Data Object Description