建立 horizon-client URI 的語法

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

URI 規格

使用下列語法來建立啟動 Omnissa Horizon Client 的 URI。

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，導覽至指定的 Horizon Connection Server，並選取 OU=Applications 節點。此時會列出所有的桌面平台和應用程式集區。distinguishedName 屬性會指定識別碼值。您必須先對識別碼值進行編碼，再將其指定於 URI 中。

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

• query-part

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

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

支援的查詢

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

• action

  可用於 action 查詢的值

  值	說明
  browse	顯示指定伺服器上可用的遠端桌面平台和已發佈的應用程式清單。使用此動作時，無需指定遠端桌面平台或已發佈的應用程式。 如果您使用 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

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

• domainName

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

• filePath

  指定您要以已發佈的應用程式開啟的檔案在本機系統上的路徑。您可以指定完整路徑或相對路徑，例如 ~/username/test%20file.txt。針對下列字元使用百分比編碼：

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