Skip to main content

2026 年 4 月 16 日

Horizon Agent for Windows 的無訊息安裝屬性

您可以在命令列中以無訊息方式安裝 Horizon Agent for Windows 時,包含特定屬性。您必須使用 PROPERTY=value 格式,讓 Microsoft Windows Installer (MSI) 能正確解譯這些屬性及其值。 無訊息升級會使用相同的安裝命令。您也可以透過無訊息方式修改已安裝的 Horizon Agent 元件。

下表列出您可在命令列上使用的 Horizon Agent 無訊息安裝屬性。

適用於無訊息安裝 Horizon Agent 的 MSI 內容
MSI 屬性說明預設值
ENABLE_UNC_REDIRECTION指定是否安裝 UNC 路徑重新導向功能。值為 1 時,系統會安裝功能。您必須使用群組原則設定來設定要重新導向的 UNC。請參閱《Horizon 遠端桌面平台功能和 GPO》文件中的〈設定 UNC 路徑重新導向〉章節。 此 MSI 屬性為選用。0
HORIZON_MONITOR_ENABLED指定要啟用或停用 Horizon 監控模式。此旗標僅在您的環境中已安裝 Horizon Cloud Service - next-gen 時才會生效。 值 1 表示啟用 Horizon 監控模式。值 0 表示停用 Horizon 監控。0
IGNORE_DOTNET_CHECK決定安裝程式是否會檢查最低 .NET 版本。依預設,選取 Horizon Performance Tracker 後,安裝程式會執行預先檢查,以確認是否安裝了 .NET 4.6.2 或更新版本,如未安裝,則會停止安裝程序。 值 1 表示取消這項預先檢查。值 0 表示允許繼續執行預先檢查。0
INSTALLDIRHorizon Agent 軟體的安裝路徑和資料夾。例如: INSTALLDIR=""D:\abc\my folder"" 兩組用來括住路徑的雙引號會允許 MSI 安裝程式忽略路徑中的空格。 此 MSI 屬性為選用。Horizon Agent 會安裝在 %ProgramFiles% structure.
RDP_CHOICE決定是否要在桌面平台啟用遠端桌面平台通訊協定 (RDP)。 值 1 可啟用 RDP。值 0 則維持停用 RDP 設定。 此 MSI 屬性為選用。1
SUPPRESS_RUNONCE_CHECK忽略在下次作業系統重新開機時於 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnceRunOnceEx 機碼中排程的擱置中 Windows Update 工作。使用此旗標可允許並行安裝,但在系統更新會影響 Horizon Agent 執行階段相依性時無法保證安裝結果。 此 MSI 屬性為選用。
URL_FILTERING_ENABLED指定是否已安裝 URL 內容重新導向功能。值為 1 時,系統會安裝功能。您必須使用群組原則設定來設定要重新導向的 URL。請參閱《Horizon 遠端桌面平台功能和 GPO》文件中的〈設定 URL 內容重新導向〉章節。 此 MSI 屬性為選用。0
VDM_SKIP_BROKER_REGISTRATION若值為 1,則會略過非受管理的桌面平台。
VDM_VC_MANAGED_AGENT決定 vCenter Server 是否要管理已安裝 Horizon Agent 的虛擬機器。 值為 1 時,系統會將桌面平台設定為由 vCenter Server 管理的虛擬機器。 值 0 會將桌面平台設定為不由 vCenter Server 管理。 需要此 MSI 屬性。 附註:非受管理的安裝不支援安裝程式修復選項。修復此類安裝將會導致安裝受管理的 Horizon Agent。
VDM_REINSTALL指定以逗點分隔的已安裝功能清單,這些功能必須重新安裝,僅適用於無訊息模式。
VDM_REINSTALLMODE包含字母的字串,用於指定要執行的重新安裝類型,僅適用於無訊息模式。如需有關要使用的選項的詳細資料,請參閱 https://learn.microsoft.com/zh-tw/windows/win32/msi/reinstallmode
VDM_SERVER_NAME連線伺服器執行個體 (Horizon Agent 安裝程式在其中登錄非受管理的桌面平台) 的主機名稱或 IP 位址。此屬性僅適用於非受管理的桌面平台。例如: VDM_SERVER_NAME=10.123.01.01 未受管理的桌面平台需要此 MSI 屬性。 請勿將此 MSI 屬性用於 vCenter Server 所管理的虛擬桌面平台。
VDM_SERVER_USERNAME連線伺服器執行個體之管理員的使用者名稱。此 MSI 屬性僅適用於非受管理的桌面平台。例如: VDM_SERVER_USERNAME=domain\username 未受管理的桌面平台需要此 MSI 屬性。 請勿將此 MSI 屬性用於 vCenter Server 所管理的虛擬桌面平台。
VDM_SERVER_PASSWORD連線伺服器管理員的使用者密碼。例如: VDM_SERVER_PASSWORD=secret 未受管理的桌面平台需要此 MSI 屬性。 請勿將此 MSI 屬性用於 vCenter Server 所管理的虛擬桌面平台。
VDM_IP_PROTOCOL_USAGE指定 Horizon Agent 使用的 IP 版本。有效值為 IPv4 和 IPv6。IPv4
VDM_FIPS_ENABLED指定要啟用或停用 FIPS 模式。將值設為 1 可啟用 FIPS 模式。將值設為 0 可停用 FIPS 模式。若此屬性設為 1 且 Windows 不位於 FIPS 模式,則安裝程式將停止。0
VDM_FORCE_DESKTOP_AGENT如果您將 Horizon Agent 安裝在 Windows Server 機器上,並將其設定為單一使用者 Horizon 桌面平台而非 RDS 主機,請將值設定為 1。此要求適用於 vCenter Server 管理的機器以及非受管理的機器。對於裝載應用程式工作階段的非伺服器 Windows 客體,請將值設定為 0。 此 MSI 屬性為選用。0

