使用 URI 設定 Horizon Windows Client

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

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

• 伺服器位址
• 伺服器的連接埠號碼
• Active Directory 使用者名稱
• RADIUS 或 RSA SecurID 使用者名稱 (若與 Active Directory 使用者名稱不同時)
• 網域名稱
• 遠端桌面平台或已發佈的應用程式顯示名稱
• 視窗大小
• 動作包括重設、登出和啟動工作階段
• 顯示通訊協定
• 重新導向 USB 裝置的選項

若要建構 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

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

  或者，您可以指定桌面平台或應用程式識別碼，這是包含桌面平台或應用程式集區識別碼的路徑字串。若要尋找桌面平台或應用程式識別碼，請在 Omnissa Horizon Connection Server 主機上開啟 ADSI Edit 並找到適當的 DC 路徑，然後選取 OU=Applications 節點。此時會列出所有的桌面平台和應用程式集區。distinguishedName 屬性會指定識別碼值。您必須先對識別碼值進行編碼，再將其指定於 URI 中。

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

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

• query-part

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

  query1=value1[&query2=value2...]
  

支援的查詢

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

• action

  可與 action 查詢搭配使用的值

  值	說明
  browse	顯示指定伺服器上可用的遠端桌面平台和已發佈的應用程式清單。使用此動作時，無需指定遠端桌面平台或已發佈的應用程式。
  start-session	開啟指定的遠端桌面平台或已發佈的應用程式。如果未提供任何 action 查詢，但有提供遠端桌面平台或已發佈的應用程式名稱，則預設動作為 start-session。
  reset	關機並重新啟動指定的遠端桌面平台或已發佈的應用程式。尚未儲存的資料會遺失。重設遠端桌面平台等同於按下實體 PC 上的 [重設] 按鈕。
  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。

• connectUSBOnInsert

  當您插入 USB 裝置時，會將該裝置連接至目前在前景的遠端桌面平台或已發佈的應用程式。如果您為遠端桌面平台指定 unattended 查詢，則會隱含地設定此查詢。若要使用此查詢，您必須將 action 查詢設定為 start-session，或完全不設定 action 查詢。有效值為 true 和 false。語法範例如：connectUSBOnInsert=true。

• connectUSBOnStartup

  將目前連線至用戶端系統的所有 USB 裝置重新導向至遠端桌面平台或已發佈的應用程式。如果您為遠端桌面平台指定 unattended 查詢，則會隱含地設定此查詢。若要使用此查詢，您必須將 action 查詢設定為 start-session，或完全不設定 action 查詢。有效值為 true 和 false。語法範例如：connectUSBOnStartup=true。

• desktopLayout

  設定遠端桌面平台視窗的大小。若要使用此查詢，您必須將 action 查詢設定為 start-session，或不設定 action 查詢。

  desktopLayout 查詢的有效值

  值	說明
  fullscreen	在一台監視器上全螢幕顯示。此值為預設值。
  multimonitor	在所有監視器上全螢幕顯示。
  windowLarge	大視窗。
  windowSmall	小視窗。
  WxH	自訂解析度，您可指定寬度與高度 (以像素為單位)。語法範例如：desktopLayout=1280x800。

• desktopProtocol

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

• domainName

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

• filePath

  指定您要以已發佈的應用程式開啟的檔案在本機系統上的路徑。您必須指定完整路徑，包括磁碟機代號在內。針對下列字元使用百分比編碼：

  • 冒號 (:) - 使用 %3A
  • 反斜線 (\) - 使用 %5C
  • 空格 ( ) - 使用 %20 例如，若要表示檔案路徑 C:\test file.txt，請使用 C%3A%5Ctest%20file.txt。

• launchMinimized

  以最小化模式啟動 Horizon Client。Horizon Client 將維持最小化狀態，直到指定的遠端桌面平台或已發佈的應用程式啟動為止。語法為 launchMinimized=true。此查詢無法與 unattended 查詢搭配使用。

• tokenUserName

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

• unattended

  在 Kiosk 模式中建立伺服器與遠端桌面平台的連線。如果您使用此查詢，則從用戶端裝置的 MAC 位址產生帳戶名稱時，請勿指定使用者資訊。如果您已在 ADAM 中建立自訂帳戶名稱 (如開頭為「custom-」的名稱)，則必須指定帳戶資訊。

• useExisting

  設定 -useExisting 參數可讓您控制是否可同時執行多個 Horizon Client 執行個體。設定此參數後，Horizon Client 會在啟動新工作階段前提示關閉任何現有工作階段，以維持單一執行個體。

  設定 -useExisting 參數後，您會收到提示以使用單一用戶端執行個體。隨即會顯示一則訊息，提示您從現有執行個體登出。然後在您接受後，新的執行個體便會開啟。

  如果未設定 -useExisting 參數，會開啟新的用戶端執行個體。

  範例： <IP>?useExisting=true 或 <IP>?useExisting=false 將您指定的 IP 插入至顯示 IP 的位置。

• unauthenticatedAccessEnabled

  如果此選項設為 true，則依預設會啟用「未驗證存取」功能。未驗證存取選項會顯示在使用者介面中，且處於已選取狀態。如果此選項設為 false，則會停用「未驗證存取」功能。未驗證存取設定會隱藏並停用。此選項設為空字串 ("") 時，「未驗證存取」功能將會停用，且未驗證存取設定會自使用者介面中隱藏並停用。語法範例如：unauthenticatedAccessEnabled=true。

• unauthenticatedAccessAccount

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

horizon-client URI 範例

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

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

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

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

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

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

此 URI 的效果與先前的範例相同，差別在於它使用非預設的連接埠 7555 來連線至 Horizon Connection Server 執行個體。(預設連接埠為 443。) 由於已提供遠端桌面平台識別碼，即使 URI 中未包含 start-session 動作，遠端桌面平台仍會開啟。

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

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

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

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

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

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

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

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

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

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

**附註：**僅當管理員已啟用遠端桌面平台的重設功能時，此動作才可使用。

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

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

**附註：**僅當管理員已啟用遠端桌面平台的重新啟動功能時，此動作才可使用。

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

此 URI 和第一個範例具有同樣的效果，並會將連線到用戶端系統的所有 USB 裝置重新導向至遠端桌面平台。

horizon-client://

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

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

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

您也可以使用下列語法，在 Windows 命令列提示字元中輸入此命令：

horizon-client.exe --serverURL 10.10.10.10 --appName "My Notepad++" --args ""my new.txt""

在此範例中，雙引號會使用字元 \" 的方式逸出。

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。

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

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

HTML 程式碼範例

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

<html>
<body>

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

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

</body>
</html>