使用 URI 設定 HTML Access Web Client

您可以使用統一資源識別碼 (URI) 來建立使用者的 Web 或電子郵件連結。使用者可以按一下這些連結以啟動 HTML Access、連線至伺服器，以及啟動具有特定組態選項的遠端桌面平台或已發佈的應用程式。

您藉由建構 URI 的方式來建立這些連結以提供下列一些或全部資訊，因此使用者便無須提供。

伺服器位址
伺服器的連接埠號碼
Active Directory 使用者名稱
RADIUS 或 RSA SecurID 使用者名稱 (若與 Active Directory 使用者名稱不同時)
網域名稱
遠端桌面平台或已發佈的應用程式顯示名稱
動作包括瀏覽、重設、登出和啟動工作階段

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

webviewMode

此選項設定為 true 時，遠端工作階段會以 webview 模式啟動。在 webview 模式下會隱藏 HTML Access 側邊列。Webview 模式還可讓某些第三方行動應用程式執行下列動作：

將事件從軟體鍵盤傳送至遠端桌面平台
在 HTML Access 中，使用行動應用程式介面在原生觸控模式和觸控板觸控模式之間切換

URI 語法範例

下列每個 URI 範例後均會說明使用者在按下 URI 連結後會看見的情形。查詢不區分大小寫，例如，您可以使用 domainName 或 domainname。

```
https://horizon.mycompany.com/?domainName=finance&userName=fred
```
HTML Access 會啟動並連線至 horizon.mycompany.com 伺服器。在登入方塊中，使用者名稱文字方塊會填入名稱 Fred，網域文字方塊會填入財務。該使用者僅必須提供密碼。
```
https://horizon.mycompany.com/?userName=finance%5Cfred
```
HTML Access 會啟動並連線至 horizon.mycompany.com 伺服器。在登入方塊中，使用者名稱文字方塊填入了名稱 finance\fred。該使用者僅必須提供密碼。
```
https://horizon.mycompany.com/?userName=fred@finance
```
HTML Access 會啟動並連線至 horizon.mycompany.com 伺服器。在登入方塊中，使用者名稱文字方塊填入了名稱 fred@finance。該使用者僅必須提供密碼。
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=start-session
```
HTML Access 會啟動並連線至 horizon.mycompany.com 伺服器。登入方塊會提示使用者輸入使用者名稱、網域名稱和密碼。成功登入之後，用戶端會連線至顯示名稱為主要桌面平台的遠端桌面平台，且使用者會登入客體作業系統。
```
https://horizon.mycompany.com/?applicationId=Notepad&action=start-session
```
HTML Access 會啟動並連線至 horizon.mycompany.com 伺服器。登入方塊會提示使用者輸入使用者名稱、網域名稱和密碼。成功登入之後，將會啟動「記事本」應用程式。
```
https://horizon.mycompany.com:7555/?desktopId=Primary%20Desktop
```
除了針對伺服器採用非預設的連接埠 7555 之外，此 URI 與先前的範例具有同樣的效果。預設連接埠為 443。由於提供了遠端桌面平台識別碼，儘管 URI 中並未包含 start-session 動作，遠端桌面平台仍會啟動。
```
https://horizon.mycompany.com/?applicationId=Primary%20Application&desktopId=Primary%20Desktop
```
此 URI 會同時指定已發佈的應用程式和遠端桌面平台。當您同時指定已發佈的應用程式和遠端桌面平台時，將只會啟動遠端桌面平台。
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=reset
```
HTML Access 會啟動並連線至 horizon.mycompany.com 伺服器。登入方塊會提示使用者輸入使用者名稱、網域名稱和密碼。成功登入後，該用戶端會顯示對話方塊，提示使用者確認主要桌面平台的重設作業。

備註：只有在管理員已允許使用者重設其機器時，才能使用此動作。
```
https://horizon.mycompany.com/?My%20Notepad++?args=%22My%20new%20file.txt%22
```
在伺服器 horizon.mycompany.com 上開啟 My Notepad++，並將引數 My new file.txt 傳遞至應用程式啟動命令中。由於檔案名稱包含空格，因此會以雙引號括住。
```
https://horizon.mycompany.com/?Notepad++%2012?args=a.txt%20b.txt
```
在伺服器 horizon.mycompany.com 上開啟 Notepad++ 12，並將引數 a.text b.txt 傳遞至應用程式啟動命令中。由於引數未以雙引號括住，因此會以空格分隔多個檔案名稱，且兩個檔案會在 Notepad++ 中個別開啟。

備註：應用程式在使用命令列引數的方式上可能有所不同。例如，如果您將引數 a.txt b.txt 傳遞至 WordPad，WordPad 將只會開啟一個 a.txt 檔案。
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=restart
```
HTML Access 會啟動並連線至 horizon.mycompany.com 伺服器。登入方塊會提示使用者輸入使用者名稱、網域名稱和密碼。成功登入後，該用戶端會顯示對話方塊，提示使用者確認主要桌面平台的重新啟動作業。

備註：只有在管理員已允許使用者重新啟動其機器時，才能使用此動作。

https://horizon.mycompany.com/?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous_user1

HTML Access 會啟動，並使用 anonymous_user1 帳戶連線至 horizon.mycompany.com 伺服器。

HTML 程式碼範例

您可以使用 URI 建立超文字連結和按鈕，並加入至電子郵件或網頁中。以下範例顯示如何使用第一個 URI 範例中的 URI，針對名稱為測試連結的超文字連結和名稱為測試按鈕的按鈕進行編碼。

<html>
<body>

<a href="https://horizon.mycompany.com/?domainName=finance&userName=fred">Test Link</a><br>

<form><input type="button" value="TestButton" onClick="window.location.href=
'https://horizon.mycompany.com/?domainName=finance&userName=fred'"></form> <br>

</body>
</html>