VDI client registry settings

Last Updated:

Registry keys can be used for troubleshooting or customizing the VDI setup you manage. If the registry key or subkey is not present, you can create it, and once created or edited, a quick restart of the Zoom client makes the change take effect. 

Using or editing registry keys for any purposes is not recommended for inexperienced users. For example, changing the LogLevel policy can generate a large amount of unnecessary log files.

All registry keys listed will work in the HKEY_LOCAL_MACHINE (HKLM) and HKEY_CURRENT_USER (HKCU) hives, except where otherwise noted. Zoom will check the current user directory, then check the local machine directory for the key. If the same key is set in both HKLM and HKCU hives, the value in the HKCU hive will take precedence. Keys only need to be configured on a virtual machine's registry table to take effect.

For additional configuration options, the VDI client also responds to MSI switches, which are documented here.

Available VDI registry values

Note: Most of the following values are located at SOFTWARE\Policies\Zoom\Zoom Meetings with the final folder specified below. Any policies located elsewhere have their full location provided.

VDI Registry Value Description Key Value type
Network and performance
UDPPortBegin,
UDPPortEnd
Specify port ranges when connecting with UDP. The range for ports are 1700 to 1800 or 64000 to 65000. The specified range cannot be less than 100.

If there are multiple users sharing the same VM machine, reserving 8 ports for each user is recommended.

Port range (7200-17210) is the default range for the Firewall inbound rules used by the Zoom VDI client on the VM side. Before testing UDPPortBegin-End, ensure the following policies are configured as such:
  • DisableUDPBridge is disabled (0)
  • DisableICABridge is enabled (1)
  • DisableMMRDirect is enabled (1)
  • A new Firewall inbound rule, such as Port range (17000-65000)
\VDI DWORD
DisableUDPBridge By default, there are no restrictions. Enabling this policy will prevent UDP connections.

 

If your thin client cannot connect to the Virtual Desktop VM by UDP, enabling this policy prevents any UDP connection between VM and thin client, which may in turn speed up the process of joining a meeting.

Note: If this is configured on the thin client, those settings will override the settings on the VM.

\VDI DWORD
DisableICABridge

By default, there are no restrictions. Enabling this policy will prevent ICA connections.

If the MMR is inaccessible for the thin client, the UDP connection from the thin client to the VM is not available, and this policy is enabled, the client will display the "Zoom Plugin can not connect to the server according to your Zoom config and network status" message and attempts to join or start meetings will fail.

Note: If this is configured on the thin client those settings will override the settings on the VM.

\VDI DWORD
DisableMMRDirect By default, there are no restrictions. Enabling this will prevent direct MMR connections.

If your firewall has blocked the zoom connection process to Zoom MMRs on thin clients, enabling this policy may speed up the process of joining a meeting.

Note: If this is configured on the thin client those settings will override the settings on the VM.

\VDI DWORD
DisableMMRDirect_Phone

By default, there are no restrictions. Enabling this policy will prevent connections between the thin client and Zoom Phone servers.

If your network firewall prevents the Zoom process from connecting to the Zoom Phone Server on the thin client, enabling this policy may speed up the process of connecting to Zoom Phone calls. If this is configured on the thin client, those settings will override the settings on the virtual desktop. 

\VDI DWORD
DisableUDPBridge_Phone

By default, there are no restrictions. Enabling this policy will prevent sending Zoom Phone audio over a UDP connection from the thin client to the virtual desktop

If your thin client cannot connect to the virtual desktop over UDP, enabling this policy may speed up the process of making a call. If this is configured on the thin client, the settings will override settings on the virtual desktop. 

\VDI DWORD
DisableChannelBridge_Phone

By default, there are no restrictions. Enabling this policy will Prevent sending Zoom Phone audio over a channel connection, such as the ICA protocol connection channel.

If your configuration is expected to use Direct or UDP, enabling this policy will prevent Zoom Phone from sending Zoom Phone audio over another protocol channel. 

