Skip to main content

2026 年 4 月 23 日

從命令列執行 Horizon Windows Client

您可以透過命令列或指令碼執行 Omnissa Horizon Client。如果您正在實作以 Kiosk 為基礎的應用程式,讓使用者可存取遠端桌面平台應用程式,您可能會希望從命令列執行 Horizon Client。

若要從命令列執行 Horizon Client,您可以使用 horizon-client 命令。horizon-client 命令包含您可以指定來變更 Horizon Client 行為的各種選項。

Horizon Client 命令使用方式

horizon-client 命令的語法可用來控制 Horizon Client 的作業。

在 Windows 命令提示字元中使用 horizon-client 命令的下列格式。

horizon-client [command_line_option [argument]] ...

horizon-client 命令可執行檔案的預設路徑視用戶端系統而定。您可以將此路徑新增至用戶端系統上的 PATH 環境變數。

  • 64 位元系統:C:\Program Files\Omnissa\Omnissa Horizon Client\
  • ARM 上的 64 位元系統:C:\Program Files (x86)\Omnissa\Omnissa Horizon Client\

下表顯示您能夠與 horizon-client 命令搭配使用的命令列選項。

Horizon Client 命令列選項
選項說明
/?顯示命令選項的清單。
-appName application_name指定已發佈的應用程式顯示於桌面平台和應用程式選取視窗中的名稱。此名稱是在集區建立精靈中為應用程式集區指定的顯示名稱。
-appProtocol 通訊協定指定要使用的已發佈應用程式顯示通訊協定 (如果有的話)。有效的通訊協定如下:
  • Blast
  • PCoIP
-appSessionReconnectionBehavior 引數指定已發佈應用程式的重新連線行為設定。有效引數如下:
  • always

    實作自動重新連線以開啟應用程式設定。

  • never

    實作不要求重新連線,且不自動重新連線設定。

  • ask

    實作要求重新連線以開啟應用程式設定。

使用此選項時,Horizon Client 中的已發佈應用程式重新連線設定將會停用。
-args 引數指定在已發佈的應用程式啟動時要新增的命令列引數。例如:
horizon-client -serverURL
10.10.10.10 -appName "My Notepad++" -args "\"my new.txt\""
-connectUSBOnStartup設定為 true 時,會將連線至主機的所有 USB 裝置重新導向至遠端桌面平台或已發佈的應用程式。如果您為遠端桌面平台指定 -unattended 選項,則會隱含地設定此選項。預設值為 false。
-connectUSBOnInsert設為 true 時,當您插入 USB 裝置時,系統會將該裝置連線至前景遠端桌面平台或已發佈的應用程式。如果您為遠端桌面平台指定 -unattended 選項,則會隱含地設定此選項。預設值為 false。
-desktopLayout window_size指定顯示遠端桌面平台視窗的方式。有效的視窗大小值如下:
  • fullscreen

    全螢幕顯示。

  • multimonitor

    多台監視器顯示。

  • windowLarge

    大視窗。

  • windowSmall

    小視窗。

  • length X width

    自訂大小,例如 800 X 600。

-desktopName desktop_name指定遠端桌面平台顯示於桌面平台和應用程式選取視窗中的名稱。此名稱即為在集區建立精靈中為集區指定的顯示名稱。 重要:請不要在 Kiosk 模式下為用戶端指定此選項。當遠端桌面平台以 Kiosk 模式執行時,此選項無效。在 Kiosk 模式下,系統會與授權的遠端桌面平台清單中的第一個遠端桌面平台建立連線。
-desktopProtocol 通訊協定指定所要使用、將在桌面平台和應用程式選取視窗中顯示的顯示通訊協定。有效的顯示通訊協定如下:
  • Blast
  • PCoIP
  • RDP
-domainName domain_name指定使用者登入 Horizon Client 所使用的 NETBIOS 網域。例如,使用 mycompany 而非 mycompany.com
-file file_path指定含有額外命令選項和引數的組態檔案路徑。
-h顯示說明選項。
-hideClientAfterLaunchSession設定為 true 時,系統會隱藏桌面平台和應用程式選取器視窗。設定為 false 時,系統會顯示桌面平台和應用程式選取器視窗。

