Sie können spezifische Eigenschaften einschließen, wenn Sie eine unbeaufsichtigte Installation von Horizon Agent ü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 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%\ |
| 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. | |
| 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 | 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 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 zu einer Installation eines verwalteten Horizon Agent. | Keine |
| VDM_SERVER_NAME | Hostname oder 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=domain\username
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 | 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 |
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 -eq 'Horizon
Agent'} | Format-Table –AutoSize
Die Ausgabe:
DisplayName ModifyPath
Horizon Agent MsiExec.exe /I{A17DD662-DFB3-4997-9C0F-4E687A300111}
Das folgende Beispiel ändert und entfernt die USB-Geräte aus einer vorhandenen Installation: -Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.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: -Horizon-Agent-x86-YYMM-y.y.y-xxxxxx.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: -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 | 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 |
| PCoIP | Agent des PCoIP-Protokolls | 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 |
| Vaudio | Horizon Audio (virtueller Audio-Treiber) | Ja |
| Vidd | Indirekter Anzeigetreiber | Ja
Hinweis: Vidd wird nur dann installiert und in der Registrierung als lokal 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 |
War diese Seite hilfreich?