\VDI DWORD
PingServerFromThinClient Choose how Zoom servers are pinged:
(0) from the VDI virtual machine
(1) from the thin client

When this policy is enabled, determining which Zoom server to connect to for meetings is based on the location of the thin client where the VDI plugin is located. If your thin clients are located in a different geographical location than your virtual desktops, enabling this configuration can reduce join time and latency, as a more local server connection may be chosen instead.

\VDI DWORD
PingServerFromThinClientOffloadConfRequest

By default, the VDI virtual machine uses the plugin’s public IP address to determine and connect to the most suitable Zoom Servers. This requires the PingServerFromThinClient policy to be set to 1.

This requires VDI version 5.14.10 or higher.

(0) - Ping from VDI VM and use the plugin’s public IP address to select the most suitable Zoom Zone Center (Default)
(1) - Ping from thin client.

\VDI DWORD
DisableDirectConnectionPK Only impacts login/join meeting related requests. \Meetings DWORD
DisableDirectConnection2Web Disable all direct connections to Zoom web service. This impacts all web services related to REST API. SOFTWARE\WOW6432Node
\Zoom VDI\PerInstall
String Value (REG_SZ)
AllowPluginDSCPMarking This policy controls if the plugin can apply DSCP tagging for audio and video traffic. Disabled by default (even if enabled in web settings). Enabling this policy will allow the plugin to include DSCP marking network traffic.

Note: DSCP marking must be enabled in the Zoom web portal for this to function on the plugin side.

\VDI DWORD
DSCPValueForAudio,
DSCPValueForVideo

Applies DSCP tagging for audio and video traffic using the specified values. If using any values besides the default (40 for video, 56 for audio), DSCP tagging requires admin privileges and the EnableIndependentDataPort policy is enabled.

Both values must be set for DSCP tagging to be applied and must be between 1 and 63. Otherwise, the value from the Zoom web portal (account settings) is used. These policies override the account settings if set, and don't require the user to be logged in to an account.

\VDI DWORD
FallbackMode Specify the fallback mode behavior from the following presets:
(1) (Default) Normal mode (Behaves like the regular Zoom client) (Unoptimized Audio and Video is sent from thin client to virtual desktop using desktop protocol)
(2) Runs as a screen-share meeting (Audio and video are muted by default)
(3) A notification is displayed saying unable to meet and join
(4) A notification will display an error message, and when the user closes the prompt, the Zoom app will also be closed.
(5) Only video is disabled.
(6) Video and sharing are disabled.
(7) Video and computer audio are disabled.
\VDI DWORD
ServiceUnavailableTipMsg Display an admin-provided message when the client is in fallback mode 3 or 4. If this policy is not included or undefined, a default message is displayed. The message cannot be longer than 1024 characters.

Note: If a line return is required, "\n" should be used to add the line return.

\VDI String Value (REG_SZ)
FallbackModeTipMsg Display an admin-provided message when the VDI plugin is not usable and fallback mode is set to 1, 2, 5, 6, or 7. If this policy is not included or undefined, no message is displayed. The message cannot be longer than 1024 characters.

Note: If a line return is required, "\n" should be used to add the line return.

\VDI String Value (REG_SZ)
DisableBoostPowerScheme

By default, the VDI client will force the thin client power settings to high-performance mode. Enabling this policy prevents high-performance mode from being automatically enabled.

This policy only affects thin clients with a 2-core CPU or less.

\VDI DWORD

PhoneCallTipMsg

This policy disables the audio quality popup message. This requires Zoom VDI client version 5.15.2 or higher

(0) - (Default) "Poor network connection. Audio quality may be affected" notifications during phone calls will be displayed as needed. 
(1) - "Poor network connection. Audio quality may be affected" notifications during phone calls will be disabled. 

\VDI DWORD

DisableAWSPlatform

This policy disables connection attempts from the VDI meeting client to the VDI plugin for AWS WorkSpaces. 

