Installation über die Befehlszeile

Wichtig:

• Wenn Sie ein Upgrade durchführen und Ihre aktuelle Version die Personal vDisk- oder AppDisks-Software verwendet oder installiert hat, siehe Entfernen von PvD, AppDisks und nicht unterstützten Hosts.

• Citrix erfasst grundlegende Lizenzierungsdaten, soweit dies für seine berechtigten Interessen, einschließlich der Einhaltung von Lizenzbestimmungen, erforderlich ist. Weitere Informationen finden Sie unter Citrix Lizenzierungsdaten.

Einführung

Dieser Artikel gilt für die Installation von Komponenten auf Maschinen mit Windows-Betriebssystemen. Informationen zu VDAs für Linux-Betriebssysteme finden Sie unter Linux Virtual Delivery Agents.

Dieser Artikel beschreibt, wie Produktinstallationsbefehle ausgeführt werden. Bevor Sie mit einer Installation beginnen, lesen Sie Vorbereitung der Installation. Dieser Artikel enthält Beschreibungen der verfügbaren Installationsprogramme.

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

Als Ergänzung zur direkten Verwendung der Installationsbefehle werden auf der Produkt-ISO Beispielskripte bereitgestellt, die VDAs auf Maschinen in Active Directory installieren, aktualisieren oder entfernen. Einzelheiten finden Sie unter VDAs mit Skripten installieren.

Wenn Sie versuchen, auf einer Windows-Betriebssystemversion zu installieren oder ein Upgrade durchzuführen, die für diese Version von Citrix Virtual Apps and Desktops nicht unterstützt wird, führt Sie eine Meldung zu Informationen über Ihre Optionen. Siehe Ältere Betriebssysteme.

Informationen dazu, wie Citrix die Ergebnisse von Komponenteninstallationen meldet, finden Sie unter Citrix Installationsrückgabecodes.

Vollständiges Produktinstallationsprogramm verwenden

So greifen Sie auf die Befehlszeilenschnittstelle des vollständigen Produktinstallationsprogramms zu:

1. Laden Sie das Produktpaket von Citrix herunter. Für den Zugriff auf die Download-Site sind Citrix-Kontodaten erforderlich.
2. Entpacken Sie die Datei. Optional können Sie eine DVD aus der ISO-Datei brennen.
3. Melden Sie sich mit einem lokalen Administratorkonto am Server an, auf dem Sie die Komponenten installieren.
4. Legen Sie die DVD in das Laufwerk ein oder binden Sie die ISO-Datei ein.

5. Führen Sie im Verzeichnis \x64\XenDesktop Setup auf dem Medium den entsprechenden Befehl aus.

   So installieren Sie Kernkomponenten: Führen Sie XenDesktopServerSetup.exe mit den unter Befehlszeilenoptionen für die Installation von Kernkomponenten aufgeführten Optionen aus.

   So installieren Sie einen VDA: Führen Sie XenDesktopVDASetup.exe mit den unter Befehlszeilenoptionen für die Installation eines VDA aufgeführten Optionen aus.

   So installieren Sie StoreFront: Führen Sie CitrixStoreFront-x64.exe im Ordner x64 > StoreFront auf dem Installationsmedium aus.

   So installieren Sie den Universal Print Server: Befolgen Sie die Anweisungen unter Befehlszeilenoptionen für die Installation eines Universal Print Servers.

   So installieren Sie den Federated Authentication Service: Citrix empfiehlt die Verwendung der grafischen Oberfläche.

   So installieren Sie Session Recording: Befolgen Sie die Anweisungen unter Session Recording.

   So installieren Sie Workspace Environment Management: Befolgen Sie die Anweisungen unter Workspace Environment Management.

   So installieren Sie Secure Private Access: Führen Sie XenDesktopSPASetup.exe im Setup-Ordner x64 > XenDesktop auf dem Installationsmedium aus. Befolgen Sie die Anweisungen unter Befehlszeilenoptionen für die Installation von Secure Private Access.

Befehlszeilenoptionen für die Installation von Kernkomponenten

Die folgenden Parameteroptionen sind gültig, wenn Kernkomponenten mit dem Befehl XenDesktopServerSetup.exe installiert werden. Weitere Informationen zu den Optionen finden Sie unter Kernkomponenten installieren.

Hinweis:

• Verwenden Sie /exclude nicht, wenn Sie Befehlszeilenoptionen für die Installation von Kernkomponenten verwenden.
• Wenn Sie eine Komponente mit /components aktualisieren, werden möglicherweise auch andere Komponenten aktualisiert. Dies dient dazu, potenzielle Kompatibilitätsprobleme zwischen verschiedenen Komponenten zu vermeiden.
• Wenn Sie nur eine Komponente aktualisieren möchten, verwenden Sie den individuellen Installer dieser Komponente. Siehe Bereitstellung aktualisieren.

