Data Object - GuestInfo

Property of
VirtualMachine
Extends
DynamicData
See also
GuestDiskInfo, GuestInfoNamespaceGenerationInfo, GuestNicInfo, GuestScreenInfo, GuestStackInfo, VirtualMachineToolsStatus

Data Object Description

Information about the guest operating system.

Most of this information is collected by VMware Tools. In general, be sure you have VMware Tools installed and that the virtual machine is running when you access this information.

Properties

Name Type Description
appHeartbeatStatus*xsd:string

Application heartbeat status. Please see VirtualMachineAppHeartbeatStatusType

Since vSphere API 4.1
disk*GuestDiskInfo[]

Guest information about disks, if known.
generationInfo* PGuestInfoNamespaceGenerationInfo[]

A list of namespaces and their corresponding generation numbers. Only namespaces with non-zero maxSizeEventsFromGuest are guaranteed to be present here. Use ListNamespaces to retrieve list of namespaces.

Since vSphere API 5.1
guestFamily*xsd:string

Guest operating system family, if known.
guestFullName*xsd:string

Guest operating system full name, if known.
guestId*xsd:string

Guest operating system identifier (short name), if known.
guestOperationsReady*xsd:boolean

Guest Operations availability. If true, the vitrual machine is ready to process guest operations.

Since vSphere API 5.0
guestStatexsd:string

Operation mode of guest operating system. One of:
  • "running" - Guest is running normally.
  • "shuttingdown" - Guest has a pending shutdown command.
  • "resetting" - Guest has a pending reset command.
  • "standby" - Guest has a pending standby command.
  • "notrunning" - Guest is not running.
  • "unknown" - Guest information is not available.

hostName*xsd:string

Hostname of the guest operating system, if known.
interactiveGuestOperationsReady*xsd:boolean

Interactive Guest Operations availability. If true, the vitrual machine is ready to process guest operations as the user interacting with the guest desktop.

Since vSphere API 5.0
ipAddress*xsd:string

Primary IP address assigned to the guest operating system, if known.
ipStack*GuestStackInfo[]

Guest information about IP networking stack, if known.

Since vSphere API 4.1
net*GuestNicInfo[]

Guest information about network adapters, if known.
screen*GuestScreenInfo

Guest screen resolution info, if known.
toolsRunningStatus*xsd:string

Current running status of VMware Tools in the guest operating system, if known. The set of possible values is described in VirtualMachineToolsRunningStatus

Since vSphere API 4.0
toolsStatus*VirtualMachineToolsStatusDeprecated. As of vSphere API 4.0 use toolsVersionStatus and toolsRunningStatus.

Current status of VMware Tools in the guest operating system, if known.
toolsVersion*xsd:string

Current version of VMware Tools, if known.
toolsVersionStatus*xsd:stringDeprecated. as of vSphere API 5.1 use toolsVersionStatus2.

Current version status of VMware Tools in the guest operating system, if known. The set of possible values is described in VirtualMachineToolsVersionStatus for vSphere API 5.0.

Since vSphere API 4.0
toolsVersionStatus2*xsd:string

Current version status of VMware Tools in the guest operating system, if known. The set of possible values is described in VirtualMachineToolsVersionStatus

Since vSphere API 5.0
Properties inherited from DynamicData
dynamicProperty, dynamicType
*Need not be setP Required privilege: VirtualMachine.Namespace.EventNotify
Show WSDL type definition