(0) - (Default) Connections to AWS WorkSpaces platform are enabled. 

(1) - Connections to AWS WorkSpaces platform are disabled. 

\VDI DWORD
Install and update
EnableDifferentVersionTip By default, no warning message is displayed when there is a version mismatch between the VDI client and VDI plugin. Enabling the policy displays the warning. \VDI DWORD
MinPluginVersion Set the minimum version to match your existing thin client plugin deployment. \VDI String Value (REG_SZ)
EnableVDIPluginAutoUpgrade

Disabled by default, enabling the policy enables the VDI plugin auto-update to install or upgrade VDI plugins if the VDI auto-update component has been installed on the thin client. This feature is currently only supported for Windows devices.

Adding this policy to the Windows Thin Client can be used to disable the auto-update feature for a specific device. For example, adding the policy to managed devices to disable updates internally, while disabling auto-update to update users' personal devices at home.

  • This requires Zoom VDI client version 5.10.0 or higher.
  • VDI Plugin Management software on client
    • Zoom VDI Plugin for Windows version 5.9.6 or higher
    • Zoom VDI Plugin for macOS version 5.12.6 or higher
\VDI DWORD
AutoUpdatePluginVersion

This policy specifies the Auto-update plugin version and will give priority to the specified version. If the specified version is not supported, the web server configuration will be used.

The plugin version must fall within a range of acceptable values that apply to each version of the host client. Values that are out of range will be ignored, and a value best suited for the host value will be used instead.

Note: A complete list of supported versions is available in the VDI plugin and Auto-Update plugin versions article/

  • This requires Zoom VDI client version 5.9.6 or higher
  • VDI Plugin Management software on client
    • Zoom VDI Plugin for Windows version 5.9.6 or higher
    • Zoom VDI Plugin for macOS version 5.12.6 or higher
\VDI String Value (REG_SZ)
UpdatePluginLater By default, the update prompt does not include a Later option. Enabling this policy modifies the prompt to include the Later option.

(0) Default (plugin auto-update later option is disabled)
(1) Include the Later option, which closes the dialog. The next time the user connects, the same dialog will be presented if the VDI plugin management software detects an action is still required. This policy requires Zoom VDI client version 5.11.6 or higher.
(2) Include the Later option, which waits until the user disconnects from their virtual desktop(s) and then performs the update. This policy requires the Zoom VDI client version version 5.13.0 or higher.

\VDI DWORD
Logging, data storage, and data processing
AllowEnableLog By default, the VDI Log Tool requires Admin privileges to enable logging and set the log level. This policy can be added to allow any user of the virtual desktop to use the VDI Log Tool to configure and collect logs. \VDI DWORD
LogLevel Specify which logs are provided to Zoom:
(0) No log output
(1) Only output error logs
(2) Only output warning logs
(3) Only output info logs
(4) All output logs

Note: If set to generate no logs (0), there may still be some null log files generated. The log of the initialization process of the VDI plugin will always be generated.

\VDI DWORD
DisableVDIToolFileTransfer By default, the Zoom VDI log tool is unrestricted from retrieving log files from the remote client. When enabled, log file transfers from Plugin to VM are disabled when using the VDI log tool.

This requires VDI version 5.9.6 or higher.

\VDI DWORD
MaxLogFileSize Set the maximum file size each log file can be. The value is set as a numerical value representing how many MBs a log file size can be, ranging from 1 to 100 MBs.

Note: Available only on the Windows thin client.

\VDI DWORD
MaxLogFileCount Set the maximum number of log files to be stored locally. The value is set as a numerical value representing how many log files are allowed, ranging from 8 to 50.

Note: Available only on the Windows thin client.

\VDI DWORD
UniqueDataDir By default, user data is stored in the main data folder, located at %appdata%\zoomvdi\data. Enabling this setting, creates unique data folders for each user profile on that device.

Using the string "YES", will enable a unique folder within the path %appdata%\zoomvdi\data