附註:若使用 -appName 或 -desktopName,無論是否搭配 -hideClientAfterLaunchSession,Horizon Client 一律會隱藏選取器視窗。

-installShortcutsThenQuit使用此選項可安裝伺服器上所設定的桌面平台和應用程式捷徑。當您使用此選項並提供足夠的伺服器驗證資訊時,Horizon Client 會以無訊息方式連線至伺服器、安裝捷徑,然後結束。如果伺服器驗證失敗,Horizon Client 會以無訊息方式結束。 若要在用戶端系統上自動安裝捷徑,請建立會在用戶端系統啟動時執行的指令碼。例如:
horizon-client -serverURL serverurl -userName user -domainName domain 
-password password -installShortcutsThenQuit

horizon-client -serverURL serverurl -logInAsCurrentUser true -installShortcutsThenQuit

如需伺服器建立之捷徑的相關資訊,請參閱在 Horizon Windows Client 上設定捷徑更新
-languageId Locale_ID在 Horizon Client 中為不同的語言提供當地語系化支援。如果具有資源程式庫,請指定要使用的地區設定識別碼 (LCID)。若是美國英文,請輸入值 0x409。
-launchMinimized以最小化模式啟動 Horizon Client。 如果您提供 -appName 或 -desktopName 選項,Horizon Client 會保持最小化狀態,直到指定的已發佈應用程式或遠端桌面平台啟動為止。 您無法將此選項與 -unattended 或 -nonInteractive 選項併用。
-listMonitors列出索引值並顯示所連接監視器的配置資訊。例如:
1: (0, 0, 1920, 1200)
2: (1920, 0, 3840, 1200)
3: (-900, -410, 0, 1190)
您可以在 -monitors 選項中使用這些索引值。
–lockUserName鎖定所提供的使用者名稱以供伺服器登入。僅當您指定伺服器位址時,才能使用此選項。使用此選項可鎖定 Active Directory 驗證類型的使用者名稱欄位。
-logInAsCurrentUser設定為 true 時,系統會利用使用者登入用戶端系統時所提供的認證資訊來登入伺服器,且最終會登入至遠端桌面平台。預設值為 false。
-machineName machine_name將 RDSH/機器 FQDN 傳送至伺服器以在機器上啟動應用程式或桌面平台。只有在集區或伺服器陣列上啟用了允許選取機器名稱設定時,此選項才會生效。此選項同時需搭配指定 -desktopName、-appName 和 -serverURL 選項,才會生效。
-monitors"n[,n,n,n]"指定要在多台監視器設定中使用的監視器,其中 n 為監視器的索引值。您可以使用 -listMonitors 選項來決定所連接監視器的索引值。您可以使用逗號分隔來指定最多四個索引值。例如:
-monitors "1,2"
此選項僅在 -desktopLayout 設為 multimonitor 時才會生效。
-nonInteractive從指令碼啟動 Horizon Client 時,會隱藏錯誤訊息方塊。如果您指定 -unattended 選項,則會隱含設定此選項。 附註:如果您在非互動模式中登入伺服器,則不會提示您安裝開始功能表捷徑 (如果有的話),且依預設會安裝捷徑。
-noHorizonAddins防止載入 Horizon 特定虛擬通道,例如虛擬列印。
-password password指定使用者登入 Horizon Client 所使用的密碼。密碼由命令主控台或其他指令碼工具在純文字中處理。如果您自動產生密碼,則不需要為處於 Kiosk 模式的用戶端指定此選項。為提高安全性,請勿指定此選項。使用者能以互動式方法輸入密碼。
-printEnvironmentInfo顯示用戶端裝置的 IP 位址、MAC 位址及機器名稱。
-serverURL connection_server指定伺服器的 URL、IP 位址或 FQDN。
-shutdown關閉所有遠端桌面平台和已發佈的應用程式,以及相關的使用者介面元件。
-singleAutoConnect如果使用者僅有權使用一個遠端桌面平台或已發佈的應用程式,在使用者通過伺服器驗證後,將會連線至該遠端桌面平台或已發佈的應用程式。此設定可讓使用者不需要從只包含一個項目的清單中選取遠端桌面平台或已發佈的應用程式。
-smartCardPIN PIN指定使用者在插入智慧卡進行登入時所使用的 PIN 碼。
-usernameHint user_name指定要作為使用者名稱提示的帳戶名稱。
-standalone啟動第二個 Horizon Client 執行個體,可用來連線至相同或不同的伺服器。此選項支援回溯相容性。無需指定 -standalone,因為這是用戶端的預設行為。 對相同或不同伺服器建立多個遠端桌面平台連線時,支援使用安全通道。 附註:第二個遠端桌面平台連線可能無法存取本機硬體,例如 USB 裝置、智慧卡、印表機和多台監視器。
-supportText file_name指定文字檔案的完整路徑。檔案的內容會顯示在 [關於] 對話方塊中。
-unattended以非互動模式啟動 Horizon Client,適用於 Kiosk 模式下的用戶端。您也必須指定下列資訊:
  • 用戶端的帳戶名稱 (如果您未從用戶端裝置的 MAC 位址產生帳戶名稱)。此名稱的開頭必須是字串「custom-」,或是您已在 ADAM 中設定的替代前置詞。
  • 用戶端的密碼 (如果您為用戶端設立帳戶時沒有自動產生密碼)。
