Installieren über die Befehlszeile
Dieser Artikel gilt für die Installation von Komponenten auf Maschinen mit Windows-Betriebssystem. Informationen zu VDAs für Linux finden Sie in der Dokumentation zum Linux Virtual Delivery Agent.
Wichtig:
In diesem Abschnitt wird die Verwendung von Produktinstallationsbefehlen beschrieben. Lesen Sie vor Beginn jeglicher Installation die Informationen unter Vorbereiten der Installation. Dieser Artikel enthält Beschreibungen der Installationsprogramme.
Sie müssen der Originaladministrator sein oder verwenden Sie Als Administrator ausführen, um den Fortschritt der Befehlsausführung und die Rückgabewerte anzuzeigen. Weitere Informationen finden Sie in der Microsoft-Befehlsdokumentation.
Als Ergänzung zu den Installationsbefehlen enthält das Produkt-ISO-Image Beispielskripts zum Installieren, Aktualisieren und Entfernen von VDA-Maschinen in bzw. aus Active Directory. Weitere Informationen finden Sie unter Installieren von VDAs mit Skripts.
Verwenden des Produktinstallationsprogramms
Zugreifen auf die Befehlszeilenschnittstelle des Komplettinstallationsprogramms
- Laden Sie das Produktpaket von Citrix herunter. Zum Zugriff auf die Downloadsite benötigen Sie Citrix Kontoanmeldeinformationen.
- Entpacken Sie die Datei. Optional können Sie die ISO-Datei auch auf DVD brennen.
- Melden Sie sich mit einem lokalen Administratorkonto am Server an, auf dem Sie die Komponenten installieren.
- Legen Sie die DVD in das Laufwerk ein oder stellen Sie die ISO-Datei bereit.
- Führen Sie im Verzeichnis
\x64\XenDesktop Setupauf dem Medium den entsprechenden Befehl aus.
Installieren von Kernkomponenten
Führen Sie den Befehl XenDesktopServerSetup.exe mit den unter Befehlszeilenoptionen zur Installation der Kernkomponenten beschriebenen Optionen aus.
Installieren eines VDAs
Führen Sie den Befehl XenDesktopVDASetup.exe mit den unter Befehlszeilenoptionen zur VDA-Installation beschriebenen Optionen aus.
Installieren des universellen Druckservers
Folgen Sie den Anweisungen unter Installieren des universellen Druckservers an der Befehlszeile.
Installieren des Verbundauthentifizierungsdiensts
Citrix empfiehlt die Verwendung der grafischen Oberfläche.
Installieren der Self-Service-Kennwortzurücksetzung
Folgen Sie den Anweisungen in der Dokumentation zum Self-Service-Kennwortzurücksetzungsdienst.
Verwenden eines dedizierten VDA-Installationsprogramms
Zum Zugriff auf die Downloadsite benötigen Sie Citrix Kontoanmeldeinformationen. Für die Installation benötigen Sie erhöhte Administratorprivilegien oder verwenden Sie die Option Als Administrator ausführen.
- Laden Sie das benötigte Paket von Citrix herunter.
| Name der Komponenten auf der Downloadseite | Name der Installationsdatei |
|---|---|
| Server OS Virtual Delivery Agent <Version> | VDAServerSetup.exe |
| Desktop OS Virtual Delivery Agent <Version> | VDAWorkstationSetup.exe |
| Desktop OS Core Services Virtual Delivery Agent <Version> | VDAWorkstationCoreSetup.exe |
- Extrahieren Sie entweder zunächst die Dateien aus dem Paket in ein vorhandenes Verzeichnis und führen Sie dann den Installationsbefehl aus oder führen Sie das Paket direkt aus.
Verwenden Sie zum Extrahieren der Dateien vor der Installation /extract mit dem absoluten Pfad, z. B.: .\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia (Das Verzeichnis muss vorhanden sein. Andernfalls schlägt die Extraktion fehl.) Führen Sie dann mit einem separaten Befehl XenDesktopVdaSetup.exe in dem Verzeichnis mit dem extrahierten Inhalt aus (im Beispiel oben wäre dies CitrixVDAInstallMedia). Verwenden Sie die unter Befehlszeilenoptionen zur VDA-Installation aufgeführten, zulässigen Optionen.
Um das heruntergeladene Paket auszuführen, führen Sie den Namen aus: VDAServerSetup.exe, VDAWorkstationSetup.exe oder VDAWorkstationCoreSetup.exe. Verwenden Sie die unter Befehlszeilenoptionen zur VDA-Installation aufgeführten, zulässigen Optionen.
Hinweis für Personen, die mit dem Produktinstallationsprogramm vertraut sind:
-
Führen Sie den eigenständigen Installer
VDAServerSetup.exeaus oderVDAWorkstationSetup.exe. Die Verwendung des Befehls ist mit der vonXenDesktopVdaSetup.exeidentisch. -
Das Installationsprogramm
VDAWorkstationCoreSetup.exeist anders, da es nur einen Teil der Optionen der anderen Installationsprogramme unterstützt.
Befehlszeilenoptionen zur Installation der Kernkomponenten
Die folgenden Optionen sind bei Installation der Kernkomponenten mit dem Befehl XenDesktopServerSetup.exe zulässig. Weitere Informationen zu den Optionen finden Sie unter Installieren der Kernkomponenten.
/components <component> [,<component>] …
Durch Trennzeichen getrennte Liste der zu installierenden oder zu entfernenden Komponenten. Gültige Werte:
CONTROLLER: Controller
DESKTOPSTUDIO: Studio
DESKTOPDIRECTOR: Director
LICENSESERVER: Citrix Lizenzserver
Wenn diese Option ausgelassen wird, werden alle Komponenten installiert (bzw. entfernt, wenn die Option /remove ebenfalls angegeben ist).
(In Versionen vor 7.15 LTSR CU6 war StoreFront als Wert gültig. Verwenden Sie ab Version 7.15 LTSR CU6 den dedizierten, unter Installieren von StoreFront aufgeführten StoreFront-Installationsbefehl).
/configure_firewall
Öffnet alle Ports in der Windows-Firewall, die von den installierten Komponenten verwendet werden, wenn der Windows-Firewalldienst ausgeführt wird, selbst wenn die Firewall nicht aktiviert ist. Wenn Sie die Firewall eines Drittanbieters verwenden oder keine Firewall verwenden, müssen die Ports manuell geöffnet werden.
/disableexperiencemetrics
Verhindert das automatische Senden der bei Installation, Upgrade oder Deinstallation erfassten Analysedaten an Citrix.
/exclude
Verhindert die Installation der in geraden Anführungszeichen angegebenen (durch Kommas getrennten) Features, Dienste oder Technologien. Gültige Werte:
Local Host Cache Storage (LocalDB): Verhindert die Installation der für den lokalen Hostcache verwendeten Datenbank. Diese Option hat keine Auswirkungen darauf, ob SQL Server Express zur Verwendung als Sitedatenbank installiert wird.
Smart Tools Agent: verhindert die Installation des Citrix Smart Tools Agent.
Hinweis:
Ab CU4 ist Smart Tools nicht mehr im Installationsprogramm enthalten. Smart Tools-Instanzen aus früheren Installationen bleiben ohne Veränderung.
/help oder /h
Zeigt die Hilfe für Befehle an.
/installdir <directory>
Vorhandenes leeres Verzeichnis, in dem die Komponenten installiert werden. Standardeinstellung = c:\Program Files\Citrix.
/logpath <path>
Speicherort der Protokolldateien. Der angegebene Ordner muss vorhanden sein. Er wird von dem Installationsprogramm nicht erstellt. Standard = "%TEMP%\Citrix\XenDesktop Installer"
/ no_remote_assistance
Gilt nur bei der Installation von Director. Deaktiviert das Feature zur Benutzerspiegelung, welches Microsoft-Remoteunterstützung verwendet.
/noreboot
Verhindert einen Neustart nach der Installation. (Bei den meisten Kernkomponenten ist ein Neustart in der Standardeinstellung nicht aktiviert).
/nosql
Verhindert die Installation von Microsoft SQL Server Express auf dem Server, auf dem Sie den Controller installieren. Wenn diese Option ausgelassen wird, wird SQL Server Express zur Verwendung als Sitedatenbank installiert. Diese Option hat keine Auswirkungen auf die Installation von SQL Server Express LocalDB für den lokalen Hostcache.
/quiet oder /passive
Während der Installation wird keine Benutzeroberfläche angezeigt. Der einzige Hinweis auf den Installationsvorgang ist im Windows Task-Manager. Wenn diese Option ausgelassen wird, wird die grafische Oberfläche gestartet.
/remove
Entfernt die mit /components angegebenen Kernkomponenten.
/removeall
Entfernt alle installierten Kernkomponenten.
/sendexperiencemetrics
Sendet automatisch bei Installation, Upgrade oder Deinstallation erfasste Analysedaten an Citrix. Wenn diese Option ausgelassen wird (oder /disableexperiencemetrics angegeben wird), werden Analysedaten lokal erfasst, aber nicht automatisch gesendet.
/tempdir <directory>
Das Verzeichnis, das die temporären Dateien während der Installation enthält. Standard = C:\Windows\Temp.
/xenapp
Installiert XenApp. Wenn diese Option ausgelassen wird, wird XenDesktop installiert.
Beispiele: Installieren der Kernkomponenten
Mit dem folgenden Befehl werden ein XenDesktop-Controller, Studio, die Citrix Lizenzierung und SQL Server Express auf einem Server installiert. Für die Komponentenkommunikation erforderliche Firewallports werden automatisch geöffnet.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall
Mit dem folgenden Befehl werden ein XenApp-Controller, Studio und SQL Server Express auf dem Server installiert. Für die Komponentenkommunikation erforderliche Firewallports werden automatisch geöffnet.
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components controller,desktopstudio /configure_firewall
Befehlszeilenoptionen zur VDA-Installation
Die folgenden Optionen sind für einen oder mehrere der folgenden Befehle gültig: XenDesktopVDASetup.exe, VDAServerSetup.exe, VDAWorkstationSetup.exe oder VDAWorkstationCoreSetup.exe.
/baseimage
Nur bei Installation von VDAs für Desktopbetriebssysteme auf einer VM zulässig. Ermöglicht die Verwendung von persönlichen vDisks mit einem Masterimage. Einzelheiten finden Sie unter Personal vDisk.
Diese Option ist ungültig, wenn Sie das Installationsprogramms VDAWorkstationCoreSetup.exe verwenden.
/components <component>[,<component>]
Durch Trennzeichen getrennte Liste der zu installierenden oder zu entfernenden Komponenten. Gültige Werte:
VDA: Virtual Delivery Agent
PLUGINS: Citrix Receiver für Windows (CitrixReceiver.exe)
Beispiel: Um den VDAs ohne Citrix Receiver zu installieren, geben Sie /components vda an.
Wenn diese Option ausgelassen wird, werden alle Komponenten installiert.
Diese Option ist ungültig, wenn Sie das Installationsprogramms VDAWorkstationCoreSetup.exe verwenden. Mit dem Installationsprogramm kann Citrix Receiver nicht installiert werden.
/controllers “<controller> [<controller>] […]”
Durch Leerzeichen getrennte FQDNs der Controller, mit denen VDA kommunizieren kann; von geraden Anführungszeichen umschlossen. Geben Sie nicht sowohl die Option /site_guid als auch die Option /controllers an.
/disableexperiencemetrics
Verhindert das automatische Senden der bei Installation, Upgrade oder Deinstallation erfassten Analysedaten an Citrix.
/enable_framehawk_port
Öffnet die von Framehawk verwendeten UDP-Ports. Standard = false
/enable_hdx_3d_pro
Installiert den VDA im HDX 3D Pro-Modus.
/enable_hdx_ports
Öffnet die erforderlichen Ports in der Windows-Firewall für den VDA und aktivierte Features (mit Ausnahme von Windows-Remoteunterstützung), wenn die Windows-Firewall erkannt wird (selbst wenn sie nicht aktiviert ist). Wenn Sie eine andere oder keine Firewall verwenden, müssen die Ports manuell geöffnet werden. Weitere Informationen zu Ports finden Sie unter Netzwerkports.
Um UDP-Ports zu öffnen, die der adaptive HDX-Transport verwendet, geben Sie zusätzlich zu /enable_hdx_udp_ports die Option /enable_hdx_ports an.
/enable_hdx_udp_ports
Öffnet die für den adaptiven HDX-Transport erforderlichen UDP-Ports in der Windows-Firewall, wenn der Windows-Firewalldienst erkannt wird, selbst wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere oder keine Firewall verwenden, müssen die Ports manuell geöffnet werden. Weitere Informationen zu Ports finden Sie unter Netzwerkports.
Um andere Ports zu öffnen, die der VDA verwendet, geben Sie die Option /enable_hdx_ports und die Option /enable_hdx_udp_ports an.
/enable_real_time_transport
Aktiviert oder deaktiviert die Verwendung von UDP für Audiopakete (Real-Time Audio Transport für Audio). Das Aktivieren dieses Features kann die Audioleistung verbessern. Verwenden Sie die Option /enable_hdx_ports, wenn Sie möchten, dass die UDP-Ports automatisch bei Erkennung des Windows-Firewalldiensts geöffnet werden.
/enable_remote_assistance
Aktiviert das Spiegelungsfeature in der Microsoft-Remoteunterstützung für die Verwendung mit Director. Wenn Sie diese Option angeben, öffnet die Windows-Remoteunterstützung die dynamischen Ports in der Firewall.
/exclude “<component>”[,”<component>”]
Verhindert die Installation der in geraden Anführungszeichen angegebenen (durch Kommas getrennten) optionalen Komponenten. Beispiel: Installieren oder Aktualisieren eines VDAs auf einem Image, das nicht mit MCS verwaltetet werden soll, erfordert keine Personal vDisk- oder Maschinenidentitätsdienstkomponenten. Gültige Werte:
Personal vDiskMachine Identity ServiceCitrix User Profile ManagerCitrix User Profile Manager WMI PluginCitrix Universal Print ClientCitrix Telemetry ServiceCitrix Personalization for App-V - VDA
Ausschließen der Citrix User Profilverwaltung aus der Installation (mit der Option /exclude "Citrix User Profile Manager") hat Auswirkungen auf die Überwachung und Problembehandlung von VDAs mit Citrix Director. Auf den Seiten Benutzerdetails und Endpunkt treten Fehler in den Bereichen Personalisierung und Anmeldedauer auf. Auf den Seiten Dashboard und Trends werden im Bereich Durchschnittliche Anmeldedauer nur Daten für Maschinen angezeigt, auf denen die Profilverwaltung installiert ist.
Selbst bei Verwendung der Profilverwaltungslösung eines Drittanbieters empfiehlt Citrix, dass Sie die Citrix Profilverwaltung installieren und ausführen. Die Citrix Profilverwaltung muss nicht aktiviert werden.
Diese Option ist ungültig, wenn Sie das Installationsprogramms VDAWorkstationCoreSetup.exe verwenden. Das Installationsprogramm schließt viele dieser Elemente automatisch aus.
/h oder /help
Zeigt die Hilfe für Befehle an.
/hdxflashv2only
Verhindert zur Erhöhung der Sicherheit die Installation der Legacy-Binärdateien der Flash-Umleitung.
Diese Option ist bei der grafischen Oberfläche nicht verfügbar.
/installdir <directory>
Vorhandenes leeres Verzeichnis, in dem die Komponenten installiert werden. Standardeinstellung = c:\Program Files\Citrix.
/logpath <path>
Speicherort der Protokolldateien. Der angegebene Ordner muss vorhanden sein. Er wird von dem Installationsprogramm nicht erstellt. Standard = "%TEMP%\Citrix\XenDesktop Installer"
Diese Option ist bei der grafischen Oberfläche nicht verfügbar.
/masterimage
Gilt nur für die Installation von VDAs auf einer VM. Richtet VDA als Masterimage ein.
Diese Option ist ungültig, wenn Sie das Installationsprogramms VDAWorkstationCoreSetup.exe verwenden.
/no_mediafoundation_ack
Bestätigt, dass Microsoft Media Foundation nicht installiert ist und mehrere HDX-Multimediafeatures nicht installiert werden und nicht funktionieren. Wenn diese Option ausgelassen wird und Media Foundation nicht installiert ist, schlägt die VDA-Installation fehl. Bei den meisten unterstützten Windows-Editionen ist Media Foundation bereits installiert. Eine Ausnahme bilden die N-Editionen.
/nocitrixwddm
Gilt nur für Windows 7-Maschinen, die keine WDDM-Treiber enthalten. Deaktiviert die Installation des Citrix WDDM-Treibers.
Diese Option ist bei der grafischen Oberfläche nicht verfügbar.
/nodesktopexperience
Gilt nur für die Installation von VDAs für Serverbetriebssysteme. Verhindert das Aktivieren der Enhanced Desktop Experience. Dieses Feature wird auch über die Citrix Richtlinieneinstellung Enhanced Desktop Experience gesteuert.
/noreboot
Verhindert einen Neustart nach der Installation. Der VDA kann erst nach einem Neustart verwendet werden.
/noresume
Wenn während einer Installation ein Maschinenneustart erforderlich ist, wird das Installationsprogramm automatisch fortgesetzt, sobald der Neustart abgeschlossen ist. Um den Standardwert zu überschreiben, geben Sie /noresume an. Dies kann hilfreich sein, wenn Sie das Medium neu laden müssen oder während einer automatischen Installation Informationen erfassen möchten.
/optimize
Gilt nur für die Installation von VDAs auf einer VM. Aktiviert die Optimierung für VDAs, die auf einer VM auf einem Hypervisor ausgeführt werden. Die VM-Optimierung umfasst das Deaktivieren von Offlinedateien, das Deaktivieren der Hintergrunddefragmentierung und die Verkleinerung der Ereignisprotokollgröße. Geben Sie diese Option nicht für Remote-PC-Bereitstellungen an. Weitere Informationen finden Sie unter CTX224676.
/portnumber <port>
Gilt nur, wenn die Option /reconfig angegeben wurde. Portnummer für die Kommunikation zwischen VDA und dem Controller. Der zuvor konfigurierte Port wird deaktiviert, es sei denn, es handelt sich um Port 80.
/quiet oder /passive
Während der Installation wird keine Benutzeroberfläche angezeigt. Der einzige Hinweis auf den Installations- und Konfigurationsvorgang ist im Windows Task-Manager. Wenn diese Option ausgelassen wird, wird die grafische Oberfläche gestartet.
/reconfigure
Passt die zuvor konfigurierten VDA-Einstellungen an, wenn der Befehl mit den Optionen /portnumber, /controllers oder /enable_hdx_ports verwendet wird. Wenn Sie diese Option ohne die Option /quiet angeben, wird die grafische Oberfläche zum Anpassen von VDA gestartet.
/remotepc
Gilt nur für Remote-PC-Zugriff-Bereitstellungen. Verhindert die Installation der folgenden Komponenten unter einem Desktopbetriebssystem:
- Citrix Personalisierung für App-V
- Citrix User Profile Manager
- Citrix User Profile Manager WMI Plug-In
- Maschinenidentitätsdienst
- Personal vDisk
Diese Option ist ungültig, wenn Sie das Installationsprogramms VDAWorkstationCoreSetup.exe verwenden. Das Installationsprogramm schließt diese Komponenten automatisch aus.
/remove
Entfernt die mit /components angegebenen Komponenten.
/removeall
Entfernt alle installierten VDA-Komponenten.
/sendexperiencemetrics
Sendet automatisch bei Installation, Upgrade oder Deinstallation erfasste Analysedaten an Citrix. Wenn diese Option ausgelassen wird (oder die Option /disableexperiencemetrics angegeben wird), werden Analysedaten lokal erfasst, aber nicht automatisch gesendet.
/servervdi
Installiert einen VDA für Desktopbetriebssysteme auf einem unterstützten Windows-Server. Lassen Sie diese Option aus, wenn Sie einen VDA für Serverbetriebssysteme auf einem Windows-Server installieren. Lesen Sie vor dem Verwenden dieser Option Server-VDI.
Verwenden Sie diese Option nur mit dem VDA-Installationsprogramm für das vollständige Produkt. Diese Option ist bei der grafischen Oberfläche nicht verfügbar.
/site_guid <guid>
GUID (Globally Unique Identifier) der Website Active Directory Organisationseinheit (OU). Dabei wird ein virtueller Desktop einer Site zugeordnet, wenn Active Directory für die Discovery verwendet wird (das Feature für automatische Updates ist die empfohlene und Discovery-Standardmethode). Die Site-GUID ist eine Site-Eigenschaft, die in Studio angezeigt wird. Geben Sie nicht sowohl die Option /site_guid als auch die Option /controllers an.
/tempdir <directory>
Das Verzeichnis für die temporären Dateien während der Installation. Standardeinstellung = c:\Windows\Temp.
Diese Option ist bei der grafischen Oberfläche nicht verfügbar.
/virtualmachine
Gilt nur für die Installation von VDAs auf einer VM. Überschreibt das Erkennen einer physischen Maschine durch den Installer. Dabei werden BIOS-Informationen an die VMs weitergegeben, sodass sie als physische Maschinen erscheinen.
Diese Option ist bei der grafischen Oberfläche nicht verfügbar.
Beispiele: Installieren eines VDAs
Installieren eines VDAs mit dem Komplettinstallationsprogramm
Mit dem folgenden Befehl wird ein VDA für Desktopbetriebssysteme und Citrix Receiver am Standardspeicherort auf einer VM installiert. VDA wird als Masterimage verwendet. Der VDA registriert sich anfänglich am Controller auf dem “Contr-Main” genannten Server in der Domäne “mydomain” und verwendet Personal vDisks, das Optimierungsfeature und die Windows-Remoteunterstützung.
\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /optimize /masterimage /baseimage /enable_remote_assistance
Installation eines Desktopbetriebssystem-VDAs mit dem eigenständigen Installationsprogramm VDAWorkstationCoreSetup
Mit dem folgenden Befehl wird ein Kernkomponenten-VDA unter einem Desktopbetriebssystem zur Verwendung in einer Remote-PC-Zugriff- oder VDI-Bereitstellung installiert. Citrix Receiver und andere, nicht zu den Kernkomponenten gehörenden Dienste werden nicht installiert. Die Adresse eines Controllers wird automatisch angegeben und die Ports der Windows-Firewall werden automatisch geöffnet. Der Administrator steuert die Neustarts.
VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
Anpassen eines VDAs über die Befehlszeile
Nachdem VDA installiert wurde, können Sie einige Einstellungen anpassen. Führen Sie auf dem Produktmedium im \x64\XenDesktop Setup-Verzeichnis den Befehl XenDesktopVdaSetup.exe aus und legen Sie dabei eine oder mehrere der folgenden, unter Befehlszeilenoptionen zur VDA-Installation beschriebenen Optionen fest:
-
/reconfigure(zum Anpassen des VDAs erforderlich) -
/hoder/help /quiet/noreboot/controllers-
/portnumberPort /enable_hdx_ports
Installieren des universellen Druckservers über die Befehlszeile
Führen Sie einen der folgenden Befehle auf jedem Druckserver aus:
- Auf einem unterstützten 32-Bit-Betriebssystem: Führen im Verzeichnis
\x86\Universal Print Server\auf dem Citrix InstallationsmediumUpsServer_x86.msiaus. - Auf einem unterstützten 64-Bit-Betriebssystem: Führen im Verzeichnis
\x64\Universal Print Server\auf dem Citrix InstallationsmediumUpsServer_x64.msiaus.
Nach der Installation des universellen Druckservers auf den Druckservern konfigurieren Sie diesen anhand der Anweisungen unter Bereitstellen von Druckern.
In diesem Artikel
- Verwenden des Produktinstallationsprogramms
- Verwenden eines dedizierten VDA-Installationsprogramms
- Befehlszeilenoptionen zur Installation der Kernkomponenten
- Beispiele: Installieren der Kernkomponenten
- Befehlszeilenoptionen zur VDA-Installation
- Beispiele: Installieren eines VDAs
- Anpassen eines VDAs über die Befehlszeile
- Installieren des universellen Druckservers über die Befehlszeile