語法包括路徑部分 (用以指定伺服器) 和查詢 (可選用,用以指定使用者、桌面平台或應用程式,以及動作或組態選項)。

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 入口網頁。

  • 查詢部分不支援某些特殊字元,因此您必須使用這些字元的 URL 編碼格式,如下所示:對於井字符號 (#),請使用 %23;對於百分比符號 (%),請使用 %25;對於 and 符號 (&),請使用 %26;對於 at 符號 (@),請使用 %40;對於反斜線 (\),請使用 %5C

    如需有關 URL 編碼的詳細資訊,請前往 http://www.w3schools.com/tags/ref_urlencode.asp

  • 在查詢部分中,必須先根據 UTF-8 [STD63] 編碼非 ASCII 字元,然後對應的 UTF-8 序列的每八位元必須進行百分比編碼以顯示為 URI 字元。

    如需有關 ASCII 字元的編碼資訊,請參閱 URL 編碼參考,網址為 http://www.utf8-chartable.de/

支援的查詢

此主題會列出 HTML Access Web client 支援的查詢。如果您正為多種類型的用戶端建立 URI,如桌面平台用戶端和行動用戶端,請參閱各種用戶端系統所適用的《使用 VMware Horizon Client文件。

動作

表格 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