指定 -unattended 選項時,系統會隱含設定 -nonInteractive、-connectUSBOnStartup、-connectUSBOnInsert,以及 -desktopLayout multimonitor 等選項。
-unauthenticatedAccessAccount指定在 [未驗證存取] 啟用時用來匿名登入伺服器的「未驗證存取」使用者帳戶。如果 [未驗證存取] 未啟用,則會忽略此選項。 例如:
horizon-client -serverURL horizon.mycompany.com 
-unauthenticatedAccessEnabled true 
-unauthenticatedAccessAccount anonymous1
-unauthenticatedAccessEnabled 設定為 true 時會啟用「未驗證存取」。如果「未驗證存取」無法使用,用戶端可以回復為使用其他驗證方法。在 Horizon Client 中,未驗證存取設定會顯示為可見、已停用且處於選取狀態。

設定為 false 時,您必須輸入認證才能登入和存取應用程式。在 Horizon Client 中,未驗證存取設定會隱藏且處於未選取狀態。 如果未指定此選項,您可以在 Horizon Client 中啟用 [未驗證存取]。未驗證存取設定會顯示為啟用狀態,並且取消選取。

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

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

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

範例:

啟動「小算盤」應用程式後,會開啟一個用戶端執行個體:

horizon-client -userName user-1 -password secret 
-domainName domain -appName Calculator 
-serverURL horizon.mycompany.com 

搭配 -useExisting 執行另一個命令時,系統會在啟動新工作階段前提示您先登出現有的「小算盤」應用程式工作階段:

horizon-client -userName user-1 -password secret
-domainName domain -appName Paint
-serverURL horizon.mycompany.com -useExisting
-userName user_name指定使用者登入 Horizon Client 所使用的帳戶名稱。如果您用戶端裝置的 MAC 位址產生帳戶名稱,則不需要為處於 Kiosk 模式的用戶端指定此選項。

您可以透過 Active Directory 群組原則指定所有選項,但 -file、-languageId、-printEnvironmentInfo、-smartCardPIN 和 -unattended 除外。

**附註:**群組原則設定的優先順序高於您透過命令列指定的設定。命令列選項區分大小寫。

Horizon Client 組態檔

您可以從組態檔讀取 Horizon Client 的命令列選項。

您可以將組態檔案的路徑指定為 horizon-client 命令之 -filefile_path 選項的引數。檔案必須是 Unicode (UTF-16) 或 ASCII 文字檔案。

非互動應用程式的組態檔案範例

以下範例顯示了非互動應用程式的組態檔案內容。

-serverURL https://horizon.yourcompany.com
-userName autouser
-password auto123
-domainName companydomain
-desktopName autodesktop
-nonInteractive

Kiosk 模式用戶端的組態檔案範例

以下範例顯示一個處於 Kiosk 模式中、且帳戶名稱以用戶端 MAC 位址為基礎的用戶端。該用戶端具有自動產生的密碼。

-serverURL 145.124.24.100
-unattended

此頁面對您有幫助嗎?

針對本主題提供意見回饋

本主題對您有幫助嗎?

請勿填寫任何個人或機密資訊。

正在產生連結…