在無訊息安裝命令中,您可以使用 ADDLOCAL 屬性來指定 Horizon Agent 安裝程式所設定的選項。

下表列出您可以在命令列上輸入的 Horizon Agent 選項。這些選項與可在互動式安裝期間取消選取或選取的安裝選項相對應。

如果您在命令列中未使用 ADDLOCAL 屬性,則 Horizon Agent 會安裝所有在互動式安裝期間依預設安裝的選項,前提是這些選項受客體作業系統支援。當您使用 ADDLOCAL=ALL 時,Horizon Agent 會安裝以下所有選項,包括預設啟用與預設停用的選項,前提是這些選項受客體作業系統支援。

如需詳細資訊,請參閱 Microsoft Windows Installer 命令列選項中的 ADDLOCAL 表格項目。

如果您使用 ADDLOCAL 單獨指定功能 (未指定 ADDLOCAL=ALL),則必須一併指定 Core。

您可以透過 ADDLOCAL 和 REMOVE MSI 屬性來修改功能。使用下列 PowerShell 命令,查詢已安裝 Horizon Agent 的系統上登錄中的已安裝元件,以取得 ModifyPath base 命令列:

Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* |
        Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -like '*Horizon Agent'} | Format-Table –AutoSize

以下為範例輸出 ({ 和 } 之間的 GUID 會因系統中的代理程式組建編號不同而有所差異)。

DisplayName        ModifyPath
Horizon Agent      MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}

**附註:**在以下範例中,agent-installer.exe 代表下載的安裝程式檔案名稱。將其替換為您實際使用的安裝程式 exe 名稱。

以下範例會修改並從現有安裝中移除 USB 元件:agent-installer.exe /s /v"/qn REMOVE=USB"

以下範例會修改代理程式安裝,將 Horizon Performance Tracker 替換為 Horizon Help Desk Tool:agent-installer.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker"

以下範例會修改代理程式安裝,新增序列埠與掃描器重新導向功能:agent-installer.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection"

Horizon Agent 無訊息安裝選項及互動式自訂安裝選項
無訊息安裝選項互動式安裝中的自訂安裝選項預設為進行互動式安裝或不使用 ADDLOCAL 時安裝
Core核心 Horizon Agent 功能。 如果您指定 ADDLOCAL=ALL,則會安裝 Core 功能。
USBUSB 重新導向
NGVC即時複製代理程式
RTAV即時影音 (RTAV)
ClientDriveRedirection用戶端磁碟機重新導向
SerialPortRedirection序列埠重新導向
ScannerRedirection掃描器重新導向
GEOREDIR地理位置重新導向
V4VHorizon Monitoring Service Agent
SmartCard智慧卡 依預設,在互動式安裝中不會安裝此功能。
請連絡 Omnissa 支援團隊,以取得符合您所使用的 Horizon 版本之正確選項名稱。音訊 (虛擬音訊驅動程式)
請連絡 Omnissa 支援團隊,以取得符合您所使用的 Horizon 版本之正確選項名稱。間接顯示驅動程式附註:僅在下列情況下,這個選項才會在登錄中安裝並標示為「本機」:
  • 桌面平台模式下的 Windows Server 為 RS4 及以上版本 (作業系統組建編號 17134 - 版本 1803),或
  • 伺服器為 19H1 及以上版本 (作業系統組建編號 18362 - 版本 1903)
在具有 RDS 角色的 Windows Server 2019 (版本 1809) std 和 datacenter 中,這個選項會安裝並在登錄中設為「不存在」。 在具有 RDS 角色的 Windows Server 2022 中,這個選項會安裝並在登錄中設為「本機」。
TSMMRWindows Media 多媒體重新導向 (MMR)
RDP如果您在命令列中使用 RDP_CHOICE=1 屬性,或在建立或編輯桌面平台集區時選取 RDP 作為預設顯示通訊協定,則會在登錄中啟用 RDP。 此功能在互動式安裝期間隱藏。
RDSH3DRDS 主機上的 3D 轉譯
BlastUDPBlast 的 UDP 傳輸支援
SdoSensorSDO 感應器重新導向
PerfTrackerHorizon Performance Tracker
服務台Horizon Help Desk Tool
PrintRedirIntegrated Printing
PSG此功能會設定登錄項目,向連線伺服器告知 Horizon Agent 使用 IPv4 或 IPv6。

此頁面對您有幫助嗎?

針對本主題提供意見回饋

本主題對您有幫助嗎?

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

正在產生連結…