• /ceipoptin CEIP-Teilnahme [,ceipoptin] …

  Ermöglicht die Erfassung von Call Home-Daten und Daten des Customer Experience Improvement Program (CEIP). Gültige Werte sind:

  • DIAGNOSTIC: Wählen Sie diesen Wert, um Citrix Licensing die Erfassung von Call Home-Daten zu ermöglichen.
  • ANONYMOUS: Wählen Sie diesen Wert, um Citrix Licensing die Erfassung nicht identifizierter CEIP-Daten (die keine Benutzer identifizieren) zu ermöglichen.
  • NONE: Wählen Sie diesen Wert, um die Erfassung von CEIP-Daten durch Citrix Licensing zu deaktivieren.

  Weitere Informationen zur Call Home-Datenerfassung finden Sie unter Citrix Licensing Call Home.

  Weitere Details zur CEIP-Datenerfassung finden Sie unter Citrix Licensing Customer Experience Improvement Program.

  Weitere Details zu CEIP-Daten finden Sie unter Citrix Licensing CEIP-Datenelemente.

  Weitere Details zu Lizenzserver-Lizenzierungsdaten finden Sie unter Citrix Licensing Data.

• /components Komponente [,component] …

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

  • CONTROLLER: Controller
  • DESKTOPSTUDIO: Studio
  • WEBSTUDIO: Web Studio
  • DESKTOPDIRECTOR: Director
  • LICENSESERVER: Citrix License Server
  • SECUREPRIVATEACCESS: Secure Private Access

  Wird diese Option weggelassen, werden alle Komponenten installiert (oder entfernt, wenn die Option /remove ebenfalls angegeben ist).

  (In Versionen vor 2003 waren STOREFRONT gültige Werte. Für Version 2003 und höher verwenden Sie den dedizierten StoreFront-Installationsbefehl, der unter Verwenden des vollständigen Produktinstallationsprogramms erwähnt wird).

• /configure_firewall

  Öffnet alle von den zu installierenden Komponenten verwendeten Ports in der Windows-Firewall, wenn der Windows-Firewall-Dienst ausgeführt wird, selbst wenn die Firewall nicht aktiviert ist. Wenn Sie eine Drittanbieter-Firewall oder keine Firewall verwenden, müssen Sie die Ports manuell öffnen.

• /erfahrungsmetrikendeaktivieren

  Verhindert den automatischen Upload von Analysedaten, die während der Installation, des Upgrades oder der Entfernung erfasst wurden, an Citrix.

• /help oder /h

  Zeigt die Befehlshilfe an.

• /ignore_hw_check_failure

  Ermöglicht die Fortsetzung der Installation oder des Upgrades des Delivery Controllers, selbst wenn die Hardwareprüfungen fehlschlagen (z. B. aufgrund von unzureichendem RAM). Weitere Informationen finden Sie unter Hardwareprüfung.

• /ignore_site_test_failure

  Nur gültig während eines Controller-Upgrades. Normalerweise werden alle Fehler bei Standorttests ignoriert und das Upgrade wird fortgesetzt. Wenn diese Option weggelassen (oder auf „false“ gesetzt) wird, führt jeder Fehler bei einem Standorttest dazu, dass das Installationsprogramm fehlschlägt, ohne das Upgrade durchzuführen. Standard = false

  Während eines Upgrades wird diese Option ignoriert, wenn eine nicht unterstützte SQL Server-Version erkannt wird. Weitere Informationen finden Sie unter SQL Server-Versionsprüfung.

• /Installationsverzeichnis Verzeichnis

  Vorhandenes leeres Verzeichnis, in dem Komponenten installiert werden. Standard = c:\Program Files\Citrix.

• /Protokollpfad Pfad

  Speicherort der Protokolldatei. Der angegebene Ordner muss vorhanden sein. Das Installationsprogramm erstellt ihn nicht. Standard = TEMP%\Citrix\XenDesktop Installer

• /no_remote_assistance

  Nur gültig bei der Installation von Director. Deaktiviert die Benutzer-Shadowing-Funktion, die die Windows-Remoteunterstützung verwendet.

• /KeinNeustart

  Verhindert einen Neustart nach der Installation. (Für die meisten Kernkomponenten ist ein Neustart standardmäßig nicht aktiviert.)

