语法包括用于指定服务器的路径部分,还包括(可选)用于指定用户、桌面或应用程序以及操作或配置选项的查询。

URI 规范

使用下面的语法来创建用于启动 HTML Access Web Client 的 URI:

https://authority-part[/?query-part]

authority-part

指定服务器地址,也可以指定非默认端口号。服务器名称必须遵循 DNS 语法。

要指定端口号,请使用下面的语法:

server-address:port-number

query-part

指定要使用的配置选项或要执行的操作。查询不区分大小写。要使用多个查询,请使用 & 符号分隔查询。如果查询之间相互冲突,则以列表中的最后一项查询为准。使用以下语法:

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

创建查询部分时,请遵循以下原则:

  • 如果不使用至少一个支持的查询,将显示默认的 VMware Horizon Web 门户页面。

  • 在查询部分中,不支持某些特殊字符,因此您必须对这些字符使用 URL 编码格式,例如:使用 %23 表示井号 (#),使用 %25 表示百分号 (%),使用 %26 表示 & 符号,使用 %40 表示 @ 符号,使用 %5C 表示反斜杠 (\)。

    有关 URL 编码的更多信息,请转至 http://www.w3schools.com/tags/ref_urlencode.asp

  • 查询部分中所有的非 ASCII 字符都必须先根据 UTF-8 [STD63] 进行编码,然后相应 UTF-8 序列的每个八进制数都必须进行百分比编码,以 URI 字符的形式显示。

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

支持的查询

本主题列出了 HTML Access Web client 支持的查询。如果要为多种类型的客户端(例如,桌面客户端和移动客户端)创建 URI,请参阅适用于每种类型的客户端系统的《使用 VMware Horizon Client文档。

action

表 1. 可与 action 查询一起使用的值

说明

browse

显示指定服务器上托管的可用桌面和应用程序的列表。使用此项操作时无需指定桌面或应用程序。

start-session

启动指定的桌面或应用程序。如果未提供任何操作查询以及桌面名称或应用程序名称,则 start-session 为默认操作。

reset

关闭并重新启动指定的桌面。未保存的数据都会丢失。重置远程桌面相当于按下物理 PC 上的重置按钮。此操作对于应用程序无效。

logoff

将用户从远程桌面中的客户机操作系统中注销。此操作对于应用程序无效。

restart

在用户确认重新启动操作请求后,关闭并重新启动主桌面。此操作对于应用程序无效。

applicationId

应用程序显示名称。该显示名称是在创建应用程序池时在 Horizon Administrator 中指定的名称。如果显示名称中包含空格,浏览器将使用 %20 来表示空格。

args

指定命令行参数以添加到远程应用程序启动中。使用语法 args=value,其中 value 是字符串。对于以下字符,使用百分号编码:

  • 对于冒号 (:),使用 %3A

  • 对于反斜杠 (\),使用 %5C

  • 对于空格 ( ),使用 %20

  • 对于双引号 ("),使用 %22

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

desktopId

桌面显示名称。此显示名称是创建桌面池时在 View Administrator 中指定的名称。如果显示名称中包含空格,浏览器将使用 %20 来表示空格。

domainName

与连接到远程桌面或应用程序的用户相关联的 NETBIOS 域名。例如,使用 mycompany,而非 mycompany.com

tokenUserName

RSA 或 RADIUS 用户名。只有在 RSA 或 RADIUS 用户名与 Active Directory 用户名不同时,才使用此查询。如果未指定此查询且需要 RSA 或 RADIUS 身份验证,则使用 Windows 用户名。

userName

连接到远程桌面或应用程序的 Active Directory 用户。用户名可以采用以下格式之一:

  • userName

  • domainName%5CuserName

  • 用户主体名称 (UPN),即 userName@domainName

unauthenticatedAccessEnabled

如果将此选项设置为 true,那么“未经身份验证的访问”功能将默认启用。HTML Access Web client 将会启动,并且显示匿名用户帐户。举例说明该语法:unauthenticatedAccessEnabled=true

unauthenticatedAccessAccount

如果启用了“未经身份验证的访问”功能,请设置要使用的帐户。如果禁用了“未经身份验证的访问”,那么此查询将被忽略。使用 anonymous1 用户帐户的语法示例:unauthenticatedAccessAccount=anonymous1