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 顯示指定的伺服器上主控的可用遠端桌面平台和已發佈的應用程式清單。使用此動作時,您不需要指定遠端桌面平台或已發佈的應用程式。 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 一台監視器上全螢幕顯示。此值為預設值。 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。您無法透過 自動查詢來使用此查詢。
- tokenUserName
- 指定 RSA 或 RADIUS 使用者名稱。唯有 RSA 或 RADIUS 使用者名稱和 Active Directory 使用者名稱不同時,才使用此查詢。如果您未指定此查詢,但需要進行 RSA 或 RADIUS 驗證,則 Horizon Client 會使用 Windows 使用者名稱。語法是 tokenUserName=name。
- unattended
- 在 Kiosk 模式中建立伺服器與遠端桌面平台的連線。如果您使用此查詢,則從用戶端裝置的 MAC 位址產生帳戶名稱時,請勿指定使用者資訊。如果您已在 ADAM 中建立自訂帳戶名稱 (如開頭為「custom-」的名稱),則必須指定帳戶資訊。
- useExisting
- 如果此選項設定為 true,則只能執行一個 Horizon Client 執行個體。如果使用者嘗試連線至第二個伺服器,他們必須先登出第一個伺服器,而造成遠端桌面平台和已發佈的應用程式工作階段中斷連線。如果此選項設定為 false,則可執行多個 Horizon Client 執行個體,使用者也可同時連線至多個伺服器。預設值是 true。語法範例為 useExisting=false。
- unauthenticatedAccessEnabled
- 如果此選項設為 true,則依預設會啟用 [未驗證存取] 功能。 使用「未驗證存取」匿名登入選項會顯示在使用者介面中,並且已選取。如果此選項設為 false,則會停用 [未驗證存取] 功能。 使用「未驗證存取」匿名登入設定會隱藏並停用。此選項設為 "" 時,將會停用 [未驗證存取] 功能,並且在使用者介面中隱藏並停用 使用「未驗證存取」匿名登入設定。語法範例為 unauthenticatedAccessEnabled=true。
- unauthenticatedAccessAccount
- 如果「未驗證存取」功能已啟用,將會設定要使用的帳戶。如果 [未驗證存取] 功能停用,則會忽略此查詢。使用 anonymous1 使用者帳戶的語法範例為 unauthenticatedAccessAccount=anonymous1。