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.
Hinweis: In den unten beschriebenen Schritten wird der Name agent-installer.exe verwendet, um auf die Installationsdatei zu verweisen.
MSI-Eigenschaften für die unbeaufsichtigte Installation von Horizon Agent
| 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 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. | 0 |
| INSTALLDIR | Pfad und Ordner, in dem die Horizon Agent-Software installiert ist. 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. | %ProgramFiles%\Omnissa\Horizon\Agent |
| 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.Mit dem Wert 1 wird die Prüfung auf RunOnce-Registrierungsschlüssel übersprungen. Der Standardwert ist 0, wenn er nicht in der Befehlszeile festgelegt wurde. | 0 (wenn er nicht in der Befehlszeile festgelegt wurde) |
| URL_FILTERING_ENABLED | Gibt an, 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 werden die Desktops als physische Computer und als Computer, die nicht von vSphere verwaltet werden, 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 zu einer 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 | Hostname oder IP-Adresse der Verbindungsserver-Instanz, auf der das Horizon Agent-Installationsprogramm einen nicht verwalteten Desktop registriert. Diese MSI-Eigenschaft gilt nur für nicht verwaltete Desktops.
Zum Beispiel: VDM_SERVER_NAME=10.123.01.01
Verwenden Sie diese MSI-Eigenschaft nicht für virtuelle Desktops, die von vCenter Server verwaltet werden. Erinnerung: Auf dieser Seite werden die Parameter für die Installation des Horizon Agent auf einer Windows-Maschine beschrieben. VDM_SERVER_NAME ist der korrekte Parametername für diesen Anwendungsfall der Installation des Horizon Agent und Angabe der Verbindungsserver-Instanz. Dies unterscheidet sich von dem Anwendungsfall, in dem Sie versuchen, Horizon Client auf einer Windows-Maschine zu installieren. Dieser clientbezogene Anwendungsfall hat einen ähnlichen, aber anderen Parameternamen, um den Verbindungsserver für die Horizon Client-Installation anzugeben. Wenn Sie sich mit dem Anwendungsfall der Installation von Horizon Client für Windows beschäftigen, lesen Sie stattdessen das Handbuch zu Omnissa Horizon Client für Windows und die zugehörige Seite zur Installation von Horizon Client für Windows mithilfe der Befehlszeile. | Keine |
| VDM_SERVER_USERNAME | Der Benutzername des Administrators auf der Verbindungsserver-Instanz. Diese MSI-Eigenschaft gilt nur für nicht verwaltete Desktops.
Zum Beispiel: VDM_SERVER_USERNAME=domain\username
Verwenden Sie diese MSI-Eigenschaft nicht für virtuelle Desktops, die von vCenter Server verwaltet werden. | Keine |
| VDM_SERVER_PASSWORD | Kennwort der Verbindungsserver-Administratorbenutzers. Diese MSI-Eigenschaft gilt nur für nicht verwaltete Desktops.
Zum Beispiel: VDM_SERVER_PASSWORD=secret
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 | Gibt 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 |
| VDM_PAIRING_MECHANISM | Gibt die Kopplungsmethode an. Die folgenden Werte sind zulässig:
1 = Hostnamen des Verbindungsservers angeben (Standard). Erfordert VDM_SERVER_NAME, VDM_SERVER_USERNAME und VDM_SERVER_PASSWORD. 2 = Verbindungsserver automatisch ermitteln. Keine Anmeldedaten erforderlich. 3 = Pod-Name angeben. Erfordert VDM_POD_NAME. Keine Anmeldedaten erforderlich. Hinweis: Um die Werte 2 und 3 verwenden zu können, muss der Computer vor der Agent-Installation in Horizon Console registriert werden. | 1 |
| VDM_POD_NAME | Gibt den Namen des Pods an. Beispiel: VDM_POD_NAME=HorizonPodName Erforderlich, wenn VDM_PAIRING_MECHANISM=3. | Keine |
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 zeigt die Horizon Agent-Optionen, die Sie über die 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.
Sie können Funktionen mithilfe der ADDLOCAL- und REMOVE-MSI-Eigenschaften ändern. Verwenden Sie den folgenden PowerShell-Befehl, um die Registrierung der installierten Komponenten auf dem System, auf dem Horizon Agent installiert ist, für die Basisbefehlszeile ModifyPath anzufordern:
Get-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\* |
Select-Object DisplayName, ModifyPath | Where-Object {$_.DisplayName -like '*Horizon Agent*'} | Format-Table –AutoSize
Die Ausgabe:
DisplayName ModifyPath
Omnissa Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
Hinweis: In den folgenden Beispielen ist der Name agent-installer der Installationsdatei für Horizon Agent für Windows. Sie müssen Ihren tatsächlichen Dateinamen ersetzen.
Das folgende Beispiel ändert und entfernt die USB-Geräte aus einer vorhandenen Installation: agent-installer.exe /s /v"/qn REMOVE=USB"
Das folgende Beispiel ändert die Installation des Agents durch Ersetzen von Horizon Performance Tracker durch das Horizon Help Desk Tool: agent-installer.exe /s /v"/qn ADDLOCAL=HelpDesk REMOVE=PerfTracker”
Das folgende Beispiel ändert die Installation des Agent durch Hinzufügen des seriellen Ports und der Scannerumleitung: agent-installer.exe /s /v"/qn ADDLOCAL=SerialPortRedirection,ScannerRedirection”
Optionen für die unbeaufsichtigte Horizon Agent-Installation und benutzerdefinierte Setup-Optionen bei einer interaktiven Installation
| Option für die unbeaufsichtigte Installation | Benutzerdefinierte Setup-Option in einer interaktiven Installation | Wird standardmäßig interaktiv oder bei Nichtverwendung von ADDLOCAL installiert |
|---|---|---|
| Core | Die Horizon Agent-Hauptfunktionen. 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 |
| Veraltet: V4V | Die Option V4V ist ab Horizon 8 Version 2412 veraltet und nicht mehr im Installationsprogramm enthalten. | Nein |
| SmartCard | Smartcard Standardmäßig wird diese Funktion nicht in einer interaktiven Installation installiert. | Nein |
| HznVaudio | Audio (virtueller Audio-Treiber) | Ja |
| HznVidd, HznVidd2 | Indirekter Anzeigetreiber | Ja
Hierbei handelt es sich um verborgene, nicht optionale Komponenten, die immer installiert werden.
Hinweis: HznVidd wird nur dann installiert und in der Registrierung als Local markiert, wenn:
|
| 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 | Integrated Printing | Ja |
| PSG | Diese Funktion fügt einen Registrierungseintrag ein, der dem Verbindungsserver übermittelt, ob Horizon Agent IPv4 oder IPv6 verwendet. | Ja |
| StorageDriveRedir | Umleitung des Speicherlaufwerks | Nein |
War diese Seite hilfreich?