HDX特性通过注册表管理

注意:

不正确地编辑注册表可能会导致严重的问题，可能需要重新安装操作系统。Citrix不能保证由于不正确使用注册表编辑器而导致的问题能够得到解决。请自行承担使用注册表编辑器的风险。在编辑注册表之前，请务必备份注册表。

要打开注册表编辑器，请运行regedit.exe在服务器上。然后导航到注册表项以添加或编辑设置。

设备

布隆伯格键盘

Citrix虚拟应用程序和台式机支持彭博社模型4和模型3右舷键盘。默认情况下，对增强的Bloomberg键盘的支持是禁用的。

要启用对Bloomberg键盘的支持，请在开始连接之前在客户端机器上设置以下注册表值:

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ Citrix \ ICAClient \ GenericUSB
• 值名称:EnableBloombergHID
• 值类型:双字
• 取值data: 0 =不启用，1 =启用

有关更多信息，请参见布隆伯格键盘．

映射客户端驱动器

作为安全防范措施，当用户登录Citrix Virtual Apps和desktop时，默认情况下，服务器映射客户端驱动器而无需用户运行许可。要使用户能够运行映射的客户机驱动器上的可执行文件，可以通过编辑服务器上的注册表来覆盖这个默认值。

要允许访问，请编辑以下注册表值(创建CDMSettings如果它不存在):

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ \ Citrix \ CDMSettings政策
• 值名称:ExecuteFromMappedDrive
• 值类型:双字
• 取值data: 1 =允许权限，0 =拒绝权限

此更改对编辑注册表后连接的会话生效。

有关更多信息，请参见映射客户端驱动器．

微软Surface Pro和Surface Book笔

Citrix虚拟应用程序和桌面系统支持基于Windows ink的应用程序的标准笔功能。默认情况下，该功能是启用的。

要禁用或启用该特性，请设置以下注册表值:

• 关键字:HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Citrix虚拟桌面代理\PenApi
• 值名称:DisablePen
• 值类型:双字
• 取值数据:1 =不启用，0 =启用

有关更多信息，请参见微软Surface Pro和Surface Book笔．

Windows图像采集应用程序允许列表

此设置允许您控制VDA上的哪些应用程序可以访问Windows图像采集扫描仪重定向。

默认情况下，没有应用程序可以访问Windows图像采集。

要在VDA上调整应用程序的Windows Image Acquisition，请创建以下注册表设置:

• 关键:HKEY_LOCAL_MACHINE \ \ Citrix的软件

• 值名称:WIAAllowedProcesses

  选择并右击WIAAllowedProcesses．选择新增>多字符串值并将新值重命名为AllowProcesses．

• Value data:为每个可以访问Windows Image Acquisition的应用程序输入完整的路径和进程名。在新行上提供每个应用程序。

对此设置的任何更改将在下次在VDA上启动会话时生效。

一般

配置自动登录VDA

此设置允许启用或禁用总是提示输入密码Windows 10单会话操作系统和多会话操作系统vda中的Microsoft策略设置。

如果总是提示输入密码时，用户在启动远程会话时必须在VDA上输入凭据。如果禁用此设置，用户将自动连接到远程会话，而无需在VDA上提供凭据。

默认情况下，Microsoft策略设置是禁用的。启用或禁用总是提示输入密码设置，在VDA上设置以下注册表值:

• 关键:HKEY_LOCAL_MACHINE \ \ Citrix \ Portica软件
• 值名称:AutoLogon
• 值类型:双字
• 值数据:
  • 1 -禁用Microsoft策略设置，并允许用户自动登录到远程会话。
  • 0 -启用Microsoft策略设置并提示用户在启动远程会话时提供凭据。

禁用超时预警

默认情况下，非活动或空闲会话的用户在会话自动断开前两分钟收到警告消息。

在Windows 2004或更高版本的多会话操作系统上，此设置禁用并删除对达到空闲会话超时限制的用户的警告消息。要删除警告，请在VDA上设置以下注册表值:

• 关键:HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \控制\ \ Winstations \ ICA-CGP终端服务器
• 值名称:fEnableTimeoutWarning
• 值类型:双字
• 取值data: 1 =关闭告警信息，0 =打开告警信息

