使用 URI 配置 Horizon Client

您可以使用统一资源标识符 (Uniform Resource Identifier, URI) 创建网页或电子邮件链接，最终用户可以单击这些链接启动 Horizon Client、连接到服务器，或者打开远程桌面或已发布的应用程序。

通过构建提供以下部分或所有信息的 URI 来创建链接，这样最终用户就无需再提供它。

• 服务器地址
• 服务器的端口号
• Active Directory 用户名
• 域名
• 远程桌面或已发布应用程序的显示名称
• 窗口大小
• 操作，包括重置、注销和启动会话
• 显示协议
• 用于重定向 USB 设备的选项

要构建 URI，可使用包含 Horizon Client 特定路径和查询部分的 URI 方案。

要使用 URI 启动 Horizon Client，必须已在客户端计算机上安装 Horizon Client。

用于创建 URI 的语法

URI 语法包括 URI 方案、用于指定远程桌面或已发布应用程序的路径部分，以及可选的用于指定远程桌面或已发布应用程序操作或配置选项的查询。

URI 规范

只有 URI 方案是必需的元素。对于有些客户端操作系统的某些版本，方案名称是区分大小写的。

**重要信息：**在所有部分中，必须先根据 UTF-8 [STD63] 对非 ASCII 字符进行编码，然后必须对相应 UTF-8 序列的每个八进制数进行百分比编码，以将其表示为 URI 字符的形式。

有关 ASCII 字符编码的信息，请参阅 http://www.utf8-chartable.de/ 上的 URL 编码参考。

• authority-part

  服务器地址和/或用户名（可选）及非默认端口号。服务器名称中不能使用下划线 (_)。服务器名称必须遵循 DNS 语法。

  要指定用户名，请使用以下语法。

  user1@server-address
  

  您不能指定包含域的 UPN 地址。要指定域，可以使用 URI 中的 domainName 查询部分。

  要指定端口号，请使用以下语法。

  server-address:port-number
  

• path-part

  远程桌面或已发布应用程序的显示名称。该显示名称是在 Omnissa Horizon Console 中创建桌面池或应用程序池时指定的。如果显示名称中包含空格，请使用 %20 编码机制来表示空格。

  或者，您也可以指定一个桌面 ID 或应用程序 ID，该 ID 是包含桌面池 ID 或应用程序池 ID 的路径字符串。要查找桌面 ID 或应用程序 ID，请在 Omnissa Horizon Connection Server 主机上打开“ADSI 编辑”，导航到 Horizon Connection Server 的标识命名上下文，然后选择 OU=Applications 节点。此时会列出所有桌面池和应用程序池。distinguishedName 属性指定 ID 值。在 URI 中指定 ID 值之前，必须对其进行编码。

  **注意：**多个远程桌面或已发布的应用程序可以具有相同的显示名称，但桌面 ID 和应用程序 ID 是唯一的。要指定特定的远程桌面或已发布的应用程序，请使用桌面 ID 或应用程序 ID，而不要使用显示名称。

• query-part

  要使用的配置选项，或者要执行的远程桌面或已发布应用程序操作。查询不区分大小写。要使用多个查询，请使用与号 (&) 分隔查询。如果查询之间有冲突，Horizon Client 使用列表中的最后一个查询。使用以下语法。

  query1=value1[&query2=value2...]
  

支持的查询

此类型的 Horizon Client 支持以下查询。如果要为多种类型的客户端（例如，桌面客户端和移动客户端）创建 URI，请参阅适用于每种客户端系统类型的指南文档，了解支持的查询列表。

• action

  可与 action 查询一起使用的值

  值	说明
  browse	显示指定服务器上托管的可用远程桌面和已发布应用程序的列表。使用此操作时无需指定远程桌面或已发布的应用程序。 如果使用 browse 操作并指定一个远程桌面或已发布的应用程序，则该远程桌面或已发布的应用程序会在可用项目列表中突出显示。
  start-session	打开指定的远程桌面或已发布的应用程序。如果未提供任何 action 查询，而提供了远程桌面或已发布应用程序的名称，则 start-session 为默认操作。
  reset	关闭并重新启动指定的远程桌面或已发布的应用程序。未保存的数据都会丢失。重置远程桌面与按下物理 PC 上的重置按钮相同。
  restart	关闭并重新启动指定的远程桌面。重新启动远程桌面与 Windows 操作系统重新启动命令相同。在重新启动之前，操作系统通常会提示用户保存任何未保存的数据。
  logoff	将用户从远程桌面中的客户机操作系统中注销。如果指定已发布的应用程序，则此操作会被忽略，或者最终用户会看到一条警告消息“URI 操作无效 (Invalid URI action)”。

• args

  指定要在已发布的应用程序启动时添加的命令行参数。使用语法 args=value，其中 value 是字符串。对于以下字符，使用百分号编码：

  • 对于冒号 (:)，使用 %3A
  • 对于反斜杠 (\)，使用 %5C
  • 对于空格 ( )，使用 %20
  • 对于双引号 (")，使用 %22 例如，要为 Notepad++ 应用程序指定文件名 "My new file.txt"，请使用 %22My%20new%20file.txt%22。

• appProtocol

  对于已发布的应用程序，有效值为 PCOIP 和 BLAST。例如，要指定 PCoIP，请使用 appProtocol=PCOIP 语法。

• connectUSBOnInsert

  在插入 USB 设备时，将该设备连接到前台远程桌面或已发布的应用程序。如果您为远程桌面指定了 unattended 查询，则此查询将以隐式方式设置。要使用此查询，您必须将 action 查询设置为 start-session，或者不使用 action 查询。有效值为 true 和 false。语法示例为 connectUSBOnInsert=true。

• connectUSBOnStartup

  将当前连接到客户端系统的所有 USB 设备重定向到远程桌面或已发布的应用程序。如果您为远程桌面指定了 unattended 查询，则此查询将以隐式方式设置。要使用此查询，您必须将 action 查询设置为 start-session，或者不使用 action 查询。有效值为 true 和 false。语法示例为 connectUSBOnStartup=true。

• desktopLayout

  设置显示远程桌面的窗口大小。要使用此查询，您必须将 action 查询设置为 start-session，或者不使用 action 查询。

  desktopLayout 查询的有效值

  值	说明
  fullscreen	在连接的所有外部显示器中全屏显示。这是默认值。
  windowLarge	大窗口。
  windowSmall	小窗口。
  WxH	自定义分辨率，您可以以像素为单位指定宽乘高。语法示例为 desktopLayout=1280x800。

• desktopProtocol

  对于远程桌面，有效值为 PCOIP 和 BLAST。例如，要指定 PCoIP，请使用 desktopProtocol=PCOIP 语法。

• domainName

  指定与连接到远程桌面或已发布应用程序的用户相关联的 NETBIOS 域名。例如，您可以使用 mycompany，而非 mycompany.com。

• filePath

  指定本地系统上您要使用已发布的应用程序打开的文件的路径。您可以指定完整路径或相对路径，例如，~/username/test%20file.txt。对于以下字符，使用百分号编码：

  • 对于冒号 (:)，使用 %3A
  • 对于反斜杠 (\)，使用 %5C
  • 对于空格 ( )，使用 %20 例如，要表示文件路径 /Users/username/test file.txt，请使用 /User/username/test%20file.txt。