HDX™ 通过注册表管理的功能
注意：
不正确地编辑注册表可能会导致严重问题，可能需要重新安装操作系统。Citrix® 无法保证能够解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。在编辑注册表之前，请务必备份注册表。
要在服务器上打开注册表编辑器，请运行 regedit.exe。然后导航到注册表项以添加或编辑设置。
设备
Bloomberg 键盘
Citrix Virtual Apps and Desktops™ 支持 Bloomberg model 4 和 model 3 starboard 键盘。默认情况下，对增强型 Bloomberg 键盘的支持处于禁用状态。
要在启动连接之前启用对 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 Virtual Apps and Desktops 7 2006 是第一个包含此注册表位置的版本。早期版本的 Citrix Virtual Apps and Desktops 使用不同的注册表位置。
有关详细信息，请参阅客户端驱动器映射。
Microsoft 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- 启用
-
有关详细信息，请参阅Microsoft Surface Pro 和 Surface Book 触控笔。
Windows 图像采集应用程序允许列表
此设置允许您控制 VDA 上的哪些应用程序可以访问 Windows 图像采集扫描仪重定向。
默认情况下，没有应用程序可以访问 Windows 图像采集。
要调整 VDA 上应用程序的 Windows 图像采集，请创建以下注册表设置：
-
项：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix -
值名称：
WIAAllowedProcesses选择并右键单击 WIAAllowedProcesses。选择 新建 > 多字符串值，并将新值重命名为 AllowProcesses。
- 值数据：输入可以访问 Windows 图像采集的每个应用程序的完整路径和进程名称。每行提供一个应用程序。
对此设置的任何更改将在您下次在 VDA 上启动会话时生效。
常规
HDX Reducer
您可以配置要在会话主机中使用的 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（十进制）
配置 Rendezvous 版本
要配置要使用的 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 策略设置，并在用户启动远程会话时提示他们提供凭据。
-
禁用超时警告
默认情况下，不活动或空闲会话的用户会在其会话自动断开连接前两分钟收到警告消息。
此设置禁用并移除以下情况下达到空闲会话超时限制的用户的警告消息：
- Windows Server 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 发现，请配置以下注册表值并重新启动会话主机：
-
键：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
值名称：
MtuDiscovery -
值类型：
DWORD -
值数据：
0
要启用 MTU 重新发现，请配置以下注册表值并重新启动会话主机：
-
键：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\MtuRediscovery -
值名称：
MtuReDiscovery -
值类型：
DWORD -
值数据：
1 -
键：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\MtuRediscovery -
值名称：
MtuReDiscoveryFrequency -
值类型：
DWORD -
值数据：
1
这些设置是计算机范围的，会影响从受支持客户端连接的所有会话。
EDT 超时
您可以将 VDA 中的 EDT 超时设置为 5 到 25 秒之间的任何值。默认的 EDT 超时值为 10 秒。
-
注册表项：
HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\Tds\udp\UDPStackParameters -
值类型：
DWORD -
值名称：
edtConnectionTimeout - 值数据：5 到 25 之间的秒数（十进制）
您还可以为适用于 Windows 版本 2409.10 及更早版本的 Citrix Workspace app 设置 EDT 超时：
-
注册表项：
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\EDT -
值类型：
String / REG_SZ -
值名称：
edtConnectionTimeout - 值数据：5 到 25 之间的秒数（十进制）
注意：
从版本 2503 开始，Citrix Workspace app 将使用 VDA 中的超时设置，从而无需在客户端设备上配置超时。
常规内容重定向
添加用于主机到客户端重定向的 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，但您可以修改它以包含不同浏览器的路径。
-
Internet Explorer（默认）
-
项:
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"
-
项:
-
Google Chrome
-
项:
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"
-
项:
-
Microsoft 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"
-
项:
已发布的应用程序的 Local App Access
Local App Access 可将本地安装的 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) 渲染
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] AdapterHandle = 0x00000001
- [REG_DWORD] DevicePath = 0x00000001
- [REG_DWORD] Flag = 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
有关详细信息，请参阅音频功能。
高清网络摄像头分辨率
如果媒体类型协商失败，HDX 将回退到默认的 VGA 分辨率（640 x 480 像素）。您可以在客户端上使用注册表项来配置默认分辨率。在设置以下注册表项之前，请确保摄像头支持指定的分辨率。
-
键：
HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXRealTime - 宽度
-
值名称：
DefaultWidth -
值类型：
DWORD - 值数据：所需的十进制宽度（例如：1280）
-
值名称：
- 高度
-
值名称：
DefaultHeight -
值类型：
DWORD - 值数据：所需十进制高度（例如 720）
-
值名称：
Microsoft Teams 回退模式
如果 Microsoft Teams 未能在优化 VDI 模式下加载（在 Teams/About/Version 中显示“Citrix HDX Not Connected”），VDA 将回退到旧版 HDX 技术，例如网络摄像头重定向以及客户端音频和麦克风重定向。如果您使用的 Workspace app 版本/平台操作系统不支持 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 优化。
使用 Citrix App Layering™ 优化 Microsoft 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 优化。
网络摄像头软件压缩
如果网络摄像头支持硬件编码，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 网络摄像头视频压缩。