使用 URI 設定 Horizon Client

您可以使用統一資源識別碼 (URI) 建立網頁或電子郵件連結，讓使用者按一下後啟動 Horizon Client、連線至伺服器，或開啟遠端桌面平台或已發佈的應用程式。

您可以透過建構 URI 來產生這些連結，並在其中包含下列部分或全部資訊，讓您的使用者無需手動輸入。

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

若要建構 URI，請使用 horizon-client URI 配置，搭配 Horizon Client 特定路徑與查詢部分。

若要使用 URI 啟動 Horizon Client，必須先在用戶端電腦上安裝 Horizon Client。

建立 horizon-client URI 的語法

URI 語法包含 horizon-client URI 配置、用於指定遠端桌面平台或已發佈應用程式的路徑部分，以及 (選用) 用於指定遠端桌面平台或已發佈的應用程式動作或組態選項的查詢部分。

URI 規格

使用下列語法建立 URI 以啟動 Horizon Client。

horizon-client://[authority-part][/path-part][?query-part]

唯一必需的元素是 URI 配置 horizon-client。由於在某些用戶端作業系統版本中，配置名稱區分大小寫，請輸入 horizon-client。

**重要：**在所有部分中，非 ASCII 字元必須先依照 UTF-8 [STD63] 編碼，然後將對應 UTF-8 序列的每個位元組進行百分比編碼，才能作為 URI 字元來表示。

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

authority-part

伺服器位址，以及選填的使用者名稱和/或非預設的連接埠號碼。伺服器名稱中不支援使用底線 (_)。伺服器名稱必須符合 DNS 語法。

若要指定使用者名稱，請使用下列語法：
```
user1@server-address
```
您無法指定包含網域的 UPN 位址。若要指定網域，您可以使用 URI 中的 domainName 查詢部分。

若要指定連接埠號碼，請使用下列語法：
```
server-address:port-number
```
path-part

請使用遠端桌面平台顯示名稱或已發佈的應用程式顯示名稱。建立桌面平台集區或應用程式集區時，系統會在 Horizon Console 中指定顯示名稱。如果顯示名稱中包含空格，請使用 %20 編碼機制來表示該空格。

如果您指定桌面平台或應用程式識別碼，即使桌面平台或應用程式識別碼在 ADSI Edit 中包含大寫字母，仍必須僅使用小寫字母。

**附註：**多個遠端桌面平台或已發佈的應用程式可以具有相同的顯示名稱，但其桌面平台和應用程式識別碼是唯一的。若要指定特定的遠端桌面平台或已發佈的應用程式，請使用桌面平台或應用程式識別碼，而非顯示名稱。
query-part

要使用的組態選項，或要執行的遠端桌面平台或已發佈應用程式動作。查詢不區分大小寫。若要使用多項查詢條件，請在各查詢之間使用 and 符號 (&)。如果查詢發生衝突，Horizon Client 會使用清單中的最後一個查詢。使用下列語法：
```
query1=value1[&query2=value2...]
```

支援的查詢

此類型的 Horizon Client 支援以下查詢。如果您要為多種類型的用戶端 (例如桌面用戶端與行動用戶端) 建立 URI，請參閱各類用戶端系統的指南文件，以取得支援的查詢參數清單。

action

可與 action 查詢搭配使用的值
值	說明
browse	顯示指定伺服器上可用的遠端桌面平台和已發佈的應用程式清單。使用此動作時，無需指定遠端桌面平台或已發佈的應用程式。如果您使用 browse 動作，並指定遠端桌面平台或已發佈的應用程式，則該遠端桌面平台或已發佈的應用程式會在可用的項目清單中反白顯示。
start-session	開啟指定的遠端桌面平台或已發佈的應用程式。如果未提供任何 action 查詢，但有提供遠端桌面平台或已發佈的應用程式名稱，則預設動作為 start-session。
reset	關機並重新啟動指定的遠端桌面平台。尚未儲存的資料會遺失。重設遠端桌面平台等同於按下實體 PC 上的 [重設] 按鈕。不支援指定已發佈的應用程式。如果您指定已發佈的應用程式，則會出現錯誤訊息。如果您未指定遠端桌面平台或已發佈的應用程式，則 Horizon Client 會結束所有已發佈的應用程式。
restart	關機並重新啟動指定的遠端桌面平台。重新啟動遠端桌面平台的效果等同於執行 Windows 作業系統的重新啟動命令。作業系統在重新啟動前通常會提示使用者儲存尚未儲存的資料。
logoff	將使用者從遠端桌面平台中的客體作業系統登出。如果您指定的是已發佈的應用程式，該動作將會被忽略，或使用者會看到警告訊息：「URI 動作無效」。

