Citrix Virtual Apps and Desktops

通过注册表管理的 HDX 功能

注意:

注册表编辑不当会导致严重问题,可能需要重新安装操作系统。Citrix 无法保证因注册表编辑器使用不当导致出现的问题能够得以解决。使用注册表编辑器需自担风险。在编辑注册表之前,请务必进行备份。

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

设备

Bloomberg 键盘

Citrix Virtual Apps and Desktops 支持 Bloomberg 4 型和 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 上启动会话时生效。

常规

配置 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 发现,请配置以下注册表值并重新启动 VDA。

  • 注册表项:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd
  • 值名称:MtuDiscovery
  • 值类型:DWORD
  • 值数据:0

此设置在计算机范围内适用,影响从受支持的客户端连接的所有会话。

启用丢失容忍模式

可以使用面向适用于 Windows 的 Citrix Workspace 应用程序、多用户 VDA 和桌面 VDA 的双向音频服务的丢失容忍模式访问自适应音频。默认情况下,此设置处于禁用状态。要启用丢失容忍模式,请根据您使用的计算机来配置以下注册表值并重新启动相应的计算机。

对于适用于 Windows 客户端的 Citrix Workspace 应用程序,

  • 注册表项:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ClientAudio
  • 值名称:EdtUnreliableAllowed
  • 值类型:REG_SZ
  • 值数据:1

对于 TS VDA,

  • 注册表项:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\Audio
  • 值名称:EdtUnreliableAllowed
  • 值类型:DWORD
  • 值数据:1

对于 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

有关详细信息,请参阅客户端文件夹重定向

面向一组特定 Web 站点的主机到客户端重定向

要为一组特定的 Web 站点启用主机到客户端重定向,请在服务器 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
  • 值名称:会话状态
  • 值类型:DWORD
  • 值数据:
    • 1 - 当用户从虚拟桌面注销或断开连接时,本地应用程序继续运行。一旦重新建立连接,如果本地应用程序在虚拟桌面中可用,将重新集成。
    • 3 - 当用户从虚拟桌面注销或断开连接时,本地应用程序关闭。

有关详细信息,请参阅本地应用程序访问和 URL 重定向

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

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

  • 注册表项:HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA

  • 值名称:DisableServerFTA
  • 值类型:DWORD
  • 值数据:1

  • 值名称:NoRedirectClasses
  • 值类型:REG_MULTI_SZ
  • 值数据:指定以下值的任意组合:httphttpsrtsprtspupnmmms。在单独的行中输入多个值。例如:

http

https

rtsp

有关详细信息,请参阅主机到客户端重定向

服务器 VDA 默认浏览器配置

可以启用主机到客户端重定向以取代服务器 VDA 上的任何默认浏览器配置。如果未重定向 Web URL,Citrix Launcher 会将 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"

面向已发布应用程序的本地应用访问

本地应用程序访问可将本地安装的 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 多会话操作系统的服务器的注册表中创建以下设置:

  1. 在 VDA 上打开注册表编辑器并导航到以下注册表项:

    HKLM\Software\Citrix\CtxHook\AppInit_DLLs\Graphics Helper

  2. 创建或编辑以下注册表值:

    • [REG_DWORD] AdapterHandle = 0x00000001
    • [REG_DWORD] DevicePath = 0x00000001
    • [REG_DWORD] Flag = 0x00000412
    • [REG_DWORD] WPF = 0x00000001
  3. 使用您的 WPF 应用程序的可执行文件名称创建一个子项。例如,如果您的应用程序名为“mywpfapp.exe”,请创建以下注册表项:

    HKLM\Software\Citrix\CtxHook\AppInit_DLLs\Graphics Helper\mywpfapp.exe

  4. 重新启动服务器以使设置生效。

有关详细信息,请参阅适用于 Windows 多会话操作系统的 GPU 加速和关于 Getting the best out of WPF apps on Windows multi-session OS(在 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
  • 值名称:EchoCancellation
  • 值类型:String/REG_SZ
  • 值数据:False

有关详细信息,请参阅音频功能

音频限制

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

  • 注册表项:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SCMConfig
  • 值名称:EnableSvchostMitigationPolicy
  • 值类型:DWORD
  • 值数据:0

有关详细信息,请参阅音频功能

浏览器内容重定向和 DPI

在用户的计算机上使用浏览器内容重定向时,如果 DPI(缩放)设置为超过 100% 的任何设置,则无法正确显示重定向的浏览器内容屏幕。为避免出现此问题,请通过在用户的计算机上创建以下注册表值来禁用 Chrome 的浏览器内容重定向 GPU 加速:

  • 注册表项:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\HdxMediaStream
  • 值名称:GPU
  • 值类型:DWORD
  • 值数据:0

有关详细信息,请参阅浏览器内容重定向和 DPI

高清网络摄像机分辨率

如果媒体类型协商失败,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 技术,例如网络摄像机重定向以及客户端音频和麦克风重定向。如果您使用的是不支持 Microsoft Teams 优化的 Workspace 应用程序版本/平台操作系统,则不应用回退注册表项。

要控制回退机制,请在 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 安装,请先在 Windows 上创建一个名为 PortICA 的空注册表项,然后在命令行中使用 ALLUSER=1 标志安装 Microsoft Teams。请保留默认值名称、类型和数据。

  • 注册表编辑器 32 位版本的密钥:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\PortICA
  • 注册表编辑器 64 位版本的密钥:HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\PortICA

有关详细信息,请参阅 Microsoft Teams 优化

使用集成 Windows 身份验证进行单点登录,以实现浏览器内容重定向

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

  • 注册表项:

    • HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\HdxMediastream

    • HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Citrix\HdxMediastream
  • 值名称:WebBrowserRedirectionIwaSupport
  • 值类型:DWORD
  • 值数据:1

有关详细信息,请参阅使用集成 Windows 身份验证进行单点登录

用户代理请求标头

用户代理标头有助于识别从浏览器内容重定向发送的 HTTP 请求。配置代理和防火墙规则时,此设置会非常有用。例如,如果服务器阻止从浏览器内容重定向发送的请求,则可以创建包含用户代理标头的规则以绕过某些要求。只有 Windows 设备支持用户代理请求标头。

默认情况下,用户代理请求标头字符串处于禁用状态。要为客户端呈现的内容启用用户代理标头,请使用注册表编辑器。

在每个适用于 Windows 的 Citrix Workspace 应用程序客户端上,设置下面其中一项注册表设置:

  • 注册表项:
    • 32 位:HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\HdxMediaStream
    • 64 位:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\HdxMediaStream
  • 名称名称:EnableCefUserAgentString
  • 值类型:DWORD
  • 值数据:1

添加注册表值后,用户代理标头将包含 CitrixBCR/2102.1 文本,其中 2102.1 为适用于 Windows 的 Citrix Workspace 应用程序版本。

网络摄像机软件压缩

如果网络摄像机支持硬件编码,默认情况下 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 网络摄像机视频压缩

通过注册表管理的 HDX 功能