• /KeineFortsetzung

  Standardmäßig wird das Installationsprogramm nach einem erforderlichen Neustart während einer Installation automatisch fortgesetzt, sobald der Neustart abgeschlossen ist. Um die Standardeinstellung zu überschreiben, geben Sie /noresume an. Dies kann hilfreich sein, wenn Sie die Medien neu einbinden oder Informationen während einer automatisierten Installation erfassen müssen.

• /KeinSQL

  Verhindert die Installation von Microsoft SQL Server Express auf dem Server, auf dem Sie den Controller installieren. Wird diese Option weggelassen, wird SQL Server Express als Sitedatenbank installiert.

  Diese Option hat keine Auswirkungen auf die Installation von SQL Server Express LocalDB, die für den Local Host Cache verwendet wird.

• /quiet oder /passive

  Während der Installation wird keine Benutzeroberfläche angezeigt. Der einzige Hinweis auf den Installationsprozess ist im Windows Task-Manager zu finden. Wird diese Option weggelassen, wird die grafische Benutzeroberfläche gestartet.

• /entfernen

  Entfernt die mit der Option /components angegebenen Kernkomponenten.

• /allesentfernen

  Entfernt alle installierten Kernkomponenten.

• /erfahrungsmetrikensenden

  Sendet automatisch Analysedaten, die während der Installation, des Upgrades oder der Entfernung gesammelt wurden, an Citrix. Wird diese Option weggelassen (oder /disableexperiencemetrics angegeben), werden die Analysedaten lokal gesammelt, aber nicht automatisch gesendet.

• /tempdir Verzeichnis

  Verzeichnis, das temporäre Dateien während der Installation enthält. Standard = c:\Windows\Temp.

• /XenApp

  Installiert Citrix Virtual Apps. Wird diese Option weggelassen, wird Citrix Virtual Apps and Desktops™ installiert.

Beispiele für die Installation von Kernkomponenten

Der folgende Befehl installiert einen Delivery Controller™, Studio, Citrix Licensing und SQL Server Express auf einem Server. Für die Komponentenkommunikation erforderliche Firewall-Ports werden automatisch geöffnet.

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

Der folgende Befehl installiert einen Citrix Virtual Apps™ Controller, Studio und SQL Server Express auf dem Server. Die für die Komponentenkommunikation erforderlichen Firewall-Ports werden automatisch geöffnet.

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

Der folgende Befehl installiert einen Delivery Controller, Secure Private Access und SQL Server Express auf einem Server. Die für die Komponentenkommunikation erforderlichen Firewall-Ports werden automatisch geöffnet.

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

Standalone-VDA-Installer verwenden

Für den Zugriff auf die Download-Website sind Citrix-Anmeldeinformationen erforderlich. Sie müssen entweder vor Beginn der Installation erweiterte Administratorrechte besitzen oder Als Administrator ausführen verwenden.

1. Laden Sie das entsprechende Paket von Citrix herunter:
   • Multi-Session-OS Virtual Delivery Agent: VDAServerSetup_xxxx.exe
   • Single-Session-OS Virtual Delivery Agent: VDAWorkstationSetup_xxxx.exe
   • Single-Session-OS Core Services Virtual Delivery Agent: VDAWorkstationCoreSetup_xxxx.exe

2. Extrahieren Sie die Dateien entweder zuerst aus dem Paket in ein vorhandenes Verzeichnis und führen Sie dann den Installationsbefehl aus, oder führen Sie einfach das Paket aus.

   Um die Dateien vor der Installation zu extrahieren, verwenden Sie /extract mit dem absoluten Pfad, zum Beispiel C:\YourExtractFolder\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. Das Verzeichnis muss vorhanden sein. Andernfalls schlägt die Extraktion fehl. Führen Sie dann in einem separaten Befehl den entsprechenden Befehl mit den in diesem Artikel aufgeführten gültigen Optionen aus.

   • Für VDAServerSetup_XXXX.exe führen Sie <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe aus

   • Für VDAWorkstationCoreSetup_XXXX.exe führen Sie <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe aus

   • Für VDAWorkstationSetup_XXXX.exe führen Sie <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe aus

   Um das heruntergeladene Paket auszuführen, führen Sie seinen Namen aus: VDAServerSetup.exe, VDAWorkstationSetup.exe oder VDAWorkstationCoreSetup.exe. Verwenden Sie die in diesem Artikel aufgeführten gültigen Optionen.

Wenn Sie mit dem vollständigen Produktinstallationsprogramm vertraut sind:

• Führen Sie das eigenständige Installationsprogramm VDAServerSetup.exe oder VDAWorkstationSetup.exe aus, als wäre es der Befehl XenDesktopVdaSetup.exe, mit Ausnahme seines Namens.

