DesktopPoolDisplayProtocolSettings

DesktopPoolDisplayProtocolSettings
DesktopPoolDisplayProtocolSettings

Settings for the networking protocol to display the remote machine.

JSON Example
{
    "allow_users_to_choose_protocol": true,
    "default_display_protocol": "PCOIP",
    "display_protocols": [
        "PCOIP",
        "BLAST",
        "RDP"
    ],
    "grid_vgpus_enabled": false,
    "html_access_enabled": true,
    "max_number_of_monitors": 2,
    "max_resolution_of_any_one_monitor": "WUXGA",
    "renderer3d": "true",
    "session_collaboration_enabled": false,
    "vgpu_grid_profile": "instant-profile",
    "vram_size_mb": 64
}
boolean
allow_users_to_choose_protocol
Optional

Indicates whether the users can choose the protocol. Default value is true. This property can be used for sorting.

string
default_display_protocol
Optional

The default display protocol for the desktop pool. For a managed desktop pool, this will default to PCOIP.For an unmanaged desktop pool, this will default to RDP. This property can be used for sorting.

  • BLAST: BLAST protocol.
  • PCOIP: PCoIP protocol.
  • RDP: Microsoft Remote Desktop Protocol.
Possible values are : BLAST, PCOIP, RDP,
array of string
display_protocols
Optional

List of supported display protocols for this desktop pool.Default value is [PCOIP, RDP, BLAST].

Possible values are : BLAST, PCOIP, RDP,
boolean
grid_vgpus_enabled
Optional

When 3D rendering is managed by the vSphere Client, this enables support for NVIDIA GRID vGPUs.This will be false if 3D rendering is not managed by the vSphere Client. If this is true,the host or cluster associated with the desktop pool must support NVIDIA GRID and vGPU types required by the desktop pool's VirtualMachines,VmTemplate, or BaseImageSnapshot. If this is false, the desktop pool's VirtualMachines, VmTemplate, orBaseImageSnapshot must not support NVIDIA GRID vGPUs. Since suspending VMs with passthroughdevices such as vGPUs is not possible, power_policy cannot be set to SUSPEND if this is enabled.Default value is false. This property can be used for sorting.

boolean
html_access_enabled
Optional

This property is no longer in use for Horizon Components. It is always set to true. HTML Access, enabled by VMware Blast technology, allows users to connect to machines from Web browsers. Horizon Client software does not have to be installed on the client devices. To enable HTML Access, you must install the HTML Machine Access feature pack. Also, Blast must be configured as a supported protocol in displayProtocols. This property can be used for sorting.

integer As int32 As int32
max_number_of_monitors
Optional

When 3D is disabled, the 'Max number of monitors' and 'Max resolution of any one monitor' settings determine the amount ofvRAM assigned to machines in this desktop. The greater these values are, the more memory will be consumeon the associated ESX hosts. Existing virtual machines must be powered off and subsequently powered onfor the change to take effect. A restart will not cause the changes to take effect. If 3D is enabled and managedby View, the maximum number of monitors must be 1 or 2. For Instant Clones, this value is inherited from snapshot of Master VM. This property can be used for sorting.

string
max_resolution_of_any_one_monitor
Optional

If 3D rendering is enabled and managed by View, this must be set to the default value. When 3D rendering is disabled,the 'Max number of monitors' and 'Max resolution of any one monitor' settings determine the amount of vRAM assignedto machines in this desktop. The greater these values are, the more memory will be consumed on the associated ESX hosts.This setting is only relevant on managed machines. Existing virtual machines must be powered off and subsequently poweredon for the change to take effect. A restart will not cause the changes to take effect. For Instant Clones,this value is inherited from snapshot of Master VM. This property has a default value of WUXGA. This property can be used for sorting.

  • UHD: 3840x2160 resolution.
  • UHD_5K: 5120x2880 resolution.
  • UHD_8K: 7680x4320 resolution.
  • WQXGA: 2560x1600 resolution.
  • WSXGA_PLUS: 1680x1050 resolution.
  • WUXGA: 1920x1200 resolution.
Possible values are : UHD, UHD_5K, UHD_8K, WQXGA, WSXGA_PLUS, WUXGA,
string
renderer3d
Optional

3D rendering is supported on Windows 7 or later guests running on VMs with virtual hardware version8 or later. The default protocol must be PCoIP and users must not be allowed to choose their ownprotocol to enable 3D rendering. For instant clone source desktop 3D rendering always mapped to MANAGE_BY_VSPHERE_CLIENT.Default value is DISABLED. This property can be used for sorting.

  • AUTOMATIC: 3D rendering is automatic.
  • DISABLED: 3D rendering is disabled.
  • HARDWARE: 3D rendering is hardware dependent. The hardware-based renderer is supported (at minimum) on virtual hardware version 9 in a vSphere 5.1 environment.
  • MANAGE_BY_VSPHERE_CLIENT: 3D rendering managed by vSphere Client.
  • SOFTWARE: 3D rendering is software dependent. The software renderer is supported (at minimum) on virtual hardware version 8 in a vSphere 5.0 environment.
Possible values are : AUTOMATIC, DISABLED, HARDWARE, MANAGE_BY_VSPHERE_CLIENT, SOFTWARE,
boolean
session_collaboration_enabled
Optional

Enable session collaboration feature. Session collaborationallows a user to share their remote session with other users.BLAST must be configured as a supported protocol in supported_display_protocols.Default value is false. This property can be used for sorting.

string
vgpu_grid_profile
Optional

NVIDIA GRID vGPUs might have multiple profiles and any one of the available profiles can beapplied to newly created instant clone desktop. The profile specified in this field will beused in the newly created instant clone desktop. Will be set if enable_grid_vgpus set to true. This property can be used for sorting.

integer As int32 As int32
vram_size_mb
Optional

vRAM size for View managed 3D rendering. More VRAM can improve 3D performance.Size is in MB. On ESXi 5.0 hosts, the renderer allows a maximum VRAM size of 128MB. On ESXi 5.1and later hosts, the maximum VRAM size is 512MB. For Instant Clones, this value is inherited from snapshot of Master VM.This property is applicable when 3D renderer is not disabled. This has a default value of 96. This property can be used for sorting.