HDX™ 通过注册表管理的功能
注意：
不正确地编辑注册表可能会导致严重问题，可能需要您重新安装操作系统。Citrix® 无法保证能够解决因不正确使用注册表编辑器而导致的问题。请自行承担使用注册表编辑器的风险。在编辑注册表之前，请务必备份注册表。
要打开注册表编辑器，请在服务器上运行 regedit.exe。然后导航到注册表项以添加或编辑设置。
设备
-
Bloomberg 键盘
-
Citrix Virtual Apps and Desktops™ 支持 Bloomberg 型号 4 和型号 3 星板键盘。默认情况下，增强型 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 使用了不同的注册表位置。
- 有关详细信息，请参阅[客户端驱动器映射](/zh-cn/citrix-virtual-apps-desktops/devices/client-drive-mapping.html)。
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，请设置以下注册表值：
-
Key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
Value name:
ReducerOverrideMask -
Value type:
DWORD -
Value data:
23（十进制） -
配置 Rendezvous 版本
-
要配置要使用的 Rendezvous 版本，请设置以下注册表值：
-
Key:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\VirtualDesktopAgent -
Value type:
DWORD
-
Key:
-
Value name:
GctRegistration -
Value data:
-
1- 启用 V2 -
0- 启用 V1
-
配置 VDA 自动登录
此设置允许您在 Windows 10 单会话操作系统和多会话操作系统 VDA 上启用或禁用 “始终提示输入密码” Microsoft 策略设置。
-
如果启用了 “始终提示输入密码”，则用户在启动远程会话时必须在 VDA 上输入凭据。如果禁用此设置，则用户将自动连接到远程会话，而无需在 VDA 上提供凭据。
-
默认情况下，Microsoft 策略设置处于禁用状态。要启用或禁用 “始终提示输入密码” 设置，请在 VDA 上设置以下注册表值：
-
Key:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Portica -
Value name:
AutoLogon -
Value type:
DWORD -
Value data:
-
1- 禁用 Microsoft 策略设置，并允许用户自动登录到远程会话。 -
0– 启用 Microsoft 策略设置，并在用户启动远程会话时提示他们提供凭据。
-
-
禁用超时警告
默认情况下，不活动或空闲会话的用户会在其会话自动断开连接前两分钟收到警告消息。
-
此设置禁用并删除以下操作系统上达到空闲会话超时限制的用户的警告消息：
- Windows Server 2004
-
Windows 10 多会话 2004 或更高版本的多会话操作系统
-
要删除警告，请在 VDA 上设置以下注册表值：
-
Key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Winstations\ICA-CGP -
Value name:
fEnableTimeoutWarning -
Value type:
DWORD -
Value data:
-
1- 禁用警告消息 -
0- 启用警告消息
-
要显示警告消息，请删除注册表值或将其设置为 0。
此设置默认处于启用状态。要禁用 EDT MTU 发现，请配置以下注册表值并重新启动会话主机：
-
Key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
Value name:
MtuDiscovery -
Value type:
DWORD -
Value data:
0 -
要启用 MTU 重新发现，请配置以下注册表值并重新启动会话主机：
-
Key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\MtuRediscovery -
Value name:
MtuReDiscovery -
Value type:
DWORD -
Value data:
1 -
Key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\MtuRediscovery -
Value name:
MtuReDiscoveryFrequency -
Value type:
DWORD -
Value data:
1
这些设置是计算机范围的，会影响从受支持的客户端连接的所有会话。
- ### EDT 超时
- 您可以将 VDA 中的 EDT 超时设置为 5 到 25 秒之间的任意值。默认 EDT 超时值为 10 秒。
-
Key：
HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\Tds\udp\UDPStackParameters -
Value type：
DWORD-
Value name：
edtConnectionTimeout -
Value data：5 到 25 之间的秒数（十进制）
-
您还可以为适用于 Windows 版本 2409.10 及更早版本的 Citrix Workspace 应用程序设置 EDT 超时：
-
Key：
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\EDT -
Value type：
String / REG_SZ -
Value name：
edtConnectionTimeout -
Value data：5 到 25 之间的秒数（十进制）
-
注意：
-
-
从版本 2503 开始，Citrix Workspace 应用程序将使用 VDA 中的超时设置，无需在客户端设备上配置超时。
-
-
Value name：
通用内容重定向
为主机到客户端重定向添加 URL 类型
- 默认情况下，我们支持重定向以下 URL 类型：HTTP、HTTPS、RTSP、RTSPU、PNM 和 MMS。您可以通过在 Windows 客户端上创建以下注册表项和值来将 URL 类型添加到列表中。
- **Key**：`HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Policies\Citrix\ICA Client\SFTA`
- **Value name**：`ExtraURLProtocols`
- **Value type**：`REG_SZ`
- **Value data**：指定所需的 URL 类型，以分号分隔。包括 URL 授权部分之前的所有内容。例如： `ftp://;mailto:;customtype1://;custometype2://`
您只能为 Windows 客户端添加 URL 类型。缺少此注册表设置的客户端将拒绝重定向回 Citrix 会话。客户端必须安装并配置了用于处理指定 URL 类型的应用程序。
有关详细信息，请参阅主机到客户端重定向。
-
客户端文件夹重定向
-
客户端文件夹重定向改变了客户端文件在主机端会话中的访问方式。假设您在服务器上启用了客户端文件夹重定向，并且用户在用户设备上对其进行了配置。在这种情况下，用户指定的本地卷部分将被重定向。
-
要在服务器上启用客户端文件夹重定向，请设置以下注册表值：
-
Key：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\Client Folder Redirection -
Value name：
CFROnlyModeAvailable -
Value type：
DWORD -
Value data：
1 - 有关详细信息，请参阅客户端文件夹重定向。
-
针对特定网站集的主机到客户端重定向
- 要针对特定网站集启用主机到客户端重定向，请在服务器 VDA 上设置以下注册表值。
-
Key：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA -
Value name：
ValidSites -
Value type：
REG_MULTI_SZ-
Value data：指定完全限定域名 (FQDN) 的任意组合。在单独的行上键入多个 FQDN。仅包含 FQDN，不带协议（
http://或https://）。FQDN 只能在最左侧位置包含星号 (*) 作为通配符。此通配符匹配单个域级别，这与 RFC 6125 中的规则一致。例如：
-
Value data：指定完全限定域名 (FQDN) 的任意组合。在单独的行上键入多个 FQDN。仅包含 FQDN，不带协议（
www.example.com
*.example.com
有关详细信息，请参阅主机到客户端重定向。
- ### 注销和断开连接时的本地应用程序行为
- 默认情况下，当用户从虚拟桌面注销或断开连接时，本地应用程序会继续运行。重新连接后，如果本地应用程序在虚拟桌面上可用，则会重新集成。要配置注销和断开连接时的本地应用程序行为，请在托管桌面中设置以下注册表值：
-
Key：
HKEY_LOCAL_MACHINE\SOFTWARE\wow6432node\Citrix\Client Hosted Apps\Policies -
Value name：
Session State -
Value type：
DWORD -
Value data：
-
1- 当用户从虚拟桌面注销或断开连接时，本地应用程序会继续运行。重新连接后，如果本地应用程序在虚拟桌面上可用，则会重新集成。 -
3- 当用户从虚拟桌面注销或断开连接时，本地应用程序会关闭。
-
- 有关详细信息，请参阅本地应用程序访问和 URL 重定向。
从主机到客户端重定向的默认列表中删除 URL 类型
-
要从默认重定向列表中删除 URL 类型，请在服务器 VDA 上创建以下注册表项和值。
-
Key：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA -
Value name：
DisableServerFTA-
Value type：
DWORD -
Value data：
1 -
Value name：
NoRedirectClasses -
Value type：
REG_MULTI_SZ -
Value data：指定以下值的任意组合：
http、https、rtsp、rtspu、pnm或mms。在单独的行上键入多个值。例如：
-
Value type：
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- 禁用
-
有关详细信息，请参阅Local App Access 和 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/关于/版本中显示“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™ 优化 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 网络摄像头视频压缩。