• Das Installationsprogramm VDAWorkstationCoreSetup.exe ist anders, da es eine Untermenge der Optionen unterstützt, die den anderen Installationsprogrammen zur Verfügung stehen.

Befehlszeilenoptionen für die Installation eines VDA

Die folgenden Optionen sind mit einem oder mehreren der folgenden Befehle (Installationsprogramme) gültig: VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exe und VDAWorkstationCoreSetup_xxxx.exe.

Weitere Informationen zu den Optionen finden Sie unter VDAs installieren.

• /Komponenten Komponente[,Komponente]

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

  • VDA: Virtueller Bereitstellungsagent
  • PLUGINS: Citrix Workspace™-App für Windows

  Um den VDA und die Citrix Workspace-App für Windows zu installieren, geben Sie /components vda,plugins an.

  Wenn diese Option weggelassen wird, wird nur der VDA installiert (nicht die Citrix Workspace-App).

  Diese Option ist bei Verwendung des Installationsprogramms VDAWorkstationCoreSetup_xxxx.exe nicht gültig. Dieses Installationsprogramm kann die Citrix Workspace-App nicht installieren.

• /Controller “Controller [Controller]”

  Durch Leerzeichen getrennte FQDNs der Controller, mit denen der VDA kommunizieren kann, in geraden Anführungszeichen eingeschlossen. Geben Sie nicht sowohl die Option /site_guid als auch die Option /controllers an.

• Erfahrungsmetrikendeaktivierung

  Verhindert das automatische Hochladen von Analysedaten, die während der Installation, des Upgrades oder der Entfernung an Citrix gesammelt wurden.

• /enable_hdx_ports

  Öffnet Ports in der Windows-Firewall, die vom VDA und aktivierten Funktionen (außer Windows-Remotedesktopunterstützung) benötigt werden, wenn der Windows-Firewalldienst erkannt wird, auch wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere Firewall oder keine Firewall verwenden, müssen Sie die Firewall manuell konfigurieren. Informationen zu Ports finden Sie unter Netzwerkports.

  Um die UDP-Ports zu öffnen, die der adaptive HDX-Transport verwendet, geben Sie zusätzlich zu dieser Option /enable_hdx_ports die Option /enable_hdx_udp_ports an.

• /enable_hdx_udp_ports

  Öffnet UDP-Ports in der Windows-Firewall, die der adaptive HDX-Transport verwendet, wenn der Windows-Firewalldienst erkannt wird, auch wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere Firewall oder keine Firewall verwenden, müssen Sie die Firewall manuell konfigurieren. Informationen zu Ports finden Sie unter Netzwerkports.

  Um zusätzliche Ports zu öffnen, die der VDA verwendet, geben Sie zusätzlich zu dieser Option /enable_hdx_udp_ports die Option /enable_hdx_ports an.

• /enable_hdx_tls_dtls

  Öffnet TCP- und UDP-Port 443 für HDX™ Direct V1.

• /enable_real_time_transport

  Aktiviert oder deaktiviert die Verwendung von UDP für Audiopakete (RealTime Audio Transport für Audio). Die Aktivierung dieser Funktion kann die Audioleistung verbessern. Fügen Sie die Option /enable_hdx_ports hinzu, wenn die UDP-Ports automatisch geöffnet werden sollen, wenn der Windows-Firewalldienst erkannt wird.

• /enable_remote_assistance

  Aktiviert die Shadowing-Funktion in der Windows-Remotedesktopunterstützung zur Verwendung mit Director. Wenn Sie diese Option angeben, öffnet die Windows-Remotedesktopunterstützung die dynamischen Ports in der Firewall.

• /enablerestore oder /enablerestorecleanup

  (Nur gültig für Single-Session-VDAs) Ermöglicht die automatische Rückkehr zum Wiederherstellungspunkt, wenn die VDA-Installation oder das Upgrade fehlschlägt.

  Wenn die Installation/das Upgrade erfolgreich abgeschlossen wird:

  • /enablerestorecleanup weist den Installer an, den Wiederherstellungspunkt zu entfernen.
  • /enablerestore weist den Installer an, den Wiederherstellungspunkt beizubehalten, obwohl er nicht verwendet wurde.

  Weitere Informationen finden Sie unter Wiederherstellung bei Installations- oder Upgradefehler.

• /enable_ss_ports

  Öffnet Ports in der Windows-Firewall, die für die Bildschirmfreigabe erforderlich sind, wenn der Windows-Firewall-Dienst erkannt wird, auch wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere Firewall oder keine Firewall verwenden, müssen Sie die Firewall manuell konfigurieren.