args

指定在啟動已發佈應用程式時要附加的命令列參數。使用 args=value 的語法，其中 value 為字串。針對下列字元使用百分比編碼：
- 冒號 (:) - 使用 %3A
- 反斜線 (\) - 使用 %5C
- 空格 ( ) - 使用 %20
- 雙引號 (") - 使用 %22 例如，若要為 Notepad++ 應用程式指定檔案名稱 "My new file.txt"，請使用 %22My%20new%20file.txt%22。
appProtocol

對於已發佈的應用程式，有效的值為 PCOIP 和 BLAST。例如，若要指定 PCoIP，請使用下列語法：appProtocol=PCOIP。
defaultLaunchView

設定 Horizon Client 啟動時的預設視圖。有效值為 recent 和 servers。
desktopProtocol

對於遠端桌面平台，有效的值為 PCOIP 和 BLAST。例如，若要指定 PCoIP，請使用下列語法：desktopProtocol=PCOIP。
domainName

指定正在連線至遠端桌面平台或已發佈應用程式的使用者相關聯的 NETBIOS 網域名稱。例如，您可以使用 mycompany 而非 mycompany.com。
tokenUserName

指定 RSA 或 RADIUS 使用者名稱。唯有 RSA 或 RADIUS 使用者名稱和 Active Directory 使用者名稱不同時，才使用此查詢。如果您未指定此查詢，且需要進行 RSA 或 RADIUS 驗證，Horizon Client 會使用 Windows 使用者名稱。語法為 tokenUserName=name。
unauthenticatedAccessEnabled

如果此選項設為 true，則依預設會啟用「未驗證存取」功能。如果此選項設為 false，則會停用「未驗證存取」功能。當此選項設為 "" 時，同樣會停用「未驗證存取」功能。使用未驗證存取匿名登入選項可在 Horizon Client 設定中使用。語法範例如：unauthenticatedAccessEnabled=true。
unauthenticatedAccessAccount

若已啟用「未驗證存取」功能，則可設定要使用的帳戶。如果「未驗證存取」功能已停用，則會忽略此查詢。使用 anonymous1 使用者帳戶的語法範例如下：unauthenticatedAccessAccount=anonymous1。

horizon-client URI 範例

您可以使用 horizon-client URI 配置建立超文字連結或按鈕，並將這些連結嵌入在電子郵件或網頁中。例如，使用者可以按一下 URI 連結，以您所指定的啟動選項來啟動遠端桌面平台。

在每個 URI 範例後均會說明使用者在按下 URI 連結後會看見的情形。

範例 1

horizon-client://view.mycompany.com/Primary%20Desktop?action=start-session

Horizon Client 啟動並連線至 view.mycompany.com 伺服器。登入對話方塊會提示使用者輸入使用者名稱、網域名稱和密碼。成功登入後，用戶端會連線至顯示名稱為 Primary Desktop 的遠端桌面平台，並將使用者登入至客體作業系統。

**附註：**在此範例中，使用預設顯示通訊協定與視窗大小。預設顯示通訊協定為 PCoIP，而預設視窗大小為全螢幕。

範例 2

horizon-client://view.mycompany.com:7555/Primary%20Desktop

除了針對連線伺服器執行個體採用非預設的連接埠 7555 之外，此 URI 與先前的範例具有同樣的效果。(預設連接埠為 443。) 由於已提供遠端桌面平台識別碼，即使 URI 中未包含 start-session 動作，遠端桌面平台仍會開啟。

範例 3

horizon-client://fred@view.mycompany.com/Finance%20Desktop?desktopProtocol=PCOIP

Horizon Client 啟動並連線至 view.mycompany.com 伺服器。在登入對話方塊中，使用者名稱文字方塊會自動填入 fred。該使用者必須提供網域名稱和密碼。成功登入後，用戶端會連線至顯示名稱為 Finance Desktop 的遠端桌面平台，並將使用者登入至客體作業系統。該連線採用 PCoIP 顯示通訊協定。

範例 4

horizon-client://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST

Horizon Client 啟動並連線至 view.mycompany.com 伺服器。在登入對話方塊中，使用者必須提供使用者名稱、網域名稱和密碼。成功登入後，用戶端會連線至顯示名稱為 Calculator 的已發佈應用程式。此連線使用 Horizon Blast 顯示通訊協定。

範例 5

horizon-client://fred@view.mycompany.com/Finance%20Desktop?domainName=mycompany

Horizon Client 啟動並連線至 view.mycompany.com 伺服器。在登入對話方塊中，使用者名稱文字方塊會自動填入 fred，網域文字方塊則會自動填入 mycompany。該使用者僅必須提供密碼。成功登入後，用戶端會連線至顯示名稱為 Finance Desktop 的遠端桌面平台，並將使用者登入至客體作業系統。

範例 6

horizon-client://view.mycompany.com/

Horizon Client 啟動後，使用者會被導向連線至 view.mycompany.com 伺服器的登入提示畫面。

範例 7

horizon-client://view.mycompany.com/Primary%20Desktop?action=reset

Horizon Client 啟動並連線至 view.mycompany.com 伺服器。登入對話方塊會提示使用者輸入使用者名稱、網域名稱和密碼。成功登入後，Horizon Client 會重設指定的桌面平台。

**附註：**此動作僅在 Horizon 管理員已為遠端桌面平台啟用重設功能時可用。

範例 8

horizon-client://view.mycompany.com/Primary%20Desktop?action=restart

Horizon Client 啟動並連線至 view.mycompany.com 伺服器。登入對話方塊會提示使用者輸入使用者名稱、網域名稱和密碼。成功登入後，Horizon Client 會重新啟動指定的桌面平台。

**附註：**此動作僅在 Horizon 管理員已為遠端桌面平台啟用重新啟動功能時可用。

範例 9

horizon-client://view.mycompany.com?action=reset

Horizon Client 啟動並連線至 view.mycompany.com 伺服器。登入方塊會提示使用者輸入使用者名稱、網域名稱和密碼。登入成功後，Horizon Client 會顯示一個對話方塊，提示使用者確認是否要對所有遠端應用程式執行重設作業。

範例 10

horizon-client://

若 Horizon Client 已在執行中，則會將其帶到前景。若 Horizon Client 尚未執行，則會啟動該應用程式。

範例 11

horizon-client://?defaultlaunchview=recent

Horizon Client 啟動後，使用者會看到最近使用索引標籤。

範例 12

horizon-client://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22

在伺服器 10.10.10.10 上啟動 My Notepad++，並在已發佈的應用程式啟動命令中傳遞引數 My new file.txt。由於檔案名稱包含空格，因此會以雙引號括住。

範例 13

horizon-client://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt

在伺服器 10.10.10.10 上啟動 Notepad++ 12，並在已發佈的應用程式啟動命令中傳遞引數 a.text b.txt。由於引數未以引號括住，空格會將檔案名稱分開，因此這兩個檔案會分別在 Notepad++ 中開啟。

**附註：**已發佈的應用程式在使用命令列引數的方式上可能有所不同。例如，若您將引數 a.txt b.txt 傳遞給 WordPad，WordPad 只會開啟其中一個檔案 a.txt。

範例 14

horizon-client://view.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1

Horizon Client 啟動並使用 anonymous1 使用者帳戶連線至 view.mycompany.com 伺服器。「記事本」應用程式啟動時，系統不會提示使用者提供登入認證資訊。

HTML 程式碼範例

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

<html>
<body>

<a href="horizon-client://view.mycompany.com/Primary%20Desktop?action=start-session">Test Link</a><br>

<form><input type="button" value="TestButton" onClick="window.location.href=
'horizon-client://view.mycompany.com/Primary%20Desktop?action=start-session'"></form> <br>

</body>
</html>

此頁面對您有幫助嗎?