語法包括 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
指定桌面平台或應用程式。請使用桌面平台顯示名稱或應用程式顯示名稱。這是建立桌面平台或應用程式集區時於 View Administrator 中指定的名稱。如果顯示名稱中有空格,請使用 %20 編碼機制代表空格。
query-part
請指定要使用的組態選項或要執行的桌面平台或應用程式動作。查詢不區分大小寫。若要使用多項查詢,請在查詢之間使用 & 符號。如果查詢彼此衝突,即使用清單中最後一項查詢。使用下列語法:
query1=value1[&query2=value2...]

支援的查詢

本主題列出此類型 Horizon Client 所支援的查詢。如果您正為多種類型的用戶端建立 URI,如桌面平台用戶端和行動用戶端,請參閱各種用戶端系統所適用的《使用 VMware Horizon Client》指南。

動作
表 1. 可與 action 查詢搭配使用的值
描述
browse 顯示指定伺服器上主控的可用桌面平台和應用程式清單。當您使用此動作時,不需指定桌面平台或應用程式。
start-session 開啟指定的桌面平台或應用程式。如果未提供任何動作查詢且提供了桌面平台或應用程式名稱,start-session 即為預設的動作。
reset

關閉並重新啟動指定的桌面平台或遠端應用程式。尚未儲存的資料會遺失。重設遠端桌面平台等同於按下實體 PC 上的重設按鈕。

logoff 將使用者從遠端桌面平台的客體作業系統登出。如果您指定某個應用程式,則該動作將被忽略,或者使用者將看到警告訊息「URI 動作無效」。
args
指定要新增至遠端應用程式啟動的命令列引數。使用語法 args= value,其中 value 為字串。針對下列字元使用百分比編碼:
  • 冒號 (:) 請使用 %3A
  • 反斜線 (\) 請使用 %5C
  • 空格 ( ) 請使用 %20
  • 雙引號 (") 請使用 %22

例如,若要為 Notepad++ 應用程式指定檔案名稱 "My new file.txt",請使用 %22My%20new%20file.txt%22

appProtocol
針對遠端應用程式,有效值為 PCOIPBLAST。例如,若要指定 PCoIP,請使用語法 appProtocol=PCOIP
connectUSBOnInsert
當您插入裝置時,會連接 USB 裝置到前景桌面平台。若您指定 unattended 查詢,則會隱含設定此查詢。若要使用此查詢,您必須將 action 查詢設定成 start-session 或者不要有 action 查詢。有效值為 yesno。語法範例為 connectUSBOnInsert=yes
connectUSBOnStartup
將所有 USB 裝置重新導向至目前已連接至用戶端系統的桌面平台。若您指定 unattended 查詢,則會隱含設定此查詢。若要使用此查詢,您必須將 action 查詢設定成 start-session 或者不要有 action 查詢。有效值為 yesno。語法範例為 connectUSBOnStartup=yes
desktopLayout
設定顯示遠端桌面平台之視窗的大小。若要使用此查詢,您必須將 action 查詢設定成 start-session 或者不要有 action 查詢。
表 2. desktopLayout 查詢的有效值
描述
fullscreen 一台監視器上全螢幕顯示。此值為預設值。
multimonitor 所有監視器上全螢幕顯示。
windowLarge 大視窗。
windowSmall 小視窗。
WxH 自訂解析度,以畫素單位指定寬度乘高度。語法範例為 desktopLayout=1280x800
desktopProtocol
針對遠端桌面平台,有效值為 RDPPCOIPBLAST。例如,若要指定 PCoIP,請使用語法 desktopProtocol=PCOIP
domainName
與連線到遠端桌面平台或應用程式之使用者有關的 NETBIOS 網域名稱。例如,您可以使用 mycompany 而非 mycompany.com
filePath
指定您要以遠端應用程式開啟之本機系統上檔案的路徑。您必須使用完整路徑,包括磁碟機代號。針對下列字元使用百分比編碼:
  • 冒號 (:) 請使用 %3A
  • 反斜線 (\) 請使用 %5C
  • 空格 ( ) 請使用 %20

例如,若要代表檔案路徑 C:\test file.txt,請使用 C%3A%5Ctest%20file.txt

tokenUserName
指定 RSA 或 RADIUS 使用者名稱。唯有 RSA 或 RADIUS 使用者名稱和 Active Directory 使用者名稱不同時,才使用此查詢。如果您未指定此查詢,但需要進行 RSA 或 RADIUS 驗證時,則請使用 Windows 使用者名稱。語法是 tokenUserName=name
unattended
在 Kiosk 模式中建立伺服器與遠端桌面平台的連線。如果您使用此查詢,則從用戶端裝置的 MAC 位址產生帳戶名稱時,請勿指定使用者資訊。但是,如果您已在 ADAM 中建立自訂帳戶名稱,如開頭為 "custom-" 的名稱,您必須指定帳戶資訊。
useExisting
如果此選項設定為 true,則只能執行一個 Horizon Client 執行個體。如果使用者嘗試連線至第二個伺服器,則必須先登出第一個伺服器,因而造成桌面平台和應用程式工作階段中斷連線。如果此選項設定為 false,則可執行多個 Horizon Client 執行個體,使用者也可同時連線至多個伺服器。預設值是 true。語法範例為 useExisting=false