• /exclude “Komponente”[,”Komponente”]

  Verhindert die Installation einer oder mehrerer durch Kommas getrennter optionaler Komponenten, die jeweils in geraden Anführungszeichen eingeschlossen sind. Beispielsweise erfordert die Installation oder das Upgrade eines VDA auf einem Image, das nicht von MCS verwaltet wird, nicht die Komponente Machine Identity Service. Gültige Werte sind die folgenden:

  Multi-Session-Betriebssystem	Single-Session-Betriebssystem	Single-Session-Betriebssystem-Kerndienste
  Citrix Authentication Identity Assertion VDA Plug-in	Citrix Authentication Identity Assertion VDA Plug-in	Citrix Authentication Identity Assertion VDA Plug-in
  Citrix Backup and Restore	Citrix Backup and Restore	Citrix Browser Content Redirection
  Citrix Browser Content Redirection	Citrix Browser Content Redirection	Citrix Personalization for App-V - VDA
  Citrix MCS IODriver	Citrix MCS IODriver	Citrix Telemetry Service
  Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA	Citrix Universal Print Client
  Citrix Profile Management	Citrix Profile Management	Citrix Vda Log Capture Service
  Citrix Profile Management WMI Plug-in	Citrix Profile Management WMI Plug-in	CSE Component
  Citrix Rendezvous V2	Citrix Rendezvous V2	Director VDA Plug-in
  Citrix Telemetry Service	Citrix Telemetry Service	Machine Management Provider
  Citrix Universal Print Client	Citrix Universal Print Client	VDA Monitor Plug-in
  Citrix Vda Log Capture Service	Citrix Vda Log Capture Service	VDA WMI Proxy Plug-in
  Citrix VDA Upgrade Agent	Citrix VDA Upgrade Agent
  CSE Component	CSE Component
  Director VDA Plug-in	Director VDA Plug-in
  Machine Identity Service	Machine Identity Service
  Machine Management Provider	Machine Management Provider
  VDA Monitor Plug-in	User Personalization Layer
  VDA WMI Proxy Plug-in	VDA Monitor Plug-in
  	VDA WMI Proxy Plug-in
  Citrix App Protection Component	Citrix App Protection Component	Citrix App Protection Component
  Citrix HyperV Filter Driver	Citrix HyperV Filter Driver
  Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA

  Das Ausschließen von Citrix Profile Management von der Installation (/exclude "Citrix Profile Management") beeinträchtigt die Überwachung und Fehlerbehebung von VDAs mit Citrix Director. Auf den Seiten Benutzerdetails und EndPoint schlagen das Personalisierungsfeld und das Anmeldedauerfeld fehl. Auf den Seiten Dashboard und Trends zeigt das Feld für die durchschnittliche Anmeldedauer nur Daten für Maschinen an, auf denen Profile Management installiert ist.

  Auch wenn Sie eine Drittanbieterlösung für die Benutzerprofilverwaltung verwenden, empfiehlt Citrix, den Citrix Profile Management Service zu installieren und auszuführen. Das Aktivieren des Citrix Profile Management Service ist nicht erforderlich.

  Wenn Sie sowohl /exclude als auch /includeadditional mit demselben Komponentennamen angeben, wird diese Komponente nicht installiert.

  Diese Option ist bei Verwendung des VDAWorkstationCoreSetup.exe-Installers nicht gültig. Dieser Installer schließt viele dieser Elemente automatisch aus.

• /h oder /help

  Zeigt die Befehlshilfe an.

• /includeadditional “Komponente”[,”Komponente”]

  Beinhaltet die Installation einer oder mehrerer durch Kommas getrennter optionaler Komponenten, die jeweils in geraden Anführungszeichen eingeschlossen sind. Diese Option kann hilfreich sein, wenn Sie eine Remote-PC-Zugriffsbereitstellung erstellen und andere Komponenten installieren möchten, die nicht standardmäßig enthalten sind. Gültige Werte sind die folgenden:

  Multi-Session-OS	Single-Session-OS
  Citrix Backup and Restore	Citrix Backup and Restore
  Citrix MCS IODriver	Citrix MCS IODriver
  Citrix Personalization for App-V - VDA	Citrix Personalization for App-V - VDA
  Citrix Profile Management	Citrix Profile Management
  Citrix Profile Management WMI Plug-in	Citrix Profile Management WMI Plug-in
  Citrix Rendezvous V2	Citrix Rendezvous V2
  Citrix VDA Upgrade Agent	Citrix VDA Upgrade Agent
  Citrix Web Socket Vda Registration Tool	Citrix Web Socket Vda Registration Tool
  Machine Identity Service	Machine Identity Service
  	User Personalization Layer

  Wenn Sie sowohl /exclude als auch /includeadditional mit demselben Komponentennamen angeben, wird diese Komponente nicht installiert.

