通过注册表管理的 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 Virtual Apps and Desktops 7 2006 是第一个包含此注册表位置的版本。此前的版本使用了不同的注册表位置。
有关详细信息，请参阅客户端驱动器映射。
Microsoft Surface Pro and Surface Book pens
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 Direct 的默认超时时间为 60 秒。要更改超时时间，请修改以下注册表值：
-
键:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\HdxDirect -
值名称:
HdxDirectInitiateTimeoutInSeconds -
值类型:
DWORD -
值数据:
60(十进制)
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 功能的版本
要配置要使用的 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 服务器 2004 操作系统
- Windows 10 多会话 2004 或更高版本的多会话操作系统
要删除警告，请在 VDA 上设置以下注册表值：
-
键：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Winstations\ICA-CGP -
值名称：
fEnableTimeoutWarning -
值类型：
DWORD -
值数据：
-
1- 禁用警告消息 -
0- 启用警告消息
-
要显示警告消息，请删除注册表值或将其设置为 0。
EDT 最大传输单元发现
MTU 发现允许 EDT 在建立会话时自动确定最大传输单元 (MTU)。这样做可以防止 EDT 数据包碎片化，从而避免性能下降或会话建立失败。
此设置默认启用。要禁用 EDT MTU 发现，请配置以下注册表值并重新启动 VDA。
-
键：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
值名称：
MtuDiscovery -
值类型：
DWORD -
值数据：
0
此设置是计算机范围的，会影响从受支持的客户端连接的所有会话。
启用容忍丢包模式
您可以通过容损模式访问适用于 Windows 的 Citrix Workspace 应用程序、多用户 VDA 和桌面 VDA 的双向音频服务。此设置默认禁用。要启用容损模式，请根据您使用的计算机，配置以下注册表值并重新启动相应的计算机。
对于适用于 Windows 的 思杰工作区应用程序客户端，
-
键：
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ClientAudio -
值名称：
EdtUnreliableAllowed -
值类型：
REG_SZ -
值数据：
1
对于终端服务虚拟投递代理，
-
键:
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\Audio -
值名称:
EdtUnreliableAllowed -
值类型:
DWORD -
值数据:
1
For WS VDA,
-
键:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Audio -
值名称:
EdtUnreliableAllowed -
值类型:
DWORD -
值数据:
1
常规内容重定向
为主机到客户端重定向添加 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
有关详细信息，请参阅音频功能。
高清网络摄像头分辨率
如果媒体类型协商失败，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 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 摄像头视频压缩。