Product Documentation

Installieren über die Befehlszeile

Jul 11, 2016

Einführung

Wichtig: Lesen Sie vor Beginn jeglicher Installation den Artikel Vorbereiten der Installation. Er enthält eine Beschreibung der Installationsprogramme und wichtige Informationen, mit denen Sie sich vor der Installation vertraut machen müssen. Außerdem werden die Optionen für die einzelnen Befehle erläutert. In diesem Abschnitt wird beschrieben, wie Sie die Befehlszeilenschnittstelle in einem Produktinstallationsprogramm starten.

Mit der Befehlszeilenschnittstelle können Sie folgende Aufgaben erledigen:

  • Installieren einer oder mehrerer der Kernkomponenten: Delivery Controller, Citrix Studio, Citrix Director, Lizenzserver und StoreFront.
  • Installieren von Virtual Delivery Agent (VDA) auf einem Masterimage bzw. auf einer virtuellen oder physischen Maschine. Sie können auch die Skripts anpassen, die auf dem Medium sind, und sie zum Installieren und Entfernen von VDAs in Active Directory verwenden.
  • Anpassen bereits installierter VDAs.
  • Installieren eines universellen Druckservers, der Netzwerksitzungsdrucker bereitstellt. Der Controller hat bereits die universelle Druckerserverfunktionalität; Sie müssen nur den universellen Druckserver auf den Druckservern in der Umgebung installieren.
  • Aktualisieren von Komponenten; Informationen hierzu finden Sie unter Upgrade einer Bereitstellung.

Mit den Optionen /remove oder /removeall können Sie zudem zuvor installierte Komponenten aus dieser Version entfernen. Weitere Informationen finden Sie im Artikel Entfernen von Komponenten.

Sie müssen der ursprüngliche Administrator sein oder Als Administrator ausführen verwenden, um den Fortschritt der Befehlsausführung und die Rückgabewerte anzuzeigen. Weitere Informationen finden Sie in der Microsoft-Befehlsdokumentation.

Das Produktinstallationsprogramm und das dedizierte VDA-Installationsprogramm haben beide eine Befehlszeilenschnittstelle.

Wenn Sie VDA-Maschinen mit den Beispielskripts installieren, aktualisieren oder aus Active Directory entfernen, können Sie die unten aufgeführten VDA-Konfigurationsoptionen im VDA-Abschnitt angeben. Weitere Informationen zu den Beispielskripts finden Sie im Artikel Installieren von VDAs mit Skripts.

Verwenden des Produktinstallationsprogramms

Sie können Kernkomponenten und VDAs mit dem Produktinstallationsprogramm installieren.

  • 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 Setupverzeichnis \x64\XenDesktop auf dem Medium folgenden Befehl aus:

XenDesktopServerSetup.exe zum Installieren der Kernkomponenten. Verwenden Sie die unten im Abschnitt Befehlszeilenoptionen zur Installation der Kernkomponenten aufgeführten Optionen.

XenDesktopVDASetup.exe zum Installieren eines VDAs. Verwenden Sie die unten im Abschnitt Befehlszeilenoptionen zur VDA-Installation aufgeführten Optionen.

Beispiele der Installation der Kernkomponenten mit dem Produktinstallationsprogramm

Beispiel 1: Mit dem folgenden Befehl werden ein XenDesktop-Controller, Studio, die Citrix Lizenzierung und SQL Server Express auf dem Server installiert. Für die Komponentenkommunikation erforderliche Ports werden automatisch geöffnet.

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components controller,desktopstudio,licenseserver /configure_firewall

Beispiel 2: Mit dem folgenden Befehl werden ein XenApp-Controller, Studio und SQL Server Express auf dem Server installiert. Für die Komponentenkommunikation erforderliche Ports werden automatisch geöffnet.

\x64\XenDesktop Setup\XenDesktopServerSetup.exe /xenapp /components  controller,desktopstudio /configure_firewall

Beispiele der VDA-Installation mit dem Produktinstallationsprogramm

Beispiel 1: Mit dem folgenden Befehl wird ein VDA für Windows-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

Beispiel 2: Mit dem folgenden Befehl wird ein VDA für Windows-Desktopbetriebssysteme und Citrix Receiver am Standardspeicherort eines Büro-PCs installiert, der mit Remote-PC-Zugriff verwendet wird. Nach der Installation von VDA wird die Maschine nicht neu gestartet. Ein Neustart ist jedoch erforderlich, bevor VDA verwendet werden kann. Der VDA registriert sich anfänglich am Controller auf dem "Contr-East" genannten Server in der Domäne "mydomain" und verwendet UDP für Audiopakete. HDX-Ports werden geöffnet, wenn der Windows-Firewalldienst erkannt wird.

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet  /components vda,plugins /controllers "Contr-East.mydomain.local" /enable_hdx_ports  /enable_real_time_transport /noreboot 