• /installdir Verzeichnis

  Vorhandenes leeres Verzeichnis, in dem Komponenten installiert werden. Standard = c:\Program Files\Citrix.

• /install_mcsio_driver

  Nicht verwenden. Verwenden Sie stattdessen /includeadditional "Citrix MCS IODriver" oder /exclude "Citrix MCS IODriver".

• /logpath Pfad

  Speicherort der Protokolldatei. Der angegebene Ordner muss vorhanden sein. Das Installationsprogramm erstellt ihn nicht. Standard = “%TEMP%\Citrix\XenDesktop Installer”

  Diese Option ist in der grafischen Benutzeroberfläche nicht verfügbar.

• /Masterimage

  Nur gültig bei der Installation eines VDA auf einer VM. Richtet den VDA als Image ein, das zum Erstellen anderer Maschinen verwendet werden soll. Diese Option entspricht /mastermcsimage.

  Diese Option ist bei Verwendung des VDAWorkstationCoreSetup_xxxx.exe-Installationsprogramms nicht gültig.

• /Master-MCS-Image

  Gibt an, dass diese Maschine als Image mit Machine Creation Services verwendet wird. Diese Option entspricht /masterimage.

• /Master-PVS-Image

  Gibt an, dass diese Maschine als Image mit Citrix Provisioning™ oder einem Provisioning-Tool eines Drittanbieters (z. B. Microsoft System Center Configuration Manager) zum Bereitstellen von VMs verwendet wird.

• /websockettoken WebSocket-Token

  Erstellt einen Web Socket VDA. Der WebSocketToken ist für das erforderliche Token.

• /no_mediafoundation_ack

  Bestätigt, dass Microsoft Media Foundation nicht installiert ist und mehrere HDX-Multimediafunktionen nicht installiert werden und nicht funktionieren. Wenn diese Option weggelassen wird und Media Foundation nicht installiert ist, wird die VDA-Installation beendet, da die Voraussetzungen nicht erfüllt sind. Die meisten unterstützten Windows-Editionen werden mit bereits installierter Media Foundation geliefert, außer N-Editionen. Wenn Sie Windows-Features > Medienfunktionen manuell aktivieren, hat der vom Citrix Meta Installer gesuchte Registrierungsschlüssel möglicherweise keinen festgelegten Wert. Überprüfen Sie den Registrierungsschlüssel SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\Windows-Features\WindowsMediaVersion, bevor Sie den Installationsvorgang starten, um zu bestätigen, dass der Wert vorhanden und nicht leer ist.

• /keineDesktopErfahrung

  Die Funktion „Erweiterte Desktop-Benutzeroberfläche“ ist nicht mehr verfügbar. Diese Option (und Richtlinieneinstellung) wird ignoriert, falls angegeben.

  Nur gültig bei der Installation eines VDA für Multi-Session-Betriebssysteme. Verhindert die Aktivierung der Funktion „Erweiterte Desktop-Benutzeroberfläche“. Diese Funktion wird auch über die Citrix-Richtlinieneinstellung „Erweiterte Desktop-Benutzeroberfläche“ gesteuert.

• keinNeustart

  Verhindert einen Neustart nach der Installation. Der VDA kann erst nach einem Neustart verwendet werden.

• keineWiederaufnahme

  Standardmäßig wird der Installer bei einem erforderlichen Neustart während einer Installation nach Abschluss des Neustarts automatisch fortgesetzt. Um die Standardeinstellung zu überschreiben, geben Sie /noresume an. Dies kann hilfreich sein, wenn Sie die Medien neu einbinden oder Informationen während einer automatisierten Installation erfassen möchten.

• physischeMaschine

  Verwenden Sie dieses Argument zusammen mit /remotepc für die RemotePC-Installation. Andernfalls verhält sich der VDA in bestimmten Benutzerszenarien möglicherweise nicht wie erwartet.

• Portnummer Port

  Nur gültig, wenn die Option /reconfig angegeben ist. Portnummer, die für die Kommunikation zwischen dem VDA und dem Controller aktiviert werden soll. Der zuvor konfigurierte Port wird deaktiviert, es sei denn, es ist Port 80.