SOFTWARE\WOW6432Node
\Zoom VDI\PerInstall
String Value (REG_SZ)
Audio and video
DisableSyncDesktopVolumeToTerminal This policy will sync changes made for the Virtual Desktop volume slider in the OS taskbar to the Thin Client device, if the VDI speaker output selection is configured as Same as system. This policy requires VDI version 5.14.10 or higher.

Note: Changing the volume on the Thin Client directly will not sync to the Virtual Desktop and change the volume slider in the taskbar.

(0) - Sync volume changes made to the Virtual Desktop volume slider in the OS taskbar to the Thin Client device.
(1) - Volume changes are not synced (Default)

\VDI DWORD
AudioAECLevel By default, standard echo cancellation is used. Advanced echo cancellation offers higher-quality audio, but requires more CPU usage on the thin client.

(1) Standard
(2) Advanced

\VDI DWORD
CheckHdxMediaOptimization

This policy determines if Zoom takes control of connected HID devices.

By default, the VDI client will check if Skype for Business or Teams are running (based on if lync.exe process is running), and, if either are active, the client will not force HID redirection. If enabled, the client will take control of HID devices. This policy requires Zoom VDI client version 5.10.6 or higher.

\VDI DWORD
HideAdvancedSettings By default, the advanced settings under Audio and Video in the Settings panel can be accessed by users. Enabling this will hide those Advanced settings. \Meetings DWORD
DoTComplianceMode By default, this mode is disabled and meetings will appear and operate as normal. Setting the following values have the associated in-meeting impact.
  • (1) Video is required to be on during the entire meeting and the user cannot disable it. Audio can still be muted/unmuted as needed.
  • (2) Video and computer audio are disabled, and only connecting to audio through phone dial-in or call-me is allowed. For a PMI meeting, the host still needs to check the telephone and computer audio settings before starting. The VDI client will enable computer audio if the host has enabled it on the PMI.

     

Note: This key must be used in the HKLM hive.

\Meetings DWORD
DisableWallView7x7 By default, Gallery view can display up to 49 video participants, if hardware and version (5.9.6 or higher) requirements are met. Enabling this policy limits gallery view to a maximum of 25 video participants. \VDI DWORD
ForceWallView3x3 By default, Gallery view can display up to 25 video participants, if HD video is enabled. Enabling this policy limits gallery view to a maximum of 9 video participants. \VDI DWORD
DisableScreenshotOptimization

(Beta) This policy can be used to offload screen capture commands to the plugin side, where the screenshot can capture video received by the VDI plugin. This requires VDI version 5.14.10 or higher.

Currently, the default is disabled (1), but may be changed in a future release.

\VDI DWORD
Sharing
EnableShareAudioSound By default, the Share Sound option is disabled and hidden. Enabling this policy provides users with this option when starting a share and during a live share. \VDI DWORD
EnableOptimizeForVideo By default, the Optimize for video clip option is disabled and hidden. Enabling this policy provides users with this option when starting a share and during a live share. \VDI DWORD
ShareSubscribeFps Define the maximum frame-rate when viewing shared content. Values can range from 1 to 5. \VDI DWORD
ShareCaptureFps Define the maximum frame-rate when capturing and sharing content. Values can range from 1 to 5. \VDI DWORD
DisableShareOffload By default, processing of incoming shared content is offloaded to the local device. Enable this policy to disable offloading.

(0) VDI view share offloads processing.
(1) VDI view share does not offload processing.

Note: When Share Offload is disabled, the share window is rendered locally on the virtual desktop. This will increase the updates to the share session when moving the share window, but will also use more processing on the virtual desktop to display the share session video.

\VDI DWORD
EnableWMIProvider This policy controls the use of the WMI provider for the VDI client, allowing admins to gather information about the VDI plugins.

(0) Disable the WMI provider.
(1) Enable the use of the WMI provider.

\VDI DWORD

Zoom Community

Join the 250K+ other members in the Zoom Community! Login with your Zoom account credentials and start collaborating.