Verwenden des dedizierten VDA-Installationsprogramms

Wichtig: Informationen zu Elementen der Installation mit dem dedizierten VDA-Installationsprogramm, insbesondere zu Neustarts und dem für die Extraktion benötigen Speicherplatz, finden Sie unter Vorbereiten der Installation.

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.

  1. Laden Sie das benötigte Paket von Citrix herunter: VDAServerSetup.exe für Serverbetriebssystemmaschinen oder VDAWorkstationSetup.exe für Desktopbetriebssystemmaschinen Verwenden Sie für Einzelbenutzer-Einzelserverbereitstellungen (z. B. beim Bereitstellen von Windows Server 2012 für einen Benutzer zur Webentwicklung) das Paket VDAWorkstationSetup.exe. Weitere Informationen finden Sie im Artikel Server-VDI.
  2. Extrahieren Sie entweder zunächst die Dateien aus dem Paket 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. .\VDAWorkstationSetup.exe /extract %temp%\CitrixVDAInstallMedia. 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 unten im Abschnitt Befehlszeilenoptionen zur VDA-Installation aufgeführten Optionen.

Zu Ausführen des heruntergeladenen Pakets führen Sie dessen Namen VDAServerSetup.exe oder VDAWorkstationSetup.exe aus. Verwenden Sie die unten im Abschnitt Befehlszeilenoptionen zur VDA-Installation aufgeführten Optionen. Hinweis für Personen, die mit dem Produktinstallationsprogramm vertraut sind: Die Ausführung des heruntergeladenen eigenständigen Pakets ist mit dem Befehl "XenDesktopVdaSetup.exe" mit Ausnahme des Namens identisch.

Beispiel der VDA-Installation mit dem eigenständigen VDA-Installationsprogramm

Der nachfolgende Installationsbefehl wird oft für Remote-PC-Zugriff verwendet. Mit ihm wird ein VDA auf einem physischen Computer ohne Citrix Receiver oder Citrix Profile Manager installiert. Nach der Installation des VDA wird die Maschine nicht automatisch neu gestartet. Ein Neustart ist jedoch erforderlich, bevor der VDA verwendet werden kann. Zu Beginn wird der VDA auf dem Server 'Contr-East' beim Controller registriert. Wenn der Windows-Firewalldienst erkannt wird, werden Ports geöffnet.

VDAWorkstationSetup.exe /quiet /components vda /exclude "Citrix User Profile Manager" /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

Hinweis

Ausschließen von Citrix User Profile Manager aus der Installation hat Auswirkungen auf die Überwachung und Problembehandlung von VDAs mit Citrix Director. Auf den Seiten "Benutzerdetails" und "Endpunkte" 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 Profilverwaltung installiert ist.

Anpassen eines VDAs über die Befehlszeile

Nachdem VDA installiert wurde, können Sie einige Einstellungen anpassen. Führen Sie auf dem Produktmedium im Setupverzeichnis \x64\XenDesktop den Befehl XenDesktopVdaSetup.exe aus und legen Sie dabei eine oder mehrere der folgenden, im Abschnitt Befehlszeilenoptionen zur VDA-Installation unten beschriebenen Optionen fest:

  • /reconfigure: Diese Option ist zum Anpassen von VDA erforderlich
  • /h oder /help
  • /quiet
  • /noreboot
  • /controller
  • /portnumber port
  • /enable_hdx_ports

Befehlszeilenoptionen zur Installation der Kernkomponenten

In der folgenden Tabelle werden die für den Befehl XenDesktopServerSetup.exe verfügbaren Optionen aufgeführt.

Option

Beschreibung

/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
  • STOREFRONT – StoreFront

Wenn diese Option ausgelassen wird, werden alle Komponenten installiert (bzw. entfernt, wenn die Option /remove ebenfalls angegeben ist).

/configure_firewall

Öffnet alle Ports in der Windows-Firewall, die für die installierten Komponenten erforderlich sind, 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.

/help oder/h

Zeigt die Hilfe für Befehle an.

/installdir Verzeichnis

Vorhandenes leeres Verzeichnis, in dem die Komponenten installiert werden. Standard: C:\Programme\Citrix

/logpath Pfad

Speicherort der Protokolldateien. Der angegebene Ordner muss bereits vorhanden sein. Er wird nicht vom Installationsprogramm erstellt. Standard = "%TEMP%\Citrix\XenDesktop Installer"

/no_remote_assistance

