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