HeldVMInfo
HeldVMInfo
Information related to a held Virtual Machine.
JSON Example
{
"machine_id": "vm-416",
"machine_state": "Connected",
"name": "Win10"
}
string
machine_id
Optional
Unique virtual center moid representing the virtual machine.
string
machine_state
Optional
Machine state
- AGENT_CONFIG_ERROR: The Remote Desktop Services role is not enabled on the windows server.
- AGENT_DRAIN_MODE: RDS host is configured for drain mode. New connections are currently disabled.
- AGENT_DRAIN_UNTIL_RESTART: RDS host is configured for drain-until-restart mode.
- AGENT_ERROR_DISABLED: Horizon Agent is disabled.
- AGENT_ERROR_INVALID_IP: Horizon Agent has an invalid IP address.
- AGENT_ERROR_NEEDS_REBOOT: Horizon Agent needs reboot.
- AGENT_ERROR_PROTOCOL_FAILURE: Protocol such as BLAST, RDP or PCoIP is not enabled.
- AGENT_ERROR_STARTUP_IN_PROGRESS: Horizon Agent has started on the machine, but other required services such as the display protocol are still starting.
- AGENT_ERROR_DOMAIN_FAILURE: The Remote Desktop Services domain failure.
- AGENT_UNREACHABLE: Horizon Connection Server cannot establish communication with Horizon Agent on the machine.
- ALREADY_USED: The machine is configured to have only one session which is currently in progress and cannot accept new sessions.
- AVAILABLE: The machine is powered on and ready for active connections.
- BLOCKED_AGENT_VERSION: The Horizon Agent version is blocked from establishing sessions.
- CONNECTED: The machine is in an active session and has an active connection to a Horizon client.
- CUSTOMIZING: The machine which is from an automated desktop pool is being customized after provisioning.
- DELETING: The machine is marked for deletion.
- DISABLED: The machine is disabled.
- DISABLE_IN_PROGRESS: Disabled Horizon Connection Server still has some Horizon brokered sessions. It can still accept re-connections.
- DISCONNECTED: The machine is in an active session, but it is disconnected from the Horizon client.
- ERROR: An unknown error occurred in the machine.
- IN_PROGRESS: There is a machine operation in progress.
- MAINTENANCE: The machine is in maintenance mode. Users cannot log in or use the machine.
- PROVISIONED: The machine is powered off or suspended.
- PROVISIONING: The machine is being provisioned.
- PROVISIONING_ERROR: An error occurred during provisioning.
- UNASSIGNED_USER_CONNECTED: A user other than the assigned user is logged in to the machine in a dedicated desktop pool.
- UNASSIGNED_USER_DISCONNECTED: A user other than the assigned user is logged in and disconnected from the machine in a dedicated desktop pool.
- UNKNOWN: Could not determine the state of the machine.
- VALIDATING: The Horizon Connection Server is synchronizing state information with the agent.
- WAITING_FOR_AGENT: Horizon Connection Server is waiting to establish communication with Horizon Agent for one of these cases - a virtual machine in a manual desktop pool, unmanaged machine or RDS server.
Possible values are : AGENT_CONFIG_ERROR, AGENT_DRAIN_MODE, AGENT_DRAIN_UNTIL_RESTART, AGENT_ERROR_DISABLED, AGENT_ERROR_INVALID_IP, AGENT_ERROR_NEEDS_REBOOT, AGENT_ERROR_PROTOCOL_FAILURE, AGENT_ERROR_STARTUP_IN_PROGRESS, AGENT_ERROR_DOMAIN_FAILURE, AGENT_UNREACHABLE, ALREADY_USED, AVAILABLE, BLOCKED_AGENT_VERSION, CONNECTED, CUSTOMIZING, DELETING, DISABLED, DISABLE_IN_PROGRESS, DISCONNECTED, ERROR, IN_PROGRESS, MAINTENANCE, PROVISIONED, PROVISIONING, PROVISIONING_ERROR, UNASSIGNED_USER_CONNECTED, UNASSIGNED_USER_DISCONNECTED, UNKNOWN, VALIDATING, WAITING_FOR_AGENT,
string
name
Optional
VM name.