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

URI 规范

使用以下语法来创建用于启动 HTML Access 的 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 支持的查询。如果要为多种类型的客户端(例如,桌面客户端和移动客户端)创建 URI,请参阅适用于每种类型的客户端系统的安装和设置文档。

action
表 1. 可与 action 查询一起使用的值
说明
browse 显示指定服务器上托管的可用远程桌面和已发布应用程序的列表。使用此项操作时无需指定远程桌面或已发布的应用程序。
start-session 启动指定的远程桌面或已发布的应用程序。如果未提供任何操作查询以及远程桌面名称或已发布应用程序名称,则 start-session 为默认操作。
reset 关闭并重新启动指定的远程桌面。未保存的数据都会丢失。重置远程桌面相当于按下物理 PC 上的重置按钮。此操作对于已发布的应用程序无效。
logoff 将用户从远程桌面中的客户机操作系统中注销。此操作对于已发布的应用程序无效。
restart 在用户确认重新启动操作请求后,关闭并重新启动主远程桌面。此操作对于已发布的应用程序无效。
applicationId
已发布的应用程序的显示名称。该显示名称是创建应用程序池时在 Horizon Console 中指定的名称。如果显示名称包含空格,浏览器将使用 %20 来表示空格。
args
指定要在启动已发布的应用程序时添加的命令行参数。使用语法 args= value,其中 value 是字符串。对于以下字符,使用百分号编码:
  • 对于冒号 (:),使用 %3A
  • 对于反斜杠 (\),使用 %5C
  • 对于空格 ( ),使用 %20
  • 对于双引号 ("),使用 %22

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

desktopId
远程桌面的显示名称。该显示名称是创建桌面池时在 Horizon Console 中指定的名称。如果显示名称包含空格,浏览器将使用 %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 将会启动,并且显示匿名用户帐户。举例说明该语法: unauthenticatedAccessEnabled=true
unauthenticatedAccessAccount
如果启用了“未经身份验证的访问”功能,请设置要使用的帐户。如果禁用了“未经身份验证的访问”,那么此查询将被忽略。使用 anonymous1 用户帐户的语法示例: unauthenticatedAccessAccount=anonymous1