VDI client registry settings
Last Updated:
Registry keys can be used for troubleshooting or customing your VDI setup. If the registry key or sub key is not present, you can create it. Once you have created or edited a registry key, restart the Zoom client for the change to take effect. Using registry keys for non-troubleshooting purposes is not recommended. Changing the LogLevel value, in particular, can generate a large amount of unnecessary 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 the HKLM and HKCU hives, the value in the HKCU hive will be used. Keys only need to be configured on a virtual machine's registry table to take effect.
For additional configuration, the VDI client also responds to MSI switches.
Registry Keys
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: ShareSubscribeFps
Value Type: DWORD
Value Description: This is a user-defined subscribing sharing frame rate. It can be 1 or 5.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: ShareCaptureFps
Value Type: DWORD
Value Description: This is a user-defined screen capture frame rate. The value can be any number from 1 to 5.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: UDPPortBegin, UDPPortEnd
Value Type: DWORD
Value Description: Admin-specified port range when connecting with UDP. The range for begin port is (1700, 64000). The range for end port is (1800, 65000). Also, note the begin-end range cannot be less than 100.
Additional Notes:
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, you will need to set the following:
DisableUDPBridge=0; DisableICABridge=1;DisableMMRDirect=1 and configure a new Firewall inbound rule, like Port range (17000-65000)
Additionally, be aware that if there are multiple users that share the same VM machine, reserving 8 ports for each user is recommended.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableBoostPowerScheme
Value Type: DWORD
Value Description: Specify a value of one (1) to disable. Specify a value of zero (0) or not available to enable. This setting only applies to thin clients with 2 core CPU or less. By default, the VDI Client will force the thin client power settings to high-performance mode if this setting is not set or set to 0.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: FallbackMode
Value Type: DWORD
Value Description: Each number corresponds to a specific mode:
(1) Normal mode (Behaves like the regular zoom client)
(2) Runs as a screen share meeting (Audio and video are muted by default)
(3) A pop-up appears that will say unable to meet and join
(4) A dialogue prompt will display an error message. When the user closes the prompt the Zoom app will also be closed.
(5) Video is disabled.
(6) Video and sharing are disabled.
(7) Video and computer audio are disabled
Comments: If the registry settings are not configured, the default mode is one (1).
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: LogLevel
Value Type: DWORD
Value Description: The following values determine the log output:
(0) no log output
(1) output error log
(2) output warning log
(3) output info log
(4) output all logs
Comments: If set to zero (0), there may be some null log files generated.
The log of the init procedure of the VDI plugin will always be generated.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: AllowEnableLog
Value Type: DWORD
Value Description:
(0) users cannot enable logging
(1) users can enable logging
Comments: Users can enable logging from HKCU\Software\Zoom\VDI\Config by adding LogLevel. Admins can also use MaxLogFileSize and MaxLogCount at this location if AllowEnableLog is set to 1.
Note: This registry policy can be used to enable logging for desktops where user accounts do not have the admin privileges to enable logging using the VDI Log Tool. Please refer to How to use the VDI Log Tool for more information.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: LogReserveHours
Value Type: DWORD
Value Description: The duration (in hours) logs are kept. Set as a numerical value.
Comments: If set to 0 or not set, then there is no limitation.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: LogReserveSize
Value Type: DWORD
Value Description: The total size of log files (in MB) to keep. Set as a numerical value.
Comments: If set to 0 or not set, then there is no limitation.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: MaxLogFileSize
Value Type: DWORD
Value Description: Value from 1 to 100 in MBs.
Comments: Applicable to Windows thin client.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: MaxLogFileCount
Value Type: DWORD
Value Description: Value between 8-50.
Comments: Applicable to Windows thin client.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableUDPBridge
Value Type: DWORD
Value Description:
(0) no restrictions
(1) Cannot transfer data stream on UDP connection between VM and thin client
Comments: If your thin client cannot connect to the Virtual Desktop VM by UDP, setting this to 1 may speed up the process of joining a meeting. If this is configured on the thin client, those settings will override the settings on the VM.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableICABridge
Value Type: DWORD
Value Description:
(0) no restrictions
(1) Cannot transfer data stream on an ICA connection.
Comments: If the MMR is inaccessible for the thin client, and the UDP connection from the thin client to the VM is not available, you will see the message "Zoom Plugin can not connect to the server according to your Zoom config and network status" and attempts to join or start meetings will fail when you set this value to 1. If this is configured on the thin client those settings will override the settings on the VM.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableMMRDirect
Value Type: DWORD
Value Description:
(0) no restrictions
(1) Cannot connect to an MMR on the thin client.
Comments: If your network firewall has disabled the zoom connection process to Zoom MMRs on thin clients, setting this configuration to 1 may speed up the procedure of joining a meeting. If this is configured on the thin client those settings will override the settings on the VM.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: AudioAECLevel
Value Type: DWORD
Value Description:
(1) Simple AEC
(2) Advanced AEC
Comments: The default value is 1. Advanced AEC offers higher-quality audio than Simple AEC, but it will use more CPU power on the thin client.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: SortBuddyMaxCount
Value Type: DWORD
Value Description:
(0) Company buddies will be sorted.
(x) Company buddies will be sorted if the number is less than or equal to the value set.
Comments:
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: PingServerFromThinClient
Value Type: DWORD
Value Description:
(0) Ping from the VDI VM.
(1) Ping from the thin client.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: EnableDifferentVersionTip
Value Type: DWORD
Value Description: This enables or disables an error message display when the VDI client and VDI plugin versions do not match. A zero will display no warning message when there is a version mismatch, whereas any other value will display one.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: ServiceUnavailableTipMsg
Value Type: String Value (REG_SZ)
Value Description: Displays an administrator-defined message when the meeting cannot be started because the client is running fallback mode 3 or 4. When this entry does not exist (or the string value is empty), a default message will be displayed. When the string value is not empty, it will show the provided error message for either error condition.
Comments: The registry table string type does not support line return. If a line return is required, "\n" should be used to add the line return. The length of the content string cannot be greater than 1024 characters.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: MinPluginVersion
Value Type: String Value (REG_SZ)
Value Description: 2.1.5 ~ current
Comments: Configure the version to match your existing thin client plugin deployment. Note that the default version for this setting is 2.1.5.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: FallbackModeTipMsg
Value Type: String Value (REG_SZ)
Value Description: Displays a user-defined message when the VDI plugin is not usable and fallback mode is set to 1, 2, 5, 6, or 7. When this registry key does not exist or the string value is empty, no dialog message will be shown.
Comments: The registry table string type does not support line return. If a user wants a line return, "\n" should be used to indicate a line return. The length of the content string should be no more than 1024 characters; otherwise, the VDI Client may fail to read the setting.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableWallView7x7
Value Type: DWORD
Value Description:
(0) Use new logic and offer 7x7 option if hardware requirements are met (release 5.9.6 and greater)
(1) Revert to old logic and only display 5x5
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: ForceWallView3x3
Value Type: DWORD
Value Description:
(0) This is the default value. Use 720HD to determine if 5x5 should be used.
(1) Forces the use of 3x3.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\Meetings
Value: DoTComplianceMode
Value Type: DWORD
Value Description:
(0) default, no effect
(1) Video will be forced on during the entire meeting and the user will not be able to disable it. The user can toggle audio off or on.
(2) Video and computer audio are disabled. Only phone dial in or out 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.
Comments: This key must be used in the HKLM hive.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\Meetings
Value: HideAdvancedSettings
Value Type: DWORD
Value Description:
(0) This is the default value. Advanced settings will be displayed.
(1) The advanced settings will be hidden.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\Meetings
Value: AlwaysShowVideoPreviewDialog
Value Type: DWORD
Value Description: 1
Comments: Before joining a meeting with video, users will be shown their video preview and given the option to join with or without video. This key must be used in the HKLM hive.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\Meetings
Value: DisableDirectConnectionPK
Value Type: DWORD
Value Description:
Comments: Only impacts login/join meeting related requests.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: AllowPluginDSCPMarking
Value Type: DWORD
Value Description:
(0) DSCP Marking is absent from plugin traffic (even if it is enabled on the account).
(1) Add DSCP Marking to the plugin traffic.
Comments: DSCP marking must be enabled in the Zoom web portal for this to work on the plugin side.
Key: SOFTWARE\WOW6432Node\Zoom VDI\PerInstall
Value: uniquedatadir
Value Type: String Value (REG_SZ)
Value Description: Using the string "YES", will enable a unique folder within the path %appdata%\zoomvdi\data
Comments: Configure this setting, to enable a unique data folder specific to the user profile for that device.
Key: SOFTWARE\WOW6432Node\Zoom VDI\PerInstall
Value: DisableDirectConnection2Web
Value Type: String Value (REG_SZ)
Value Description:
Comments: Impacts all web services related to REST API.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableShareOffload
Value Type: DWORD
Value Description:
(0) VDI view share offloads.
(1) VDI view share does not offload.
Comments: The default value is 0. Value 1 uses a simple judgment method. When viewing a share, move the window quickly, and there will be no delay in the share window.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: EnableShareAudioSound
Value Type: DWORD
Value Description:
(0) "share sound" option will be hidden.
(1) "share sound" option will be visible.
Comments: The default value is 0.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: EnableOptimizeForVideo
Value Type: DWORD
Value Description:
(0) "optimize for video clip" option will be hidden.
(1) "optimize for video clip" option will be visible.
Comments: The default value is 0.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: EnableWMIProvider
Value Type: DWORD
Value Description: Specify a value of one (1) to enable the in-process WMI provider for the VDI client. Specify a value of zero (0) or not available to disable the provider.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DSCPValueForAudio, DSCPValueForVideo
Value Type: DWORD
Value Description:
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 set. This value overrides the account settings if set, and doesn’t require the user to be logged in to an account.
Comments: Applies DSCP tagging for audio and video. If using any values besides the default (40 for video, 56 for audio), DSCP tagging requires admin privileges and that the “EnableIndependentDataPort” key be set to 1 to tag the VDI client traffic.
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableMMRDirect_Phone
Value Type: DWORD
Value Description:
(0) no restrictions
(1) Do not attempt to connect directly to the Zoom Phone Server from the thin client.
Comments: If your network firewall prevents the zoom process from connecting to the Zoom Phone Server on the thin client, setting this registry option to 1 may speed up Zoom Phone calls. If this is configured on the thin client, those settings will take override the settings on the virtual desktop.
VDI 5.7.6 or later
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableUDPBridge_Phone
Value Type: DWORD
Value Description:
(0) no restrictions
(1) Prevent sending Zoom Phone audio over a UDP connection from the thin client to the virtual desktop
Comments: If your thin client cannot connect to the Virtual Desktop over UDP, setting this to 1 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 5.7.6 or later
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableChannelBridge_Phone
Value Type: DWORD
Value Description:
(0) no restrictions
(1) Prevent sending Zoom Phone audio over a channel connection (or example the ICA protocol connection channel).
Comments: This option allows you to disable sending Zoom Phone audio over the protocol channel. If your configuration is expected to use Direct or UDP, enabling this option would prevent Zoom Phone from using the unintended media transport of the channel.
VDI 5.7.6 or later
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: DisableVDIToolFileTransfer
Value Type: DWORD
Value Description:
(0) (default) no restriction on Zoom VDI tool
(1) File transfer from Plugin to VM is disabled when using ZoomVDITool
Comments: This option allows you to disable the ability for the ZoomVDITool to pull log files from the remote client.
VDI 5.9.6 or later
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: CheckHdxMediaOptimization
Value Type: DWORD
Value Description:
(0) Check if Skype for Business or Teams are running (the “lync.exe” process is running) and do not force HID redirection if they are
(1) Check if “HDX media optimization” is active and, if it is, do not force HID redirection
Comments: A value of (0) will check to see if Lync (Skype for Business) or Teams is running to determine if Zoom can allocate HID devices. If either process is running, Zoom does not attempt to take control of HID devices.
If the value is set to (1), the check is to determine if HDX Media Optimization is active (using HID devices). If not, Zoom takes control of HID support.
These options to force HID redirection are provided for evaluation in 5.10.6. A default value for this option will be determined for a future release.
Version 5.10.6
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: EnableVDIPluginAutoUpgrade
Value Type: DWORD
Value Description:
(0) Default (plugin auto-update is disabled)
(1) Enable Plugin AutoUpdate
Comments: This option is required to enable the VDI plugin auto-update feature. It is disabled by default. Adding the policy on the VM will enable 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. An example would be to add the policy for managed devices to disable updates internally, while still allowing auto-update to update users' personal devices at home.
5.9.6 VDI Zoom Meeting client or later
5.9.6 VDI Plugin for Windows for VDI Plugin Management software on Client
5.12.6 VDI Plugin for Mac for VDI Plugin Management software on Client
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: AutoUpdatePluginVersion
Value Type: String Value (REG_SZ)
Value Description: Example "5.9.6", plugin release version
Comments: This option specifies the auto-upgrade plug-in version. The auto-update plugin will give priority to the specified version. If the specified version is invalid, the web server configuration should prevail.
Note: The plugin version must fall within a range of acceptable values that apply to each version of the host client. Values that are invalid will be ignored, and a value matching the host value will be used instead. The following table shows some rows as examples of supported values. Please refer to VDI plugin and Auto-Update plugin versions for a complete list of supported versions.
VDI Client Version | Default Plugin Version | Minimum Supported Plugin Version | Maximum Supported Plugin Version |
5.10.7 | 5.10.6 | 5.10.0 | 5.10.6 |
5.11.0 | 5.11.0 | 5.10.0 | 5.11.0 |
5.11.2 | 5.11.2 | 5.10.0 | 5.11.2 |
5.9.6 VDI Zoom Meeting client or later
5.9.6 VDI Plugin for Windows for VDI Plugin Management software on Client
5.12.6 VDI Plugin for Mac for VDI Plugin Management software on Client
Key: SOFTWARE\Policies\Zoom\Zoom Meetings\VDI
Value: UpdatePluginLater
Value Type: DWORD
Value Description:
(0) Default (plugin auto-update later option is disabled)
(1) Enables Plugin AutoUpdate Later Option (5.11.6 VDI Zoom Meeting client or higher)
(2) Selecting "Later" waits until the desktop is disconnected (5.13.0 VDI Zoom Meeting client or higher)
Comments: The default dialog displayed to the user does not include a button for “Later”. Adding this policy modifies the dialog and adds an additional Later button.
Option 1 displays a "Later" button in the dialog when an action (install, update or downgrade) is required. Clicking Later 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.
Option 2 also displays a "Later" button but clicking Later for option 2 will wait until the user disconnects from their virtual desktop(s) and then perform the required action.
Zoom Community
Join the 100K+ other members in the Zoom Community! Login with your Zoom account credentials and start collaborating.