(Gilt nur für die 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 installiert.

/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.

/tempdir Verzeichnis

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.

Befehlszeilenoptionen zur VDA-Installation

In der folgenden Tabelle werden die für den Befehl XenDesktopVDASetup.exe verfügbaren Optionen aufgeführt.

Bei der Installation von VDA für die Verwendung mit Remote-PC-Zugriff geben Sie nur Optionen ein, die auf physischen Maschinen (nicht VMs oder Masterimages) gültig und für VDAs für Windows-Desktopbetriebssysteme relevant sind.

Wenn nicht anders angegeben, gelten die Optionen für physische und virtuelle Maschinen sowie für VDAs für Windows-Desktopbetriebssysteme und VDAs für Windows-Serverbetriebssysteme.

Important

Verwenden Sie in XenApp und XenDesktop 7.9 die Befehlszeile nur für Remote-PC-Zugriff-Bereitstellungen und ändern Sie nicht die Syntax für /components und /remotepc. Beispiel:

VDAWorkstationSetup.exe /components vda /controllers "example.delivery.controller.net" /remotepc /EXCLUDE "AppDisks VDA Plug-in" /enable_hdx_ports /noreboot /quiet

Wenn /remotepc vor /components steht, wird die Option /remotepc ignoriert.

 

Option

Beschreibung

/baseimage

(Gilt nur für die Installation von VDA für Windows-Desktopbetriebssysteme auf einer VM.) Ermöglicht das Verwenden von persönlichen vDisks mit einem Masterimage. Weitere Informationen finden Sie im Artikel Personal vDisks.

/components component[,component]

Durch Trennzeichen getrennte Liste der zu installierenden oder zu entfernenden Komponenten. Gültige Werte:

  • VDA: Installation von VDA
  • PLUGINS: Installation von Citrix Receiver für Windows (CitrixReceiver.exe)

Verwenden Sie zum Beispiel zum Installieren des VDAs ohne Citrix Receiver "/components vda".

Wenn diese Option ausgelassen wird, werden alle Komponenten installiert.

/controllers "controller [controller] [...]"

Durch Leerzeichen getrennte, vollqualifizierte Domänennamen (FQDNs) der Controller, mit denen VDA kommunizieren kann; von Anführungszeichen umschlossen. Geben Sie nicht beide Optionen, /site_guid und /controllers, an.

/enable_framehawk_portÖffnet die von Framehawk verwendeten UDP-Ports. Standard = false

/enable_hdx_3d_pro

Installiert VDA für HDX 3D Pro. Weitere Informationen finden Sie im Artikel HDX 3D Pro.

/enable_hdx_ports

Öffnet die erforderlichen Ports für den Controller und die angegebenen Features (Windows-Remoteunterstützung, Echtzeitübertragung und Optimieren) 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.

/enable_real_time_transport

Aktiviert oder deaktiviert die Verwendung von UDP für Audiopakete (Echtzeittransport 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, wird der TCP-Port 3389 durch Windows in der Firewall geöffnet, selbst wenn die Option /enable_hdx_ports ausgelassen wird.

/exclude "component"[,"component"]

Verhindert die Installation der in Anführungszeichen angegebenen (durch Kommas getrennten) optionalen Komponenten. Beispiel: Installieren oder Aktualisieren eines VDAs auf einem nicht mit Maschinenerstellungsdiensten verwalteten Image erfordert keine Personal vDisk- oder Maschinenidentitätsdienstkomponenten. Gültige Werte:

  • Personal vDisk
  • Maschinenidentitätsdienst
  • Citrix User Profile Manager

Das Ausschließen von Citrix User Profile Manager aus der VDA-Installation hat Auswirkungen auf die Überwachung und Problembehandlung von VDAs mit Citrix Director. Auf den Seiten "Benutzerdetails" und "Endpunkte" 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 Profilverwaltung installiert ist.

/h oder /help

Zeigt die Hilfe für Befehle an.

/installdir Verzeichnis

Vorhandenes leeres Verzeichnis, in dem die Komponenten installiert werden. Standard: C:\Programme\Citrix

/logpath Pfad

Speicherort der Protokolldateien. Der angegebene Ordner muss bereits vorhanden sein. Er wird nicht vom Installationsprogramm erstellt.  (Diese Option ist bei der grafischen Oberfläche nicht verfügbar.) Standard = "%TEMP%\Citrix\XenDesktop Installer"

/masterimage

(Gilt nur für die Installation von VDA auf einer VM.) Richtet den VDA als Masterimage ein.

/no_appvVerhindert die Installation der Citrix App-V Komponenten. Weitere Informationen finden Sie im Artikel App-V.

/nocitrixwddm

(Gilt nur für Windows 7-Maschinen, die keine WDDM-Treiber enthalten.) Deaktiviert die Installation des Citrix WDDM-Treibers.

/nodesktopexperience

(Gilt nur für die Installation von VDA für Windows-Serverbetriebssysteme.) Verhindert das Aktivieren von Enhanced Desktop Experience. Dieses Feature wird auch über die Citrix Richtlinieneinstellung "Enhanced Desktop Experience" gesteuert.

/noreboot

Verhindert einen Neustart nach der Installation. VDA steht erst nach einem Neustart vollständig zur Verfügung.

/optimize

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 für Remote-PC-Zugriff nicht an. Weitere Informationen zum Optimierungstool finden Sie unter CTX125874.

/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.

/reconfig

Passt die zuvor konfigurierten VDA-Einstellungen an, wenn der Befehl mit den Optionen /portnumber, /Controller 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

Verhindert die Installation der folgenden Komponenten auf einem Desktopbetriebssystem (Workstation):

  • App V-Komponente: Citrix Personalisierung für App-V - VDA
  • UpmComponent: Citrix User Profile Manager
  • UpmVdaPlugin-Komponente: Citrix User Profile Manager WMI-Plug-In
  • Mps Component: Maschinenidentitätsdienst
  • VDisk-Komponente: Personal vDisk

Wenn diese Komponenten während eines Upgrades installiert werden, werden sie vom Installationsprogramm erkannt und aktualisiert.

/remove

Entfernt die mit /components angegebenen Komponenten.

/removeall

Entfernt alle installierten VDA-Komponenten.

/servervdi

Installiert einen VDA für Windows-Desktopbetriebssysteme auf einem unterstützten Windows Server. Lassen Sie diese Option aus, wenn Sie einen VDA für Windows-Serverbetriebssysteme auf einem Windows Server installieren. Lesen Sie vor dem Verwenden dieser Option den Artikel Server-VDI. (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 beide Optionen, /site_guid und /controllers, an.

/tempdir Verzeichnis

Das Verzeichnis für die temporären Dateien während der Installation. (Diese Option ist bei der grafischen Oberfläche nicht verfügbar.) Standard = C:\Windows\Temp.

/virtualmachine

(Gilt nur für die Installation von VDA 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.

/xa_server_location url

URL des Servers für Windows Serveranwendungen.

 

Installieren des universellen Druckservers über die Befehlszeile

Hinweis: Wenn Sie die UpsServer-Komponente auf einem Server mit der 32-Bit-Version von Windows 2008 installieren, führen Sie die unter Vorbereiten der Installation des universellen Druckservers unter Windows 2008 Server (32-Bit) beschriebenen Schritte aus.

Führen Sie einen der folgenden Befehle auf jedem Druckserver aus:

  • Unterstütztes 32-Bit-Betriebssystem: Führen Sie die Datei UpsServer_x86.msi aus, die sich auf dem Citrix Installationsmedium im Verzeichnis \x86\Universal Print Server\ befindet.
  • Unterstütztes 64-Bit-Betriebssystem: Führen Sie die Datei UpsServer_x64.msi aus, die sich auf dem Citrix Installationsmedium im Verzeichnis \x64\Universal Print Server\ befindet.

Nach der Installation des universellen Druckservers auf den Druckservern konfigurieren Sie diesen anhand der Anweisungen im Artikel Bereitstellen von Druckern.

Vorbereiten der Installation des universellen Druckservers unter Windows 2008 Server (32-Bit)

Zum Bereitstellen von UpsServer_x86.msi auf einer Windows 2008-32-Bit-Maschine müssen Sie die Mindestversion für Windows Installer für cdf_x86.msi und UpsServer_x86.msi mit Visual Basic-Skripts oder einem Tool wie Orca anpassen.

  1. Kopieren Sie die 32-Bit-Version des CDF- und des UPS-Installationspakets (cdf_x86.msi und UpsServer_x86.msi) in einen temporären Ordner.
  2. Installieren Sie das WiSumInf.vbs-Skript oder Orca. Beides ist in dem Paket Windows SDK Components for Windows Installer Developers enthalten. Informationen zu dem Skript finden Sie in dem MSDN-Artikel Manage Summary Information.
  3. Ändern Sie die Mindestversion für Windows Installer mit einer der folgenden Methoden:

WiSumInf.vbs-Skript: Kopieren Sie die Datei WiSumInf.vbs in denselben temporären Ordner wie die beiden Citrix MSI-Pakete. Führen Sie dann das Skript für jedes Pakets mit den Parametern WiSumInf.vbs cdf_x86.msi Pages=405 und WiSumInf.vbs UpsServer_x86.msi Pages=405 aus.

Orca: Öffnen Sie jeweils das Paket cdf_x86.msi und UpsServer_x86.msi, wählen Sie im Menü "View" die Option "Summary Information" aus und ändern Sie den Wert im Textfeld Schema in 405.

Nach Abschluss des oben beschriebenen Verfahrens installieren Sie den universellen Druckserver auf dem Druckserver.