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

URI 规范

创建 URI 时,实际是将完整的 Horizon URI 字符串作为参数来调用 vmware-view

使用以下语法来创建用于启动 Horizon Client 的 URI。

vmware-view://[authority-part][/path-part][?query-part]

只有 URI 方案 vmware-view 是必需的元素。由于对于某些客户端操作系统的某些版本,方案名称区分大小写,因此请键入 vmware-view

重要事项: 在所有部分中,必须先根据 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
远程桌面或已发布应用程序的显示名称。该显示名称是在 Horizon Console 中创建桌面池或应用程序池时指定的。如果显示名称中包含空格,请使用 %20 编码机制来表示空格。
或者,您也可以指定一个桌面 ID 或应用程序 ID,该 ID 是包含桌面池 ID 或应用程序池 ID 的路径字符串。要查找桌面 ID 或应用程序 ID,请在连接服务器主机上打开“ADSI 编辑”,导航到 DC=vdi,dc=vmware,dc=int,然后选择 OU=Applications 节点。此时会列出所有桌面池和应用程序池。 distinguishedName 属性指定 ID 值。在 URI 中指定 ID 值之前,必须对其进行编码,例如, cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint
注: 多个远程桌面或已发布的应用程序可以具有相同的显示名称,但桌面 ID 和应用程序 ID 是唯一的。要指定特定的远程桌面或已发布的应用程序,请使用桌面 ID 或应用程序 ID,而不要使用显示名称。
query-part
要使用的配置选项,或者要执行的远程桌面或已发布应用程序操作。查询不区分大小写。要使用多个查询,请使用 & 符号分隔查询。如果查询之间有冲突, Horizon Client 使用列表中的最后一个查询。使用以下语法。
query1=value1[&query2=value2...]

支持的查询

此类型的 Horizon Client 支持以下查询。如果要为多种类型的客户端(例如,桌面客户端和移动客户端)创建 URI,请参阅针对每种客户端系统类型的安装和设置指南,了解受支持的查询列表。

action
表 1. 可与 action 查询一起使用的值
说明
browse 显示指定服务器上托管的可用远程桌面和已发布应用程序的列表。使用此项操作时无需指定远程桌面或已发布应用程序。
start-session 打开指定的远程桌面或已发布的应用程序。如果未提供任何操作查询以及远程桌面名称或已发布应用程序名称,则 start-session 为默认操作。
reset

关闭并重新启动指定的远程桌面或已发布的应用程序。未保存的数据都会丢失。重置远程桌面与按下物理 PC 上的重置按钮相同。

restart 关闭并重新启动指定的远程桌面。重新启动远程桌面与 Windows 操作系统重新启动命令相同。在重新启动之前,操作系统通常会提示用户保存任何未保存的数据。
logoff 将用户从远程桌面中的客户机操作系统中注销。如果指定已发布的应用程序,则此操作被忽略,或者最终用户看到一条警告消息“URI 操作无效”。
args
指定要在已发布的应用程序启动时添加的命令行参数。使用语法 args= value,其中 value 是字符串。对于以下字符,使用百分号编码:
  • 对于冒号 (:),使用 %3A
  • 对于反斜杠 (\),使用 %5C
  • 对于空格 ( ),使用 %20
  • 对于双引号 ("),使用 %22

例如,要为 Notepad++ 应用程序指定 "My new file.txt" 文件名,请使用 %22My%20new%20file.txt%22

appProtocol
对于已发布的应用程序,有效值为 PCOIPBLAST。例如,要指定 PCoIP,请使用 appProtocol=PCOIP 语法。
desktopLayout
设置远程桌面窗口的大小。要使用此查询,您必须将 action 查询设置为 start-session,或者不使用 action 查询。
表 2. desktopLayout 查询的有效值
说明
fullscreen 在一个显示器中全屏显示。该值是默认值。
multimonitor 在多个显示器中全屏显示。
windowLarge 大窗口。
windowSmall 小窗口。
WxH 自定义分辨率,您可以以像素为单位指定宽乘高。举例说明该语法:desktopLayout=1280x800
desktopProtocol
对于远程桌面,有效值为 RDPPCOIPBLAST。例如,要指定 PCoIP,请使用 desktopProtocol=PCOIP 语法。
domainName
指定与连接到远程桌面或已发布应用程序的用户相关联的 NETBIOS 域名。例如,您可以使用 mycompany,而非 mycompany.com
launchMinimized
以最小化模式启动 Horizon Client。在启动用户指定的远程桌面或已发布的应用程序时, Horizon Client 窗口保持最小化并隐藏在后台。语法为 launchMinimized=true。默认值为 false
useExisting
如果此选项设置为 true,则只能运行一个 Horizon Client 实例。如果用户尝试连接到第二个服务器,必须先注销第一个服务器,以断开与远程桌面和已发布应用程序会话的连接。如果此选项设置为 false,则可运行多个 Horizon Client 实例,并且用户可以在同时连接到多个服务器。默认值是 true。示例语法为 useExisting=false
unauthenticatedAccessEnabled
如果将此选项设置为 true,那么“未验证访问”功能将默认启用。用户界面的 使用未验证访问匿名登录选项为可见状态并且已经选中。如果将此选项设置为 false,那么“未验证访问”功能将被禁用。 使用未验证访问匿名登录设置为隐藏状态且被禁用。如果将此选项设置为 "",则禁用未验证访问功能,并且 使用未验证访问匿名登录设置在用户界面中处于可见状态并取消选中。举例说明该语法: unauthenticatedAccessEnabled=true
unauthenticatedAccessAccount
如果“未验证访问”功能处于启用状态,则设置要使用的帐户。如果禁用了“未经身份验证的访问”,那么此查询将被忽略。使用 anonymous1 用户帐户的语法示例: unauthenticatedAccessAccount=anonymous1