要显示警告消息，请删除注册表值或将其设置为0。

美国东部时间MTU发现

MTU Discovery允许EDT在建立会话时自动确定最大传输单元(MTU)。这样做可以防止EDT包碎片化，这可能导致性能下降或建立会话失败。

此设置在默认情况下是启用的。要禁用EDT MTU Discovery，请删除以下注册表值并重新启动VDA。

• 关键:HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \控制\ \ Wds \ icawd终端服务器
• 值名称:MtuDiscovery
• 值类型:双字
• 值数据:00000001

此设置是全机器范围的，影响从受支持的客户机连接的所有会话。

一般内容重定向

添加主机URL类型到客户端重定向

默认情况下，支持HTTP、HTTPS、RTSP、RTSPU、PNM、MMS等URL类型的重定向。您可以通过在Windows客户端上创建以下注册表项和值，将URL类型添加到列表中。

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ WOW6432Node \ \ Citrix \ ICA端\ SFTA政策
• 值名称:ExtraURLProtocols
• 值类型:REG_SZ
• Value data:指定所需的URL类型，以分号分隔。包括URL的授权部分之前的所有内容。例如:ftp://;mailto:;customtype1://;custometype2://

只能为Windows客户端添加URL类型。缺少此注册表设置的客户端拒绝重定向回Citrix会话。客户端必须安装和配置一个应用程序来处理指定的URL类型。

有关更多信息，请参见主机到客户端的重定向．

客户端文件夹重定向

客户端文件夹重定向改变了在主机端会话中访问客户端文件的方式。如果您在服务器上启用了客户端文件夹重定向，并且用户在用户设备上配置了它，则用户指定的本地卷的部分将被重定向。

要在服务器上启用客户端文件夹重定向，请设置以下注册表值:

• 关键字:HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\Client文件夹重定向
• 值名称:CFROnlyModeAvailable
• 值类型:双字
• 值数据:1

有关更多信息，请参见客户端文件夹重定向．

主机到客户端的重定向为一组特定的网站

