語法包括指定伺服器的路徑部分，以及選擇性地指定使用者、遠端桌面平台或已發佈應用程式和動作或組態選項的查詢。

URI 規格

使用下列語法建立 URI，以啟動 HTML Access： 

https://authority-part[/?query-part]
authority-part
指定伺服器位址或者選擇指定非預設連接埠號碼。伺服器名稱必須符合 DNS 語法。

若要指定連接埠號碼，請使用下列語法： 

server-address:port-number
query-part
指定要使用的組態選項或要執行的動作。查詢不區分大小寫。若要使用多項查詢，請在查詢之間使用 & 符號。如果查詢彼此衝突，即使用清單中最後一項查詢。使用下列語法： 
query1=value1[&query2=value2...]

建立查詢部分時，請遵循下列準則：

  • 如果未使用至少其中一項受支援的查詢，則會出現預設 VMware Horizon Web 入口網站頁面。
  • 查詢部分不支援某些特殊字元，因此您必須使用這些字元的 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 所支援的查詢。如果您正為多種類型的用戶端建立 URI，如桌面平台用戶端和行動用戶端，請參閱各種用戶端系統所適用的安裝和設定文件。

動作
表 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