• /proxyconfig „address or PAC file path“

  Wenn Sie beabsichtigen, das Rendezvous-Protokoll mit Diensten wie dem Gateway Service in Ihrer Umgebung zu verwenden und einen nicht-transparenten Proxy in Ihrem Netzwerk für ausgehende Verbindungen haben, geben Sie den Proxy hier an. Es werden nur HTTP-Proxys unterstützt. Die Adresse oder der PAC-Dateipfad des Proxys zur Verwendung mit dem Rendezvous-Protokoll. Einzelheiten zur Funktion finden Sie unter Rendezvous-Protokoll.

  • Proxy-Adressformat: http://<url-or-ip>:<port>
  • PAC-Dateiformat: http://<url-or-ip>:<port>/<path>/<filename>.pac

• /quiet oder /passive

  Während der Installation wird keine Benutzeroberfläche angezeigt. Der einzige Nachweis des Installations- und Konfigurationsprozesses ist im Windows Task-Manager zu finden. Wenn diese Option weggelassen wird, wird die grafische Benutzeroberfläche gestartet.

• neuKonfigurieren

  Passt zuvor konfigurierte VDA-Einstellungen an, wenn sie mit den Optionen /portnumber, /controllers oder /enable_hdx_ports verwendet wird. Wenn Sie diese Option angeben, ohne auch die Option /quiet anzugeben, wird die grafische Benutzeroberfläche zum Anpassen des VDA gestartet.

• /RemotePC

  Nur gültig für Remote-PC-Zugriffsbereitstellungen (Einzelsitzungs-Betriebssystem) oder vermittelte Verbindungen (Mehrfachsitzungs-Betriebssystem). Schließt die Installation zusätzlicher Komponenten aus (siehe Komponentenlisten mit den Optionen /exclude und /includeadditional).

  Diese Option ist bei Verwendung des VDAWorkstationCoreSetup.exe-Installers nicht gültig. Dieser Installer schließt die Installation dieser Komponenten automatisch aus.

  /remotepc ist nicht kompatibel mit der Option /servervdi.

• /entfernen

  Entfernt die mit der Option /components angegebenen Komponenten.

• /remove_appdisk_ack

  Ermöglicht dem VDA-Installer, das AppDisks™ VDA-Plug-in zu deinstallieren, falls es installiert ist.

• /remove_pvd_ack

  Ermöglicht dem VDA-Installer, Personal vDisk zu deinstallieren, falls es installiert ist.

• /allesentfernen

  Entfernt den VDA. Die Citrix Workspace-App (falls installiert) wird dabei nicht entfernt.

• /ErfahrungsmetrikenSenden

  Sendet automatisch Analysedaten, die während der Installation, des Upgrades oder der Entfernung gesammelt wurden, an Citrix. Wenn diese Option weggelassen wird (oder die Option /disableexperiencemetrics angegeben wird), werden Analysedaten lokal gesammelt, aber nicht automatisch gesendet.

• /Server-VDI

  Installiert einen VDA für Einzelsitzungs-Betriebssysteme auf einem unterstützten Windows-Mehrsitzungscomputer. Lassen Sie diese Option weg, wenn Sie einen VDA für Mehrsitzungs-Betriebssysteme auf einem Windows-Mehrsitzungscomputer installieren.

  Bevor Sie diese Option verwenden, lesen Sie Server VDI.

  Verwenden Sie diese Option nur mit dem VDA-Installationsprogramm für das vollständige Produkt.

• /site_guid GUID

  Global eindeutiger Bezeichner (GUID) der Active Directory-Organisationseinheit (OU) der Site. Dies ordnet einen virtuellen Desktop einer Site zu, wenn Sie Active Directory für die Erkennung verwenden (automatische Aktualisierung ist die empfohlene und standardmäßige Erkennungsmethode). Die Site-GUID ist eine Site-Eigenschaft, die in Studio angezeigt wird. Geben Sie nicht sowohl die Optionen /site_guid als auch /controllers an.

• /tempdir Verzeichnis

  Verzeichnis zum Speichern temporärer Dateien während der Installation. Standard = c:\Windows\Temp.

  Diese Option ist in der grafischen Benutzeroberfläche nicht verfügbar.

• /virtuelle-maschine

  Nur gültig bei der Installation eines VDA auf einer VM. Überschreibt die Erkennung einer physischen Maschine durch das Installationsprogramm, wobei an VMs übergebene BIOS-Informationen diese als physische Maschinen erscheinen lassen.

  Diese Option ist in der grafischen Benutzeroberfläche nicht verfügbar.

• /xendesktop-cloud

  Gibt an, dass der VDA in einer Citrix DaaS (Citrix Cloud™)-Bereitstellung installiert wird.

Beispiele für die Installation eines VDA

VDA mit dem vollständigen Produktinstallationsprogramm installieren:

