Sie können spezifische Eigenschaften einschließen, wenn Sie eine Hintergrundinstallation von Horizon Agent für Windows über die Befehlszeile durchführen. Sie müssen das Format PROPERTY=value verwenden, damit Microsoft Windows Installer (MSI) die Eigenschaften und Werte interpretieren kann. Bei einem unbeaufsichtigten Upgrade werden die gleichen Installationsbefehle verwendet. Sie können die bereits installierten Horizon Agent-Komponenten ebenfalls unbeaufsichtigt ändern.
Die folgende Tabelle enthält die Eigenschaften für die unbeaufsichtigte Installation von Horizon Agent, die Sie in der Befehlszeile verwenden können.
MSI-Eigenschaft | Beschreibung | Standardwert |
---|---|---|
ENABLE_UNC_REDIRECTION | Legen Sie fest, ob die Funktion „UNC-Pfadumleitung“ installiert werden soll. Bei Verwendung des Werts 1 wird die Funktion installiert. Sie müssen mithilfe der Gruppenrichtlinieneinstellungen festlegen, welche UNCs umgeleitet werden sollen. Weitere Informationen finden Sie unter „Konfigurieren der UNC-Pfadumleitung“ im Dokument Horizon-Remote-Desktopfunktionen und GPOs. Diese MSI-Eigenschaft ist optional. |
0 |
HORIZON_MONITOR_ENABLED | Gibt an, ob der Horizon-Überwachungsmodus aktiviert oder deaktiviert werden soll. Dieses Flag funktioniert nur, wenn VMware Horizon Cloud Service – next-gen in Ihrer Umgebung installiert ist. Der Wert 1 aktiviert den Horizon-Überwachungsmodus. Der Wert 0 deaktiviert den Horizon-Überwachungsmodus. |
0 |
IGNORE_DOTNET_CHECK | Legt fest, ob das Installationsprogramm eine .NET-Mindestversion überprüft. Wenn der Horizon Performance Tracker ausgewählt ist, führt das Installationsprogramm standardmäßig eine Vorabprüfung durch, um zu bestätigen, dass .NET 4.6.2 oder höher installiert ist, und hält den Installationsvorgang an, falls dies nicht der Fall ist. Mit dem Wert 1 wird diese Vorabprüfung abgebrochen. Mit dem Wert 0 kann die Vorabprüfung fortgesetzt werden. |
%ProgramFiles%\VMware\VMware View\Agent |
INSTALLDIR | Pfad und Verzeichnis für die Installation der Horizon Agent-Software. Beispiel: INSTALLDIR=""D:\abc\my folder"" Die zweifach gesetzten doppelten Anführungszeichen um den Pfad sorgen dafür, dass das MSI-Installationsprogramm das Leerzeichen im Pfad ignoriert. Diese MSI-Eigenschaft ist optional. |
|
RDP_CHOICE | Legt fest, ob RDP (Remote Desktop Protocol) auf dem Desktop aktiviert werden soll. Mit dem Wert 1 wird RDP aktiviert. Mit dem Wert 0 wird die RDP-Einstellung deaktiviert gelassen. Diese MSI-Eigenschaft ist optional. |
1 |
SUPPRESS_RUNONCE_CHECK | Ignoriert ausstehende Windows Update-Aufgaben, die für den nächsten Neustart des Betriebssystems in den Schlüsseln HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce und RunOnceEx geplant sind. Die Verwendung dieses Kennzeichens ermöglicht eine parallele Installation. Das Ergebnis der Installation kann aber abweichen, wenn die System-Updates Auswirkungen auf die Laufzeitabhängigkeiten von Horizon Agent haben. Diese MSI-Eigenschaft ist optional. |
Keine |
URL_FILTERING_ENABLED | Legen Sie fest, ob die URL-Inhaltsumleitung installiert werden soll. Bei Verwendung des Werts 1 wird die Funktion installiert. Sie müssen mithilfe der Gruppenrichtlinieneinstellungen festlegen, welche URLs umgeleitet werden sollen. Weitere Informationen finden Sie unter „Konfigurieren der URL-Inhaltsumleitung“ im Dokument Horizon-Remote-Desktopfunktionen und GPOs. Diese MSI-Eigenschaft ist optional. |
0 |
VDM_SKIP_BROKER_REGISTRATION | Mit dem Wert 1 werden nicht verwaltete Desktops übersprungen. | Keine |
VDM_VC_MANAGED_AGENT | Legt fest, ob vCenter Server die virtuelle Maschine verwaltet, auf der Horizon Agent installiert ist. Mit dem Wert 1 wird der Desktop als von vCenter Server verwaltete virtuelle Maschine konfiguriert. Mit dem Wert 0 wird der Desktop ohne Verwaltung durch vCenter Server konfiguriert. Diese MSI-Eigenschaft ist erforderlich.
Hinweis: Die Reparaturoption des Installationsprogramms wird nicht für eine nicht verwaltete Installation unterstützt. Die Reparatur einer solchen Installation führt zur Installation eines verwalteten
Horizon Agent.
|
Keine |
VDM_REINSTALL | Gibt eine kommagetrennte Liste von bereits installierten Funktionen an, die neu installiert werden sollen (nur im unbeaufsichtigten Modus anwendbar). | Keine |
VDM_REINSTALLMODE | Eine Zeichenfolge mit Buchstaben, die die Art der durchzuführenden Neuinstallation angibt (nur im unbeaufsichtigten Modus anwendbar). Weitere Informationen zu den zu verwendenden Optionen finden Sie unter https://learn.microsoft.com/de-de/windows/win32/msi/reinstallmode. | Keine |
VDM_SERVER_NAME | Der Hostname oder die IP-Adresse der Verbindungsserver-Instanz, auf der das Horizon Agent-Installationsprogramm einen nicht verwalteten Desktop registriert. Diese Eigenschaft gilt nur für nicht verwaltete Desktops. Beispiel: VDM_SERVER_NAME=10.123.01.01 Diese MSI-Eigenschaft ist für nicht verwaltete Desktops erforderlich. Verwenden Sie diese MSI-Eigenschaft nicht für virtuelle Desktops, die von vCenter Server verwaltet werden. |
Keine |
VDM_SERVER_USERNAME | Der Benutzername des Administrators auf der Verbindungsserver-Instanz. Diese MSI-Eigenschaft gilt nur für nicht verwaltete Desktops. Beispiel: VDM_SERVER_USERNAME=Domäne\Benutzername Diese MSI-Eigenschaft ist für nicht verwaltete Desktops erforderlich. Verwenden Sie diese MSI-Eigenschaft nicht für virtuelle Desktops, die von vCenter Server verwaltet werden. |
Keine |
VDM_SERVER_PASSWORD | Kennwort der Verbindungsserver-Administratorbenutzers. Beispiel: VDM_SERVER_PASSWORD=secret Diese MSI-Eigenschaft ist für nicht verwaltete Desktops erforderlich. Verwenden Sie diese MSI-Eigenschaft nicht für virtuelle Desktops, die von vCenter Server verwaltet werden. |
Keine |
VDM_IP_PROTOCOL_USAGE | Gibt die von Horizon Agent verwendete IP-Version an. Gültige Werte sind IPv4 und IPv6. | IPv4 |
VDM_FIPS_ENABLED | Geben Sie an, ob der FIPS-Modus aktiviert werden soll. Der Wert 1 aktiviert den FIPS-Modus. Der Wert 0 deaktiviert den FIPS-Modus. Wenn diese Eigenschaft auf 1 festgelegt wurde und sich Windows nicht im FIPS-Modus befindet, wird der Installationsvorgang beendet. | 0 |
VDM_FORCE_DESKTOP_AGENT | Wenn Sie Horizon Agent auf einer Windows Server-Maschine installieren und als Einzelbenutzer-Horizon-Desktop anstatt als RDS-Host konfigurieren, legen Sie den Wert auf 1 fest. Diese Anforderung gilt für von vCenter Server verwaltete Maschinen und für nicht verwaltete Maschinen. Legen Sie für Gäste, die keine Windows Server-Gäste sind und die Anwendungssitzungen hosten, den Wert auf 0 fest. Diese MSI-Eigenschaft ist optional. |
0 |
In einem Befehl für die unbeaufsichtigte Installation können Sie die Eigenschaft ADDLOCAL zum Festlegen von Optionen verwenden, die das Horizon Agent-Installationsprogramm konfiguriert.
Die folgende Tabelle enthält die Horizon Agent-Optionen, die Sie an der Befehlszeile eingeben können. Für diese Optionen gibt es entsprechende Setup-Optionen, die Sie bei einer interaktiven Installation deaktivieren bzw. aktivieren können.
Wenn Sie nicht die Eigenschaft ADDLOCAL an der Befehlszeile eingeben, installiert Horizon Agent alle für interaktive Installationen standardmäßig vorgesehenen Optionen, wenn diese auf dem Gastbetriebssystem unterstützt werden. Bei der Verwendung von ADDLOCAL=ALL installiert Horizon Agent die gesamten folgenden Optionen sowohl standardmäßig als auch nicht standardmäßig, wenn diese auf dem Gastbetriebssystem unterstützt werden.
Weitere Informationen finden Sie im Tabelleneintrag ADDLOCAL in Befehlszeilenoptionen für Microsoft Windows Installer.
Wenn Sie mit ADDLOCAL die Funktionen einzeln angeben (Sie müssen ADDLOCAL=ALL nicht festlegen), müssen Sie immer Core angeben.
Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* | Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -eq 'VMware Horizon Agent'} | Format-Table –AutoSizeDie Ausgabe:
DisplayName ModifyPath VMware Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
Das folgende Beispiel ändert und entfernt die USB-Komponente aus einer vorhandenen Installation: VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn REMOVE=USB"
Im folgenden Beispiel wird die Agent-Installation durch Ersetzen von Horizon Performance Tracker durch das Horizon-Helpdesk-Tool geändert: VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”
Im folgenden Beispiel wird die Installation des Agents durch Hinzufügen des seriellen Ports und der Scannerumleitung geändert: VMware-Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”
Option für die unbeaufsichtigte Installation | Benutzerdefinierte Setup-Option in einer interaktiven Installation | Standardmäßig interaktiv installiert oder wenn ADDLOCAL nicht verwendet wird |
---|---|---|
Core | Die Horizon Agent-Core-Funktionen. Wenn Sie ADDLOCAL=ALL angeben, werden alle Core-Funktionen installiert. |
Ja |
USB | USB-Umleitung | Nein |
NGVC | Instant-Clone-Agent | Nein |
RTAV | Echtzeit-Audio/Video | Ja |
ClientDriveRedirection | Clientlaufwerksumleitung | Ja |
SerialPortRedirection | Umleitung für seriellen Port | Nein |
ScannerRedirection | Scannerumleitung | Nein |
GEOREDIR | Geolocation-Umleitung | Nein |
V4V | Horizon Monitoring Service Agent | Ja |
SmartCard | Smartcard Standardmäßig wird diese Funktion nicht in einer interaktiven Installation installiert. |
Nein |
VmwVaudio | VMware-Audio (virtueller Audio-Treiber) | Ja |
VmwVidd | Indirekter VMware-Anzeigetreiber | Ja
Hinweis: vmwVidd wird nur dann in der Registrierung installiert und als lokal markiert, wenn:
VmwVidd wird in der Registrierung in Windows Server 2019 (Version 1809) std und datacenter mit der RDS-Rolle als Absent installiert und festgelegt. VmwVidd wird in der Registrierung in Windows Server 2022 mit der RDS-Rolle als Local installiert und festgelegt. |
TSMMR | Windows Media-Multimedia-Umleitung (MMR) | Ja |
RDP | Aktiviert das RDP-Protokoll in der Registrierung, wenn Sie die RDP_CHOICE=1-Eigenschaft in der Befehlszeile verwenden oder wenn Sie RDP als Standardanzeigeprotokoll für das Erstellen oder Bearbeiten eines Desktop-Pools ausgewählt haben. Diese Funktion wird bei interaktiven Installationen nicht angezeigt. |
Ja |
RDSH3D | 3D-Rendering auf RDS-Hosts | Nein |
BlastUDP | UDP-Transportunterstützung für Blast | Ja |
SdoSensor | SDO-Sensor-Umleitung | Nein |
PerfTracker | Horizon Performance Tracker | Nein |
HelpDesk | Horizon Help Desk Tool | Ja |
PrintRedir | VMware Integrated Printing | Ja |
PSG | Diese Funktion fügt einen Registrierungseintrag ein, der dem Verbindungsserver übermittelt, ob Horizon Agent IPv4 oder IPv6 verwendet. | Ja |