VmToolsInfo

The Tools.Info structure describes the VMWare Tools properties of a virtual machine.


Properties

boolean
auto_update_supported Required

Set if the virtual machine supports auto-upgrading Tools via Tools.UpgradePolicy.


object
error Optional

Error that happened, if any, during last attempt to upgrade or install Tools. Only set if a the last Tools install or upgrade attempt failed.


integer
install_attempt_count Optional

Number of attempts that have been made to install or upgrade the version of Tools installed on this virtual machine. Only set if there was a recent Tools install or upgrade attempt.


install_type Optional

Current installation type of VMware Tools in the guest operating system. Only set if Tools install type is known.


run_state Required

Current run state of VMware Tools in the guest operating system.


upgrade_policy Required

Tools upgrade policy setting for the virtual machine. Tools.UpgradePolicy


string
version Optional

Version of VMware Tools installed on the guest operating system. This is a human-readable value that should not be parsed. Only set if Tools is installed.


integer
version_number Optional

Version of VMware Tools installed on the guest operating system. Only set if Tools is installed. This is an integer constructed as follows: (((MJR) << 10) + ((MNR) << 5) + (REV)) Where MJR is tha major verson, MNR is the minor version and REV is the revision. Tools version = T Tools Version Major = MJR = (T / 1024) Tools Version Minor = MNR = ((T % 1024) / 32) Tools Version Revision = BASE = ((T % 1024) % 32) Tools actual version = MJR.MNR.REV


version_status Optional

Current version status of VMware Tools in the guest operating system, if known. Only set if Tools version status is known.

JSON Example

{
    "auto_update_supported": false,
    "run_state": "enum",
    "upgrade_policy": "enum"
}
Feedback

Was this page helpful?