Der folgende Befehl installiert einen VDA für Einzelsitzungs-Betriebssysteme und die Citrix Workspace-App am Standardspeicherort auf einer VM. Dieser VDA wird als Image verwendet und nutzt MCS zur Bereitstellung von VMs. Der VDA registriert sich zunächst beim Controller auf dem Server mit dem Namen Contr-Main in der Domäne mydomain. Der VDA verwendet Benutzerpersonalisierungsschichten und die Windows-Remoteunterstützung.

\x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance

VDA für Einzelsitzungs-Betriebssysteme mit dem eigenständigen Installationsprogramm VDAWorkstationCoreSetup installieren:

Der folgende Befehl installiert einen Core Services VDA auf einem Einzelsitzungs-Betriebssystem zur Verwendung in einer Remote-PC-Zugriff- oder VDI-Bereitstellung. Die Citrix Workspace-App und andere Nicht-Core-Dienste werden nicht installiert. Die Adresse eines Controllers wird angegeben, und Ports im Windows-Firewall-Dienst werden automatisch geöffnet. Der Administrator übernimmt die Neustarts.

VDAWorkstationCoreSetup .exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot

VDA anpassen

Nach der Installation eines VDA können Sie verschiedene Einstellungen anpassen. Führen Sie aus dem Verzeichnis \x64\XenDesktop Setup auf dem Produktmedium XenDesktopVdaSetup.exe aus, wobei Sie eine oder mehrere der folgenden Optionen verwenden, die unter Befehlszeilenoptionen für die VDA-Installation beschrieben sind.

• /reconfigure (erforderlich beim Anpassen eines VDA)
• /h oder /help
• /quiet
• /noreboot
• /controllers
• /portnumber port
• /enable_hdx_ports

Problembehandlung bei VDAs

• In der Studio-Anzeige für eine Bereitstellungsgruppe entspricht der Eintrag Installierte VDA-Version im Bereich Details möglicherweise nicht der auf den Maschinen installierten Version. Die Anzeige der Windows-Programme und -Funktionen der Maschine zeigt die tatsächliche VDA-Version an.

• Nach der Installation eines VDA kann er Benutzern keine Apps oder Desktops bereitstellen, bevor er sich bei einem Delivery Controller registriert.

  Informationen zu VDA-Registrierungsmethoden und zur Problembehandlung bei Registrierungsproblemen finden Sie unter VDA-Registrierung.

Befehlszeilenoptionen für die Installation eines Universal Print Servers

Die folgende Option ist mit dem XenDesktopPrintServerSetup.exe-Befehl gültig.

• /enable_upsserver_port

Wenn diese Option nicht angegeben ist, zeigt das Installationsprogramm die Seite Firewall der grafischen Benutzeroberfläche an. Wählen Sie Automatisch, damit das Installationsprogramm die Windows-Firewallregeln automatisch hinzufügt, oder Manuell, damit der Administrator die Firewall manuell konfiguriert.

Nach der Installation der Software auf Ihren Druckservern konfigurieren Sie den Universal Print Server gemäß den Anweisungen unter Drucker bereitstellen.

Befehlszeilenoptionen für die Installation von Secure Private Access

Die folgenden Optionen sind mit dem folgenden Befehl (Installationsprogramm) gültig: XenDesktopSPASetup.exe

• /enable_spa_ports

  Öffnet die vom Secure Private Access benötigten Ports in der Windows-Firewall, wenn der Windows-Firewalldienst erkannt wird, auch wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere Firewall oder keine Firewall verwenden, müssen Sie die Firewall manuell konfigurieren. Informationen zu Ports finden Sie unter Netzwerkports.

• NoSQL

  Verhindert die Installation von Microsoft SQL Server Express auf dem Server, auf dem Sie Secure Private Access installieren. Wird diese Option weggelassen, wird SQL Server Express als Sitedatenbank installiert.

• /help oder /h oder /?

  Zeigt die Befehlshilfe an

• /kein Neustart

  Verhindert einen Neustart nach der Installation. Secure Private Access kann erst nach einem Neustart verwendet werden.

• /quiet oder /passive

  Während der Installation wird keine Benutzeroberfläche angezeigt. Der einzige Hinweis auf den Installations- und Konfigurationsprozess ist der Windows Task-Manager. Wird diese Option weggelassen, wird die grafische Benutzeroberfläche gestartet.

• /entfernen

  Entfernt Secure Private Access.

Weitere Informationen zu den Optionen finden Sie unter Secure Private Access-Installationsprogramm.

Weitere Informationen

Informationen dazu, wie Citrix das Ergebnis von Komponenteninstallationen meldet, finden Sie unter Citrix Installations-Rückgabecodes.