通过注册表管理的 HDX™ 功能
注意：
不正确地编辑注册表可能会导致严重问题，可能需要重新安装操作系统。Citrix® 无法保证可以解决因不正确使用注册表编辑器而导致的问题。使用注册表编辑器风险自负。在编辑注册表之前，请务必备份注册表。
要打开注册表编辑器，请在服务器上运行 regedit.exe。然后导航到注册表项以添加或编辑设置。
设备
彭博终端键盘
Citrix Virtual Apps and Desktops™ 支持彭博型号 4 和型号 3 右舷键盘。默认情况下，增强型彭博键盘的支持处于禁用状态。
要在启动连接之前启用彭博键盘支持，请在客户端计算机上设置以下注册表值：
-
键：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICAClient\GenericUSB -
值名称：
EnableBloombergHID -
值类型：
DWORD -
值数据：
-
0- 禁用 -
1- 启用
-
有关详细信息，请参阅彭博键盘。
映射的客户端驱动器
作为安全预防措施，当用户登录到 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 上启动会话时生效。
常规
安全连接端口
在 VDA 上启用 TLS/DTLS 时，默认连接端口号为 443。要更改端口，请修改以下注册表值：
-
项：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
值名称：
SSLPort -
值类型：
DWORD -
值数据：
443（十进制）
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(十进制)
Configure Rendezvous version
要配置要使用的 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 应用程序设置 EDT 超时：
-
键：
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\EDT -
值类型：
String / REG_SZ -
值名称：
edtConnectionTimeout - 值数据: 5 到 25 秒之间的时间（十进制）
注意：
从版本 2503 开始，Citrix Workspace 应用程序将使用 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，但您可以修改它以包含不同浏览器的路径。
-
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 应用程序的图形处理器加速
默认情况下，用户会话中运行的 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 呈现基础 (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] 适配器句柄 = 0x00000001
- [REG_DWORD] 设备路径 = 0x00000001
- [REG_DWORD] 标志 = 0x00000412
- [REG_DWORD] 视窗演示基础 = 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）
-
值名称：
微软 Teams 回退模式
如果 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。
使用 Citrix 应用分层™ 优化 微软 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 网络摄像头视频压缩。