通过注册表管理的 HDX™ 功能
注意：
不正确地编辑注册表可能会导致严重问题，甚至可能需要重新安装操作系统。Citrix® 无法保证可以解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。编辑注册表之前，请务必备份注册表。
要在服务器上打开注册表编辑器，请运行 regedit.exe。然后导航到注册表项以添加或编辑设置。
设备
彭博键盘设备
Citrix Virtual Apps and Desktops™ 支持彭博型号 4 和型号 3 星板键盘。默认情况下，增强型彭博键盘的支持处于禁用状态。
要启用对 Bloomberg 键盘的支持，请在启动连接之前在客户端计算机上设置以下注册表值：
-
键：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICAClient\GenericUSB -
值名称：
EnableBloombergHID -
值类型：
DWORD -
值数据：
-
0- 禁用 -
1- 启用
-
有关详细信息，请参阅 Bloomberg 键盘。
映射的客户端驱动器
作为一项安全预防措施，当用户登录到 Citrix Virtual Apps and Desktops 时，服务器默认映射客户端驱动器，但不授予用户运行权限。要使用户能够运行驻留在映射客户端驱动器上的可执行文件，请通过编辑服务器上的注册表来覆盖此默认设置。
要允许访问，请编辑以下注册表值（如果不存在，请创建 CDMSettings）：
-
键：
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Citrix\CDMSettings -
值名称：
ExecuteFromMappedDrive -
值类型：
DWORD -
值数据：
-
1- 允许权限 -
0- 拒绝映射驱动器上的权限
-
更改在您编辑注册表后连接的会话中生效。
Citrix 虚拟应用和桌面 7 2006 是第一个包含此注册表位置的版本。早期版本的 Citrix 虚拟应用和桌面 使用了不同的注册表位置。
有关详细信息，请参阅客户端驱动器映射。
微软 Surface Pro 平板电脑和 Surface Book 笔记本电脑的触控笔
Citrix Virtual Apps and Desktops 支持基于 Windows Ink 的应用程序的标准笔功能。默认情况下，此功能处于启用状态。
要禁用或启用此功能，请设置以下注册表值：
-
键:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Citrix Virtual Desktop Agent\PenApi -
值名称:
DisablePen -
值类型:
DWORD -
值数据:
-
1- 禁用 -
0- 启用
-
有关详细信息，请参阅 微软 Surface Pro 和 Surface Book 触控笔。
Windows 图像采集应用程序允许列表
此设置允许您控制 VDA 上的哪些应用程序可以访问 Windows 图像采集扫描仪重定向。
默认情况下，没有应用程序可以访问 Windows 图像采集。
要调整 VDA 上应用程序的 Windows 图像采集，请创建以下注册表设置：
-
键:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix -
值名称:
WIAAllowedProcesses选择并右键单击 WIAAllowedProcesses。选择新建 > 多字符串值，并将新值重命名为 AllowProcesses。
- 值数据: 输入可以访问 Windows 图像采集的每个应用程序的完整路径和进程名称。每行提供一个应用程序。
对此设置的任何更改将在您下次在 VDA 上启动会话时生效。
常规
HDX 缩减器
您可以配置要在会话主机中使用的 HDX 压缩算法 (Reducer) 版本。
要在单会话 VDA 中启用 Reducer V4，请设置以下注册表值：
键：HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\GroupPolicy\Defaults\WDSettings
值名称：ReducerOverrideMask
值类型：DWORD
值数据：23 (十进制)
要在多会话 VDA 中启用 Reducer V4，请设置以下注册表值：
-
键：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
值名称：
ReducerOverrideMask -
值类型：
DWORD -
值数据：
23(十进制)
配置 EDT 超时
您可以在 VDA 上将 EDT 超时配置为 5 到 25 秒之间的任何值。默认的 EDT 超时值为 25 秒。
-
键：
HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\Tds\udp\UDPStackParameters -
值类型：
DWORD -
值名称：
edtConnectionTimeout - 值数据：5 到 25 之间的秒数（十进制）
您还可以为适用于 Windows 的 Citrix Workspace™ 应用程序配置超时：
-
项：
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\EDT -
值类型：
String / REG_SZ -
值名称：
edtConnectionTimeout - 值数据：5 到 25 之间的秒数（十进制）
配置 会合 版本
要配置要使用的 Rendezvous 版本，请设置以下注册表值：
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\VirtualDesktopAgent -
值类型：
DWORD -
值名称：
GctRegistration -
值数据：
-
1- 启用 V2 -
0- 启用 V1
-
配置 VDA 自动登录
此设置允许您在 Windows 10 单会话操作系统和多会话操作系统 VDA 上启用或禁用 Microsoft 策略设置“始终提示输入密码”。
如果启用了“始终提示输入密码”，则用户在启动远程会话时必须在 VDA 上输入凭据。如果此设置被禁用，则用户无需在 VDA 上提供凭据即可自动连接到远程会话。
默认情况下，Microsoft 策略设置处于禁用状态。要启用或禁用“始终提示输入密码”设置，请在 VDA 上设置以下注册表值：
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Portica -
值名称：
AutoLogon -
值类型：
DWORD -
值数据：
-
1- 禁用 Microsoft 策略设置，并允许用户自动登录到远程会话。 -
0– 启用 Microsoft 策略设置，并在用户启动远程会话时提示他们提供凭据。
-
禁用超时警告
默认情况下，不活动或空闲会话的用户会在其会话自动断开连接前两分钟收到警告消息。
此设置禁用并移除以下情况下达到空闲会话超时限制的用户的警告消息：
- 视窗服务器 2004
- Windows 10 多会话 2004 或更高版本的多会话操作系统
要移除此警告，请在 VDA 上设置以下注册表值：
-
项：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Winstations\ICA-CGP -
值名称：
fEnableTimeoutWarning -
值类型：
DWORD -
值数据：
-
1- 禁用警告消息 -
0- 启用警告消息
-
要显示警告消息，请删除注册表值或将其设置为 0。
EDT MTU 发现机制
MTU 发现允许 EDT 在建立会话时自动确定最大传输单元 (MTU)。这样做可以防止 EDT 数据包碎片化，从而避免性能下降或会话建立失败。
此设置默认启用。要禁用 EDT MTU 发现，请配置以下注册表值并重新启动 VDA。
-
项：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
值名称：
MtuDiscovery -
值类型：
DWORD -
值数据：
0
此设置是全计算机范围的，会影响所有从受支持客户端连接的会话。
常规内容重定向
为主机到客户端重定向添加 URL 类型
默认情况下，我们支持以下 URL 类型的重定向：HTTP、HTTPS、RTSP、RTSPU、PNM 和 MMS。您可以通过在 Windows 客户端上创建以下注册表项和值来将 URL 类型添加到列表中。
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Policies\Citrix\ICA Client\SFTA -
值名称：
ExtraURLProtocols -
值类型：
REG_SZ -
值数据：指定所需的 URL 类型，用分号分隔。包括 URL 权限部分之前的所有内容。例如：
ftp://;mailto:;customtype1://;custometype2://
您只能为 Windows 客户端添加 URL 类型。缺少此注册表设置的客户端将拒绝重定向回 Citrix 会话。客户端必须安装并配置一个应用程序来处理指定的 URL 类型。
有关详细信息，请参阅主机到客户端重定向。
客户端文件夹重定向
客户端文件夹重定向改变了客户端文件在主机端会话中的访问方式。假设您在服务器上启用了客户端文件夹重定向，并且用户在用户设备上对其进行了配置。在这种情况下，用户指定的本地卷部分将被重定向。
要在服务器上启用客户端文件夹重定向，请设置以下注册表值：
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\Client Folder Redirection -
值名称：
CFROnlyModeAvailable -
值类型：
DWORD -
值数据：
1
有关详细信息，请参阅客户端文件夹重定向。
针对特定网站集的主机到客户端重定向
要为特定网站集启用主机到客户端重定向，请在服务器 VDA 上设置以下注册表值。
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA -
值名称：
ValidSites -
值类型：
REG_MULTI_SZ -
值数据：指定完全限定域名 (FQDN) 的任意组合。在单独的行上键入多个 FQDN。仅包含 FQDN，不带协议 (
http://或https://)。FQDN 只能在最左侧位置包含星号 (*) 作为通配符。此通配符匹配单个级别的域，这与 RFC 6125 中的规则一致。例如：
www.example.com
*.example.com
有关详细信息，请参阅主机到客户端重定向。
注销和断开连接时的本地应用程序行为
默认情况下，当用户注销或断开与虚拟桌面的连接时，本地应用程序会继续运行。重新连接后，如果本地应用程序在虚拟桌面上可用，则会重新集成。要配置注销和断开连接时的本地应用程序行为，请在托管桌面中设置以下注册表值：
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\wow6432node\Citrix\Client Hosted Apps\Policies -
值名称：
Session State -
值类型：
DWORD -
值数据：
-
1- 当用户从虚拟桌面注销或断开连接时，本地应用程序会继续运行。重新连接后，如果本地应用程序在虚拟桌面上可用，则会重新集成。 -
3- 当用户从虚拟桌面注销或断开连接时，本地应用程序会关闭。
-
有关详细信息，请参阅本地应用程序访问和 URL 重定向。
从主机到客户端重定向的默认列表中删除 URL 类型
要从默认重定向列表中删除 URL 类型，请在服务器 VDA 上创建以下注册表项和值。
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA -
值名称：
DisableServerFTA -
值类型：
DWORD -
值数据：
1 -
值名称：
NoRedirectClasses -
值类型：
REG_MULTI_SZ -
值数据：指定以下值的任意组合：
http、https、rtsp、rtspu、pnm或mms。在单独的行上键入多个值。例如：
http
https
rtsp
有关详细信息，请参阅主机到客户端重定向。
服务器 VDA 默认浏览器配置
您可以启用主机到客户端重定向，以覆盖服务器 VDA 上的任何默认浏览器配置。如果 Web URL 未重定向，Citrix 启动器会将该 URL 传递给 command_backup 注册表项中配置的浏览器。该注册表项默认指向 Internet Explorer，但您可以修改它以包含不同浏览器的路径。
-
IE 浏览器（默认）
-
键：
HKEY_CLASSES_ROOT\http\shell\open\command_backup -
值名称：
Default -
值类型：
REG_SZ -
值数据：
"c:\program files\internet explorer\iexplore.exe" "%1" -
键：
HKEY_CLASSES_ROOT\https\shell\open\command_backup -
值名称：
Default -
值类型：
REG_SZ -
值数据：
"c:\program files\internet explorer\iexplore.exe" "%1"
-
键：
-
谷歌浏览器
-
键:
HKEY_CLASSES_ROOT\http\shell\open\command_backup -
值名称:
Default -
值类型:
REG_SZ -
值数据:
"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" "%1" -
键:
HKEY_CLASSES_ROOT\https\shell\open\command_backup -
值名称:
Default -
值类型:
REG_SZ -
值数据:
"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" "%1"
-
键:
-
微软 Edge 浏览器
-
键:
HKEY_CLASSES_ROOT\http\shell\open\command_backup -
值名称:
Default -
值类型:
REG_SZ -
值数据:
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" "%1" -
键:
HKEY_CLASSES_ROOT\https\shell\open\command_backup -
值名称：
Default -
值类型：
REG_SZ -
值数据：
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" "%1"
-
键:
已发布的应用程序的本地应用程序访问
本地应用程序访问将本地安装的 Windows 应用程序无缝集成到托管桌面环境中，而无需在不同桌面之间切换。要提供对已发布应用程序的访问，请在服务器上设置以下注册表值：
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\DesktopStudio -
值名称：
ClientHostedAppsEnabled -
值类型：
DWORD -
值数据：
-
1- 启用 -
0- 禁用
-
有关详细信息，请参阅本地应用程序访问和 URL 重定向。
图形
针对 CUDA 或 OpenCL 应用程序的 GPU 加速
默认情况下，用户会话中运行的 CUDA 和 OpenCL 应用程序的 GPU 加速处于禁用状态。
要使用 CUDA 加速 POC 功能，请启用以下注册表设置：
-
键：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\CtxHook\AppInit_Dlls\Graphics Helper -
值名称：
CUDA -
值类型：
DWORD -
值数据：
00000001
要使用 OpenCL 加速 POC 功能，请启用以下注册表设置：
-
键：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\CtxHook\AppInit_Dlls\Graphics Helper -
值名称：
OpenCL -
值类型：
DWORD -
值数据：
00000001
有关详细信息，请参阅 适用于 Windows 多会话操作系统的 GPU 加速
渐进模式
渐进模式默认处于禁用状态。您可以使用以下注册表值更改渐进模式状态：
-
键：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Graphics -
值类型：
REG_DWORD -
值名称:
ProgressiveDisplay -
值数据:
-
0- 始终关闭 (禁用渐进模式。此值为默认值。) -
1- 自动 (根据网络状况切换。) - 2 = 始终开启
-
有关详细信息，请参阅 渐进模式。
注意：
渐进模式已弃用。Thinwire 是一种替代选项，它优化了图像传输并保持了缓存效率，同时提供了渐进模式的几乎所有优点。
Windows Presentation Foundation (WPF) rendering
HDX 3D Pro 允许在 Windows 多会话操作系统会话中运行的图形密集型应用程序在服务器的图形处理单元 (GPU) 上进行渲染。通过将 Windows Presentation Foundation (WPF) 渲染移至服务器的 GPU，图形渲染不会降低服务器 CPU 的速度。
要使用服务器的 GPU 启用 WPF 应用程序渲染，请在运行 Windows 多会话操作系统的服务器注册表中创建以下设置：
-
在 VDA 上打开注册表编辑器并转到以下项：
HKLM\Software\Citrix\CtxHook\AppInit_DLLs\Graphics Helper -
创建或编辑以下注册表值：
- [REG_DWORD] 适配器句柄 = 0x00000001
- [REG_DWORD] 设备路径 = 0x00000001
- [REG_DWORD] 标志 = 0x00000412
- [REG_DWORD] WPF = 0x00000001
-
使用您的 WPF 应用程序的可执行文件名称创建一个子项。例如，如果您的应用程序名为“mywpfapp.exe”，请创建以下项：
HKLM\Software\Citrix\CtxHook\AppInit_DLLs\Graphics Helper\mywpfapp.exe -
重新启动服务器以使设置生效。
有关详细信息，请参阅适用于 Windows 多会话操作系统的 GPU 加速 以及关于充分利用 Windows 多会话操作系统上的 WPF 应用程序 的博客。
多媒体
在多媒体会议期间避免回声
Citrix Virtual Apps and Desktops 提供回声消除选项，可最大程度地减少任何回声。此功能默认启用。要禁用回声消除，您可以更改以下注册表设置之一：
-
项：
- 32 位：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ClientAudio - 64 位：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ClientAudio
- 32 位：
-
值名称：
EchoCancellation -
值类型：
String/REG_SZ -
值数据:
False
有关详细信息，请参阅音频功能。
音频限制
在客户端上安装音频设备、启用音频重定向并启动 RDS 会话后，音频文件可能无法播放音频。作为一种解决方法，请在 RDS 计算机上添加以下注册表项，然后重新启动计算机：
-
项:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SCMConfig -
值名称:
EnableSvchostMitigationPolicy -
值类型:
DWORD -
值数据:
0
有关详细信息，请参阅音频功能。
浏览器内容重定向和 DPI
当在用户计算机上使用浏览器内容重定向且 DPI（缩放）设置为 100% 以上时，重定向的浏览器内容屏幕会显示不正确。为避免此问题，请通过在用户计算机上创建以下注册表值来禁用 Chrome 的浏览器内容重定向 GPU 加速：
-
项:
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\HdxMediaStream -
值名称:
GPU -
值类型:
DWORD -
值数据:
0
有关详细信息，请参阅浏览器内容重定向和 DPI。
高清网络摄像头分辨率
如果媒体类型协商失败，HDX 将回退到默认 VGA 分辨率 (640 x 480 像素)。您可以使用客户端上的注册表项来配置默认分辨率。在设置以下注册表项之前，请确保摄像头支持指定的分辨率。
-
键：
HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXRealTime - 宽度
-
值名称：
DefaultWidth -
值类型：
DWORD - 值数据：所需的十进制宽度（例如：1280）
-
值名称：
- 高度
-
值名称：
DefaultHeight -
值类型：
DWORD - 值数据：所需的十进制高度（例如 720）
-
值名称：
微软团队回退模式
如果 Microsoft Teams 未能在优化 VDI 模式下加载（在 Teams/关于/版本中显示“Citrix HDX 未连接”），VDA 将回退到旧版 HDX 技术，例如网络摄像头重定向以及客户端音频和麦克风重定向。如果您使用的 Workspace 应用程序版本/平台操作系统不支持 Microsoft Teams 优化，则回退注册表项不适用。
要控制回退机制，请在 VDA 上设置以下注册表值之一：
-
密钥（只需一个）：
-
计算机设置：
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams -
用户设置：
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Teams
-
计算机设置：
-
值名称：
DisableFallback -
值类型：
DWORD - 值数据：
-
1- 禁用回退模式 -
2- 仅启用音频
-
如果该值不存在或设置为 0，则启用回退模式。此功能需要 Microsoft Teams 版本 1.3.0.13565 或更高版本。有关详细信息，请参阅Microsoft Teams 优化。
使用 思杰应用分层™ 优化 微软 Teams
如果使用 Citrix App Layering 在不同层中管理 VDA 和 Microsoft Teams 安装，请在从命令行使用 ALLUSER=1 标志安装 Microsoft Teams 之前，在 Windows 上创建名为 PortICA 的空注册表项。保留默认值名称、类型和数据。
- 注册表编辑器的 32 位版本密钥：
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\PortICA - 注册表编辑器的 64 位版本密钥：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\PortICA
有关详细信息，请参阅Microsoft Teams 优化。
结合集成 Windows 身份验证的浏览器内容重定向单点登录
此设置提供对与 VDA 位于同一域中、配置了集成 Windows 身份验证 (IWA) 的 Web 服务器的单点登录。要启用单点登录，请将以下注册表值设置为 1：
-
密钥：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\HdxMediastream
或
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Citrix\HdxMediastream
-
值名称：
WebBrowserRedirectionIwaSupport -
值类型：
DWORD -
值数据：
1
有关详细信息，请参阅使用集成 Windows 身份验证进行单点登录。
用户代理请求标头
user-agent 标头有助于识别从浏览器内容重定向发送的 HTTP 请求。此设置在配置代理和防火墙规则时非常有用。例如，如果服务器阻止了从浏览器内容重定向发送的请求，您可以创建一个包含 user-agent 标头的规则来绕过某些要求。只有 Windows 设备支持 user-agent 请求标头。
默认情况下，user-agent 请求标头字符串处于禁用状态。要为客户端呈现的内容启用 user-agent 标头，请使用注册表编辑器。
在每个适用于 Windows 客户端的 Citrix Workspace 应用程序上，设置以下注册表设置之一：
-
密钥：
- 32 位：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\HdxMediaStream - 64 位:
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\HdxMediaStream
- 32 位：
-
值名称:
EnableCefUserAgentString -
值类型:
DWORD -
值数据:
1
添加注册表值后，用户代理标头将包含 CitrixBCR/2102.1 文本，其中 2102.1 是适用于 Windows 版本的 Citrix Workspace 应用程序。
网络摄像头软件压缩
如果网络摄像头支持硬件编码，HDX 视频压缩默认使用硬件编码。硬件编码可能比软件编码消耗更多带宽。要强制执行软件压缩，请将以下值添加到客户端：
-
项:
HKEY_CURRENT_USER\SOFTWARE\Citrix\HdxRealTime -
值名称:
DeepCompress_ForceSWEncode -
值类型:
DWORD -
值数据:
1
有关详细信息，请参阅 HDX 网络摄像头视频压缩。
网络摄像头视频压缩
HDX 网络摄像头视频压缩将 H.264 视频直接发送到在虚拟会话中运行的视频会议应用程序。为了优化 VDA 资源，HDX 网络摄像头压缩不会对网络摄像头视频进行编码、转码和解码。此功能默认启用。
要禁用从服务器到视频会议应用程序的直接视频流，请在 VDA 中设置以下注册表值。
-
键:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\HdxRealTime -
值名称:
OfferH264ToApp -
值类型:
DWORD -
值数据:
0
有关详细信息，请参阅 HDX 网络摄像头视频压缩。
网络摄像头视频压缩帧率
要调整首选视频帧率，请在客户端上编辑以下注册表值：
-
键:
HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXRealTime -
值名称:
FramesPerSecond -
值类型:
DWORD -
值数据:
15
如果网络摄像头不支持指定的帧率，应用程序默认使用 15 FPS。
有关详细信息，请参阅 HDX 网络摄像头视频压缩。