您可以在命令列中以無訊息方式安裝 Horizon Agent for Windows 時,包含特定屬性。您必須使用 PROPERTY=value 格式,讓 Microsoft Windows Installer (MSI) 能正確解譯這些屬性及其值。 無訊息升級會使用相同的安裝命令。您也可以透過無訊息方式修改已安裝的 Horizon Agent 元件。
下表列出您可在命令列上使用的 Horizon Agent 無訊息安裝屬性。
| 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 |
| INSTALLDIR | Horizon 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\RunOnce 和 RunOnceEx 機碼中排程的擱置中 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"
| 無訊息安裝選項 | 互動式安裝中的自訂安裝選項 | 預設為進行互動式安裝或不使用 ADDLOCAL 時安裝 |
|---|---|---|
| Core | 核心 Horizon Agent 功能。 如果您指定 ADDLOCAL=ALL,則會安裝 Core 功能。 | 是 |
| USB | USB 重新導向 | 否 |
| NGVC | 即時複製代理程式 | 否 |
| RTAV | 即時影音 (RTAV) | 是 |
| ClientDriveRedirection | 用戶端磁碟機重新導向 | 是 |
| SerialPortRedirection | 序列埠重新導向 | 否 |
| ScannerRedirection | 掃描器重新導向 | 否 |
| GEOREDIR | 地理位置重新導向 | 否 |
| V4V | Horizon Monitoring Service Agent | 是 |
| SmartCard | 智慧卡 依預設,在互動式安裝中不會安裝此功能。 | 否 |
| 請連絡 Omnissa 支援團隊,以取得符合您所使用的 Horizon 版本之正確選項名稱。 | 音訊 (虛擬音訊驅動程式) | 是 |
| 請連絡 Omnissa 支援團隊,以取得符合您所使用的 Horizon 版本之正確選項名稱。 | 間接顯示驅動程式 | 是
附註:僅在下列情況下,這個選項才會在登錄中安裝並標示為「本機」:
|
| TSMMR | Windows Media 多媒體重新導向 (MMR) | 是 |
| RDP | 如果您在命令列中使用 RDP_CHOICE=1 屬性,或在建立或編輯桌面平台集區時選取 RDP 作為預設顯示通訊協定,則會在登錄中啟用 RDP。 此功能在互動式安裝期間隱藏。 | 是 |
| RDSH3D | RDS 主機上的 3D 轉譯 | 否 |
| BlastUDP | Blast 的 UDP 傳輸支援 | 是 |
| SdoSensor | SDO 感應器重新導向 | 否 |
| PerfTracker | Horizon Performance Tracker | 否 |
| 服務台 | Horizon Help Desk Tool | 是 |
| PrintRedir | Integrated Printing | 是 |
| PSG | 此功能會設定登錄項目,向連線伺服器告知 Horizon Agent 使用 IPv4 或 IPv6。 | 是 |
此頁面對您有幫助嗎?