URI 語法包括 vmware-view URI 配置、指定遠端桌面平台或已發佈應用程式的路徑部分,以及指定遠端桌面平台或已發佈的應用程式動作或組態選項的查詢 (選用)。
URI 規格
使用下列語法建立 URI 以啟動 Horizon Client。
vmware-view://[authority-part][/path-part][?query-part]
唯一所需的元素是 URI 配置,vmware-view。由於部分用戶端作業系統的某些版本會對配置名稱區分大小寫,請輸入 vmware-view。
重要: 在所有元件中,必須先依據 UTF-8 [STD63] 編碼非 ASCII 字元,然後對應的 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 編碼機制代表空格。
- query-part
-
要使用的組態選項,或是要執行的遠端桌面平台或已發佈的應用程式動作。查詢不區分大小寫。若要使用多項查詢,請在查詢之間使用 & 符號。如果查詢發生衝突,
Horizon Client 會使用清單中的最後一個查詢。請使用下列語法。
query1=value1[&query2=value2...]
支援的查詢
此類型的 Horizon Client 支援下列查詢。如果您要為多種類型的用戶端 (例如,桌面平台用戶端和行動用戶端) 建立 URI,請參閱各類用戶端系統的安裝和設定指南,以取得支援的查詢清單。
- 動作
-
表 1. 能與 action 查詢搭配使用的值 值 說明 browse 顯示指定的伺服器上主控的可用遠端桌面平台和已發佈的應用程式清單。使用此動作時,您不需要指定遠端桌面平台或已發佈的應用程式。 如果您使用 browse 動作,並指定遠端桌面平台或已發佈的應用程式,則該遠端桌面平台或已發佈的應用程式會在可用的項目清單中反白顯示。
start-session 開啟指定的遠端桌面平台或已發佈的應用程式。如果未提供任何動作查詢,且提供了遠端桌面平台或已發佈的應用程式名稱,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 查詢。
表 2. desktopLayout 查詢的有效值 值 說明 fullscreen 在所有連接的外接監視器上全螢幕顯示。此值為預設值。 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。