當您從命令列無訊息安裝 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 監控模式。僅當您的環境中安裝了 VMware Horizon Cloud Service - next-gen 時,此旗標才會起作用。 值 1 表示啟用 Horizon 監控模式。值 0 表示停用 Horizon 監控。 |
0 |
IGNORE_DOTNET_CHECK | 決定安裝程式是否會檢查最低 .NET 版本。依預設,選取 Horizon Performance Tracker 後,安裝程式會執行預先檢查,以確認是否安裝了 .NET 4.6.2 或更新版本,如未安裝,則會停止安裝程序。 值 1 表示取消這項預先檢查。值 0 表示允許繼續執行預先檢查。 |
%ProgramFiles%\VMware\VMware View\Agent |
INSTALLDIR | 安裝Horizon Agent 軟體的路徑和資料夾。例如: INSTALLDIR=""D:\abc\my folder"" 兩組用來括住路徑的雙引號會允許 MSI 安裝程式忽略路徑中的空格。 此 MSI 屬性為選用。 |
|
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。
Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* | Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -eq 'VMware Horizon Agent'} | Format-Table –AutoSize輸出:
DisplayName ModifyPath VMware Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
下列範例會修改並移除現有安裝中的 USB 元件:VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn REMOVE=USB"
下列範例會將 Horizon Performance Tracker 取代為 Horizon Help Desk Tool 以修改代理程式安裝:VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”
下列範例會新增序列埠和掃描器重新導向,以修改代理程式安裝:VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”
無訊息安裝選項 | 互動式安裝中的自訂安裝選項 | 預設為進行互動式安裝或不使用 ADDLOCAL時安裝 |
---|---|---|
Core | 核心 Horizon Agent功能。 若您指定 ADDLOCAL=ALL,則會安裝 Core 功能。 |
是 |
USB | USB 重新導向 | 否 |
NGVC | 即時複製代理程式 | 否 |
RTAV | 即時影音 | 是 |
ClientDriveRedirection | 用戶端磁碟機重新導向 | 是 |
SerialPortRedirection | 序列埠重新導向 | 否 |
ScannerRedirection | 掃描器重新導向 | 否 |
GEOREDIR | 地理位置重新導向 | 否 |
V4V | Horizon Monitoring Service Agent | 是 |
SmartCard | 智慧卡 依預設,在互動式安裝中不會安裝此功能。 |
否 |
VmwVaudio | VMware 音訊 (虛擬音訊驅動程式) | 是 |
VmwVidd | VMware 間接顯示驅動程式 | 是
備註: 僅當出現下列情況時,才會安裝 VmwVidd 並在登錄中標記為「本機」:
將在具有 RDS 角色的 Windows Server 2019 (版本 1809) std 和資料中心安裝 VmwVidd 並在登錄中將其設定為 Absent。 將在具有 RDS 角色的 Windows Server 2022 中安裝 VmwVidd 並在登錄中將其設定為 Local。 |
TSMMR | Windows Media 多媒體重新導向 (MMR) | 是 |
RDP | 如果您在命令列上使用 RDP_CHOICE=1屬性,或是在建立或編輯桌面平台集區時選取 RDP 作為預設顯示通訊協定,則會在登錄中啟用 RDP。 此功能在互動式安裝期間隱藏。 |
是 |
RDSH3D | RDS 主機上的 3D 轉譯 | 否 |
BlastUDP | Blast 的 UDP 傳輸支援 | 是 |
SdoSensor | SDO 感應器重新導向 | 否 |
PerfTracker | Horizon Performance Tracker | 否 |
HelpDesk | Horizon Help Desk Tool | 是 |
PrintRedir | VMware Integrated Printing | 是 |
PSG | 此功能會設定登錄項目,向連線伺服器指出 Horizon Agent應使用 IPv4 還是 IPv6。 | 是 |