要启用特定网站集的主机到客户端重定向，请在服务器VDA上设置以下注册表值。

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ Wow6432Node \ Citrix \ SFTA
• 值名称:ValidSites
• 值类型:REG_MULTI_SZ
• 值数据:指定完全限定域名(FQDNs)的任意组合。在单独的行上键入多个fqdn。只包括FQDN，不包括协议(http://或https://）．FQDN可以包含星号(＊)仅作为最左边位置的通配符。这个通配符匹配单个级别的域，这与RFC 6125中的规则一致。例如:

www.example.com

* .example.com

有关更多信息，请参见主机到客户端的重定向．

注销和断开连接时的本地应用程序行为

默认情况下，当用户注销或断开与虚拟桌面的连接时，本地应用程序将继续运行。重新连接后，如果本地应用程序在虚拟桌面中可用，则重新集成它们。要配置本地应用程序在注销和断开连接时的行为，请在托管桌面中设置以下注册表值:

• 关键字:HKEY_LOCAL_MACHINE\SOFTWARE\wow6432node\Citrix\Client Hosted Apps\Policies
• 取值为“name”:会话状态
• 值类型:双字
• 值数据:
  • 1 -当用户注销或断开与虚拟桌面的连接时，本地应用程序继续运行。重新连接后，如果本地应用程序在虚拟桌面中可用，则重新集成它们。
  • 3 -当用户注销或断开虚拟桌面连接时，本地应用程序将关闭。

有关更多信息，请参见本地应用访问和URL重定向．

从主机到客户端重定向的默认列表中删除URL类型

要从默认重定向列表中删除URL类型，请在服务器VDA上创建以下注册表项和值。

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ Wow6432Node \ Citrix \ SFTA

• 值名称:DisableServerFTA
• 值类型:双字

• 值数据:1

• 值名称:NoRedirectClasses
• 值类型:REG_MULTI_SZ
• 值数据:指定值的任意组合: http，https，rtsp，rtspu，pnm,或mms．在单独的行上键入多个值。例如:

http

https

rtsp

有关更多信息，请参见主机到客户端的重定向．

服务器VDA默认浏览器配置

您可以启用主机到客户端重定向以取代Server VDA上的任何默认浏览器配置。如果web URL没有被重定向，Citrix启动器将URL传递给在command_backup注册表键。在默认情况下，关键指向Internet Explorer，但您可以修改它以包括到不同浏览器的路径。

• Internet Explorer(默认)

  • 关键:HKEY_CLASSES_ROOT \ http \壳\ \ command_backup开放
  • 值名称:默认
  • 值类型:REG_SZ

  • 值数据:"c:程序文件\internet explorer\ iexplorer .exe" %1

  • 关键:HKEY_CLASSES_ROOT \ https \壳\ \ command_backup开放的
  • 值名称:默认
  • 值类型:REG_SZ
  • 值数据:"c:程序文件\internet explorer\ iexplorer .exe" %1

• 谷歌Chrome

  • 关键:HKEY_CLASSES_ROOT \ http \壳\ \ command_backup开放
  • 值名称:默认
  • 值类型:REG_SZ

  • 值数据:"C: Program Files (x86)\谷歌\Chrome\Application\ Chrome .exe" %1

  • 关键:HKEY_CLASSES_ROOT \ https \壳\ \ command_backup开放
  • 值名称:默认
  • 值类型:REG_SZ
  • 值数据:"C: Program Files (x86)\谷歌\Chrome\Application\ Chrome .exe" %1

• 微软的优势

  • 关键:HKEY_CLASSES_ROOT \ http \壳\ \ command_backup开放
  • 值名称:默认
  • 值类型:REG_SZ

  • 值数据: "C: Program Files (x86)\Microsoft\Edge\Application\msedge.exe" %1

  • 关键:HKEY_CLASSES_ROOT \ https \壳\ \ command_backup开放
  • 值名称:默认
  • 值类型:REG_SZ
  • 值数据: "C: Program Files (x86)\Microsoft\Edge\Application\msedge.exe" %1

发布应用的本地应用访问

本地应用程序访问无缝地将本地安装的Windows应用程序集成到托管的桌面环境中，而无需从一个桌面切换到另一个桌面。要提供对已发布应用程序的访问，请在服务器上设置以下注册表值:

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ Wow6432Node \ Citrix \ DesktopStudio
• 值名称:ClientHostedAppsEnabled
• 值类型:双字
• 取值数据:1 =启用，0 =禁用

有关更多信息，请参见本地应用访问和URL重定向．

图形

CUDA或OpenCL应用的GPU加速

默认情况下，CUDA和OpenCL应用程序在用户会话中运行的GPU加速是禁用的。

要使用CUDA加速POC功能，请启用以下注册表设置:

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ Wow6432Node \ Citrix \ CtxHook \ AppInit_Dlls \图形辅助
• 值名称:CUDA
• 值类型:双字
• 值数据:00000001

要使用OpenCL加速POC特性，请启用以下注册表设置:

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ Wow6432Node \ Citrix \ CtxHook \ AppInit_Dlls \图形辅助
• 值名称:OpenCL
• 值类型:双字
• 值数据:00000001

有关更多信息，请参见Windows多会话操作系统的GPU加速

进步的模式

默认禁用渐进模式。您可以使用以下注册表值更改渐进模式状态:

• 关键:HKEY_LOCAL_MACHINE \ Citrix \ \软件图形
• 值类型:REG_DWORD
• 值名称:ProgressiveDisplay
• 值数据:
  • 0 =总是关闭(禁用前进模式。此值为默认值。)
  • 1 =自动(根据网络情况切换)
  • 2 =中立

有关更多信息，请参见进步的模式．

Windows Presentation Foundation (WPF)渲染

HDX 3D Pro允许在Windows多会话操作系统会话中运行的图形密集型应用程序在服务器的图形处理单元(GPU)上渲染。通过将Windows Presentation Foundation (WPF)渲染移动到服务器的GPU，图形渲染不会降低服务器的CPU速度。

要启用使用服务器的GPU渲染WPF应用程序，请在运行Windows多会话操作系统的服务器注册表中创建以下设置:

• 关键字:HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Citrix\CtxHook\ appinit_dll \多监控钩
• 值名称:EnableWPFHook
• 值类型:双字
• 值数据:00000001

有关更多信息，请参见Windows多会话操作系统的GPU加速．

多媒体

多媒体会议时避免回声

Citrix虚拟应用程序和桌面提供了一个回音取消选项，最大限度地减少任何回音。该特性在默认情况下是启用的。要禁用echo取消，您可以更改以下注册表设置之一:

• 关键:
  • 32位:HKEY_LOCAL_MACHINE \ SOFTWARE \ Citrix \ ICA端\先进发动机\ Configuration \ \ \ ClientAudio模块
  • 64位:HKEY_LOCAL_MACHINE \ SOFTWARE \ Wow6432Node \ Citrix \ ICA端\引擎\ \先进\ \ ClientAudio模块配置
• 值名称:EchoCancellation
• 值类型:双字
• 值数据:假

有关更多信息，请参见音频功能．

音频的限制

在客户端上安装音频设备、启用音频重定向并启动RDS会话后，音频文件可能无法播放音频。作为一个解决方案，在RDS机器上添加以下注册表项，然后重新启动机器:

• 关键:HKEY_LOCAL_MACHINE \ SYSTEM \ CurrentControlSet \ \ SCMConfig控制
• 值名称:EnableSvchostMitigationPolicy
• 值类型:双字
• 值数据:0

有关更多信息，请参见音频功能．

浏览器内容重定向和DPI

在用户机器上使用DPI(缩放)设置为超过100%的浏览器内容重定向时，重定向的浏览器内容屏幕显示不正确。为了避免这个问题，通过在用户的机器上创建以下注册表值禁用浏览器内容重定向GPU加速Chrome:

• 关键:HKEY_LOCAL_MACHINE \ SOFTWARE \ WOW6432Node \ Citrix \ HdxMediaStream
• 值名称:GPU
• 值类型:双字
• 值数据:0

有关更多信息，请参见浏览器内容重定向和DPI．

高清摄像头流

服务器端视频会议应用程序根据支持的格式类型选择摄像头的格式和分辨率。Citrix虚拟应用和桌面支持高达1920x1080的摄像头分辨率。要禁用和启用高清视频流，请添加以下注册表值:

• 关键:HKEY_LOCAL_MACHINE \ \ Citrix \ HDXRealTime软件
• 值名称:Enable_HighDefWebcam
• 值类型:双字
• 值数据:
  • 0 =关闭高清视频流
  • 1 =开启高清视频流

高清摄像头的分辨率

如果媒体类型协商失败，HDX返回到默认的352x288 CIF分辨率。您可以在客户端使用注册表项来配置默认解析。在设置以下注册表项之前，请确保摄像机支持指定的分辨率。

• 关键:HKEY_CURRENT_USER \ \ Citrix \ HDXRealTime软件
• 宽度
  • 值名称:DefaultWidth
  • 值类型:双字
  • 值数据:所需的十进制宽度(例如1280)
• 高度
  • 值名称:DefaultHeight
  • 值类型:双字
  • 值数据:期望的十进制高度(例如720)

高清摄像头的带宽

HDX网络摄像头视频压缩比即插即用的通用USB重定向使用更少的带宽，并且在广域网连接上工作得更好。如果需要调整带宽，请在客户端设置以下注册表值:

• 关键:HKEY_CURRENT_USER \ \ Citrix \ HDXRealTime软件
• 值名称:TargetBitrate
• 值类型:双字
• 数据的值:350000

输入以每秒位数为单位的值。如果不指定带宽，则视频会议应用默认使用350000 bps。

有关更多信息，请参见HDX网络摄像头视频压缩．

微软团队撤退模式

如果Microsoft Teams在优化的VDI模式(Teams/About/Version中的“Citrix HDX未连接”)加载失败，VDA将回到传统的HDX技术，如摄像头重定向和客户端音频和麦克风重定向。如果您使用的是不支持Microsoft Teams优化的工作区应用程序版本/平台操作系统，则不适用回退注册表项。

要控制回退机制，请在VDA上设置以下注册表值之一:

• 钥匙(只需要一个):
  • 电脑设置:微软HKEY_LOCAL_MACHINE \ SOFTWARE \ \团队
  • 用户设置:HKEY_CURRENT_USER \微软办公室\ \ \软件团队
• 值名称:DisableFallback
• 值类型:双字
• 值数据:1 =禁用回退模式，2 =只启用音频

如果该值不存在或被设置为0，则启用回退模式。此功能需要Microsoft Teams版本1.3.0.13565或更高版本。有关更多信息，请参见微软团队优化．

优化微软团队与Citrix应用程序分层

如果使用Citrix应用程序分层来管理不同层的VDA和Microsoft Teams安装，请在安装Microsoft Teams with之前在Windows上部署此注册表项ALLUSER= 1。

创建一个空的注册表项PortICA保留默认值name、type和data。

• 32位注册表编辑器:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\PortICA
• 64位注册表编辑器的键:HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\PortICA

有关更多信息，请参见微软团队优化．

用于浏览器内容重定向的集成Windows身份验证单点登录

此设置提供对与VDA相同域中配置了集成Windows身份验证(IWA)的web服务器的单点登录。要启用单点登录，请将以下注册表值设置为1:

• 关键:

  • HKEY_LOCAL_MACHINE \ \ Citrix \ HdxMediastream软件

  或

  • HKEY_LOCAL_MACHINE \ SOFTWARE \ \ Citrix \ HdxMediastream政策
• 值名称:WebBrowserRedirectionIwaSupport
• 值类型:双字
• 值数据:1

有关更多信息，请参见使用集成Windows身份验证的单点登录．

用户代理请求头

用户代理头帮助识别从浏览器内容重定向发送的HTTP请求。该设置在配置代理和防火墙规则时非常有用。例如，如果服务器阻止从浏览器内容重定向发送的请求，您可以创建一个包含用户代理头的规则来绕过某些需求。只有Windows设备支持用户代理请求头。

缺省情况下，用户代理请求头字符串是禁用的。要为客户端呈现的内容启用用户代理标头，请使用Registry编辑器。

在每个Citrix工作区应用程序的Windows客户端，设置下列注册表设置之一:

• 关键:
  • 32位:HKEY_LOCAL_MACHINE \ \ Citrix \ HdxMediaStream软件
  • 64位:HKEY_LOCAL_MACHINE \ \ WOW6432Node \ Citrix \ HdxMediaStream软件
• 值名称:EnableCefUserAgentString
• 值类型:双字
• 值数据:1

添加注册表值后，用户代理头包含CitrixBCR/2102.1文本，其中2102.1是Windows版本的Citrix Workspace应用程序。

摄像头软件压缩

如果摄像头支持硬件编码，HDX视频压缩默认使用硬件编码。硬件编码可能比软件编码消耗更多的带宽。强制软件压缩时，在客户端增加如下值:

• 关键:HKEY_CURRENT_USER \ \ Citrix \ HdxRealTime软件
• 值名称:DeepCompress_ForceSWEncode
• 值类型:双字
• 值数据:1

有关更多信息，请参见HDX网络摄像头视频压缩．

摄像头视频压缩

HDX网络摄像头视频压缩将H.264视频直接发送到虚拟会话中运行的视频会议应用程序。为了优化VDA资源，HDX网络摄像头压缩不会对网络摄像头视频进行编码、转码和解码。该特性在默认情况下是启用的。

若要禁用从服务器到视频会议应用的直接视频流，请在VDA中设置以下注册表值。

• 关键:HKEY_LOCAL_MACHINE \ \ Citrix \ HdxRealTime软件
• 值名称:OfferH264ToApp
• 值类型:双字
• 值数据:0

有关更多信息，请参见HDX网络摄像头视频压缩．

网络摄像头视频压缩帧率

若要调整首选视频帧率，请在客户端编辑以下注册表值:

• 关键:HKEY_CURRENT_USER \ \ Citrix \ HDXRealTime软件
• 值名称:FramesPerSecond
• 值类型:双字
• 值数据:15

如果摄像头不支持指定的帧率，应用程序默认使用15fps。

有关更多信息，请参见HDX网络摄像头视频压缩．