Citrix Virtual Apps and Desktops

Installieren über die Befehlszeile

February 17, 2025

Beitrag von:

Wichtig:

Wenn Sie ein Upgrade durchführen und die aktuelle Version verwendet die Software für persönliche vDisks oder AppDisks, bzw. diese Software ist installiert, lesen Sie den Abschnitt Entfernen von PvD, AppDisks und nicht unterstützten Hosts.

Citrix erfasst allgemeine Lizenzdaten, die für eigene berechtigte Interessen erforderlich sind, einschließlich Daten zur Lizenzcompliance. Weitere Informationen finden Sie unter Daten zur Citrix Lizenzierung.

Einführung

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

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 VDAs auf Maschinen in Active Directory. Weitere Informationen finden Sie unter Installieren von VDAs mit Skripts.

Wenn Sie die Installation bzw. ein Upgrade unter einem für diese Citrix Virtual Apps and Desktops-Version nicht unterstützten Betriebssystem versuchen, werden Sie durch eine Meldung zu Informationen über Ihre Optionen geleitet. Siehe Ältere Betriebssysteme.

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

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 aus dem Verzeichnis \x64\XenDesktop Setup auf dem Medium den entsprechenden Befehl aus.

So installieren Sie Kernkomponenten: Führen Sie XenDesktopServerSetup.exe mit den unter Befehlszeilenoptionen zum Installieren von Kernkomponenten aufgeführten Optionen aus.

VDA-Installation: Führen Sie XenDesktopVDASetup.exe mit den unter Befehlszeilenoptionen zur VDA-Installation beschriebenen Optionen aus.

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

Zum Installieren des universellen Druckservers: Folgen Sie den Anweisungen unter Befehlszeilenoptionen zum Installieren eines universellen Druckservers.

Installation des Verbundauthentifizierungsdiensts: Citrix empfiehlt die Verwendung der grafischen Oberfläche.

Installation der Sitzungsaufzeichnung: Folgen Sie den Anweisungen unter Sitzungsaufzeichnung.

Installieren von Workspace Environment Management: Folgen Sie den Anweisungen in Workspace Environment Management.

So installieren Sie Secure Private Access: Führen Sie XenDesktopSPASetup.exe im Setupordner x64 > XenDesktop auf dem Installationsmedium aus. Folgen Sie den Anweisungen in den Befehlszeilenoptionen zur Installation eines Secure Private Access.

Befehlszeilenoptionen zur Installation der Kernkomponenten

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

/Ceipoptin Ceipoptin [,Ceipoptin] …

Aktiviert die Datenerfassung für Call Home und das Programm zur Verbesserung der Benutzerfreundlichkeit (CEIP). Gültige Werte:
- DIAGNOSTIC: Wählen Sie diesen Wert, um die Citrix-Lizenzierung zum Sammeln von Call Home-Daten zu aktivieren.
- ANONYMOUS: Wählen Sie diesen Wert, um der Citrix-Lizenzierung das Sammeln nicht identifizierter CEIP-Daten (die keine Benutzer identifizieren) zu ermöglichen.
- KEINE: Wählen Sie diesen Wert, um die Erfassung von CEIP-Daten durch Citrix Licensing zu deaktivieren.
Weitere Informationen zur Erfassung von Call Home-Daten finden Sie unter Call Home für die Citrix Lizenzierung.

Weitere Informationen zur Erfassung von CEIP-Daten finden Sie unter Programm zur Verbesserung der Benutzerfreundlichkeit (CEIP) für die Citrix Lizenzierung.

Weitere Informationen zu CEIP-Daten finden Sie unter CEIP-Datenelemente für die Citrix Lizenzierung.

Weitere Informationen zu Lizenzserver-Lizenzdaten finden Sie unter Daten zur Citrix Lizenzierung.
/components Komponente [,Komponente] …

Durch Trennzeichen getrennte Liste der zu installierenden oder zu entfernenden Komponenten. Gültige Werte:
- CONTROLLER: Controller
- DESKTOPSTUDIO: Studio
- WEBSTUDIO: Webstudio
- DESKTOPDIRECTOR: Director
- LICENSESERVER: Citrix-Lizenzserver
- SECUREPRIVATEACCESS: Sicherer privater Zugriff
Wenn diese Option ausgelassen wird, werden alle Komponenten installiert (bzw. entfernt, wenn die Option /remove ebenfalls angegeben ist).

(In Versionen vor 2003 waren folgende Werte gültig: STOREFRONT. Verwenden Sie ab Version 2003 den dedizierten, im Artikel Verwenden des Produktinstallationsprogramms 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 “Feature”[,”Feature”]

Verhindert die Installation der jeweils 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.
/help oder /h

Zeigt die Hilfe für Befehle an.
/ignore_hw_check_failure

Lässt die Fortsetzung der Installation oder des Upgrades des Delivery Controllers selbst dann zu, wenn die Hardwareprüfung nicht bestanden wird (z. B. wegen unzureichendem Arbeitsspeicher). Weitere Informationen finden Sie unter Hardwareprüfung.
/ignore_site_test_failure

Gilt nur während des Controllerupgrades. Sitetestfehler werden für gewöhnlich ignoriert und das Upgrade wird fortgesetzt. Wenn dieser Wert ausgelassen oder auf “falsch” festgelegt wird, führt jeglicher Sitetestfehler dazu, dass das Installationsprogramm fehlschlägt und kein Upgrade durchgeführt wird. Standard = false

Bei Upgrades wird diese Option ignoriert, wenn eine nicht unterstützte SQL Server-Version erkannt wird. Einzelheiten finden Sie unter SQL Server-Versionsprüfung.
/installdirdirectory**

Vorhandenes leeres Verzeichnis, in dem die Komponenten installiert werden. Standard = c:\Programme\Citrix.
/logpathpath**

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

Wenn während einer Installation ein Maschinenneustart erforderlich ist, wird das Installationsprogramm automatisch fortgesetzt, sobald der Neustart abgeschlossen ist. Um die Standardeinstellung 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.
/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.
/SKIPHDXDRIVERCHECK

Überspringt die Überprüfung der HDX-Treiber im VDA Meta-Installer.
/sendexperiencemetrics

Sendet automatisch bei Installation, Upgrade oder Deinstallation erfasste Analysedaten an Citrix. Wenn diese Option weggelassen wird (oder /disableexperiencemetrics angegeben wird), werden die Analysen 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 Citrix Virtual Apps. Wenn diese Option ausgelassen wird, wird Citrix Virtual Apps and Desktops installiert.

Beispiele zur Installation der Kernkomponenten

Mit dem folgenden Befehl werden ein Delivery 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 Citrix Virtual Apps-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

Mit dem folgenden Befehl werden ein Delivery Controller, Secure Private Access und SQL Server Express auf einem Server installiert. Für die Komponentenkommunikation erforderliche Firewallports werden automatisch geöffnet.

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

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.
- Virtual Delivery Agent für Multisession-OS: VDAServerSetup_xxxx.exe
- Virtual Delivery Agent für Einzelsitzungs-OS: VDAWorkstationSetup_xxxx.exe
- Virtual Delivery Agent für Einzelsitzungs-OS-Core-Dienste: VDAWorkstationCoreSetup_xxxx.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.

Um die Dateien vor der Installation zu extrahieren, verwenden Sie /extract mit dem absoluten Pfad, zum Beispiel C:\IhrExtraktordner\VDAWorkstationCoreSetup.exe /extract %temp%\CitrixVDAInstallMedia. Das Verzeichnis muss vorhanden sein. Andernfalls schlägt das Extrahieren fehl. Führen Sie dann separat den entsprechenden Befehl mit den gültigen Optionen aus, die in diesem Artikel aufgeführt sind.
- 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 im vorliegenden Artikel beschriebenen, gültigen Optionen.

Hinweis für Personen, die mit dem 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 allem außer seinem Namen.
Das Installationsprogramm VDAWorkstationCoreSetup.exe ist anders, da es nur einen Teil der Optionen der anderen Installationsprogramme unterstützt.

Befehlszeilenoptionen zur VDA-Installation

Die folgenden Optionen sind mit folgenden Befehlen (Installationsprogramme) gültig: VDAServerSetup_xxxx.exe, VDAWorkstationSetup_xxxx.exe und VDAWorkstationCoreSetup_xxxx.exe.

Weitere Informationen zu den Optionen finden Sie unter VDAs installieren.

/components Komponente[,Komponente]

Durch Trennzeichen getrennte Liste der zu installierenden oder zu entfernenden Komponenten. Gültige Werte:
- VDA: Virtual Delivery Agent
- 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 oder geben Sie überhaupt keine Komponenten an. Wenn keine Komponenten angegeben sind, wird standardmäßig nur der VDA installiert.

Um nur den VDA zu installieren und die Installation der Citrix Workspace-App auszuschließen, geben Sie /components vda an.

Diese Option ist nicht gültig, wenn das Installationsprogramm VDAWorkstationCoreSetup_xxxx.exe verwendet wird. Mit dem Installationsprogramm kann die Citrix Workspace-App nicht installiert werden.
/controller “Controller [Controller]”

Durch Leerzeichen getrennte FQDNs der Controller, mit denen VDA kommunizieren kann; von geraden Anführungszeichen umschlossen. Geben Sie nicht die beiden Optionen /site_guid und /controllers an.
/disableexperiencemetrics

Verhindert das automatische Senden der bei Installation, Upgrade oder Deinstallation erfassten Analysedaten an Citrix.
/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 die UDP-Ports zu öffnen, die HDX Adaptive Transport verwendet, geben Sie zusätzlich zu dieser Option /enable_hdx_ports die Option /enable_hdx_udp_ports an.
/enable_hdx_udp_ports

Öffnet die vom adaptiven HDX-Transport verwendeten 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 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 den 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). 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.
/enablerestore oder /enablerestorecleanup

(Gilt nur für Einzelsitzungs-VDAs) Ermöglicht die automatische Rückkehr zum Wiederherstellungspunkt, wenn die VDA-Installation oder das Upgrade fehlschlägt.

Beim erfolgreichen Abschluss von Installation oder Upgrade:
- /enablerestorecleanup weist das Installationsprogramm an, den Wiederherstellungspunkt zu entfernen.
- /enablerestore weist das Installationsprogramm an, den Wiederherstellungspunkt beizubehalten, auch wenn er nicht verwendet wurde.
Weitere Informationen finden Sie unter Wiederherstellung bei Installations- oder Upgradefehlern.
/enable_ss_ports

Öffnet, wenn der Windows-Firewalldienst erkannt wird, die für die Bildschirmfreigabe erforderlichen Ports in der Windows-Firewall, selbst wenn die Firewall nicht aktiviert ist. Wenn Sie eine andere oder keine Firewall verwenden, müssen die Ports manuell geöffnet werden.

/exclude “Komponente”[,”Komponente”]

Verhindert die Installation der jeweils 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 Maschinenidentitätsdienstkomponente. Gültige Werte sind:

Multisitzungs-OS	Einzelsitzungs-OS	Core Services für Einzelsitzungs-OS
`Citrix App Protection Component`	`Citrix App Protection Component`	`Citrix App Protection Component`
`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 HyperV Filter Driver`	`Citrix HyperV Filter Driver`
`Citrix MCS IODriver`	`Citrix MCS IODriver`
`Citrix Personalization for App-V - VDA`	`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 Telemetry Service`	`Citrix Telemetry Service`	`Citrix Telemetry Service`
`Citrix Universal Print Client`	`Citrix Universal Print Client`	`Citrix Universal Print Client`
`Citrix Vda Log Capture Service`	`Citrix Vda Log Capture Service`	`Citrix Vda Log Capture Service`
`Citrix VDA Upgrade Agent`	`Citrix VDA Upgrade Agent`
`CSE Component`	`CSE Component`	`CSE Component`
`Director VDA Plug-in`	`Director VDA Plug-in`	`Director VDA Plug-in`
`Machine Identity Service`	`Machine Identity Service`
`Machine Management Provider`	`Machine Management Provider`	`Machine Management Provider`
	`User Personalization Layer`
`VDA Monitor Plug-in`	`VDA Monitor Plug-in`	`VDA Monitor Plug-in`
`VDA WMI Proxy Plug-in`	`VDA WMI Proxy Plug-in`	`VDA WMI Proxy Plug-in`

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

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

Diese Option ist nicht gültig, wenn das Installationsprogramm VDAWorkstationCoreSetup.exe verwendet wird. Das Installationsprogramm schließt viele dieser Elemente automatisch aus.

/h oder /help

Zeigt die Hilfe für Befehle an.

/includeadditional “Komponente”[,”Komponente”]

Bewirkt die Installation der jeweils in geraden Anführungszeichen angegebenen (durch Kommas getrennten) optionalen Komponenten. Die Option kann hilfreich sein, wenn Sie eine Remote-PC-Zugriff-Bereitstellung erstellen und andere Komponenten installieren möchten, die standardmäßig nicht enthalten sind. Gültige Werte sind:

Multisitzungs-OS	Einzelsitzungs-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 directory

Vorhandenes leeres Verzeichnis, in dem die Komponenten installiert werden. Standard = c:\Programme\Citrix.
/install_mcsio_driver

Nicht verwenden. Verwenden Sie stattdessen /includeadditional "Citrix MCS IODriver" oder /exclude "Citrix MCS IODriver"
/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 den VDA als Image ein, das zum Erstellen anderer Maschinen verwendet wird. Diese Option entspricht /mastermcsimage.

Diese Option ist nicht gültig, wenn das Installationsprogramm VDAWorkstationCoreSetup_xxxx.exe verwendet wird.
/mastermcsimage

Gibt an, dass die Maschine als Image zum Provisioning mit MCS verwendet wird. Diese Option entspricht /masterimage.
/masterpvsimage

Gibt an, dass die Maschine als Image zum Provisioning von VMs mit Citrix Provisioning oder einem Drittanbietertool (z. B. Microsoft System Center Configuration Manager) verwendet wird.
/websockettoken WebSocketToken

Erstellt einen Web Socket VDA. Das WebSocketToken ist für das Token, das benötigt wird.
/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, wird die VDA-Installation beendet, da die Voraussetzungen nicht erfüllt sind. Bei den meisten unterstützten Windows-Editionen ist Media Foundation bereits installiert. Eine Ausnahme bilden die N-Editionen. Wenn Sie Windows-Funktionen > Medienfunktionen manuell aktivieren, ist für den vom Citrix Meta Installer gesuchten Registrierungsschlüssel möglicherweise kein Wert festgelegt. Ü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.
/nodesktopexperience

Das Feature Enhanced Desktop Experience gibt es nicht mehr. Wird diese Option (bzw. die Richtlinieneinstellung) angegeben, so wird sie ignoriert.

Gilt nur für die Installation von VDAs für Multisitzungs-OS. 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 die Standardeinstellung 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.
/physicalmachine

Verwenden Sie dieses Argument zusammen mit /remotepc für die RemotePC-Installation. Andernfalls verhält sich der VDA in bestimmten Benutzerszenarios möglicherweise nicht wie erwartet.
/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.
/proxyconfig “Adresse oder PAC-Dateipfad”

Wenn Sie in Ihrer Umgebung das Rendezvous-Protokoll mit Gateway Service, VDA Upgrade Service usw. verwenden möchten und in Ihrem Netzwerk einen nicht transparenten Proxy 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 Rendezvous. Einzelheiten zu dem Feature finden Sie unter Rendezvousprotokoll.
- 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 Hinweis auf den Installations- und Konfigurationsvorgang ist im Windows Task-Manager. Wenn diese Option ausgelassen wird, wird die grafische Oberfläche gestartet.
/reconfigure

Passt zuvor konfigurierte VDA-Einstellungen an, wenn sie mit den Optionen /portnumber, /controllers oder /enable_hdx_ports verwendet werden. 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 (Einzelsitzungs-OS) oder vermittelte Verbindungen (Multisitzungs-OS). Schließt die Installation jeglicher zusätzlicher Komponenten aus (siehe Komponentenlisten mit den Optionen /exclude und /includeadditional ).

Diese Option ist nicht gültig, wenn das Installationsprogramm VDAWorkstationCoreSetup.exe verwendet wird. Das Installationsprogramm schließt diese Komponenten automatisch aus.

/remotepc ist nicht mit der Option /servervdi kompatibel.
/remove

Entfernt die mit /components angegebenen Komponenten.
/remove_appdisk_ack

Autorisiert den VDA-Installer, das AppDisks VDA-Plug-In, sofern installiert, zu deinstallieren.
/remove_pvd_ack

Autorisiert den VDA-Installer, Personal vDisk, sofern installiert, zu deinstallieren.
/removeall

Entfernt den VDA. Ist die Citrix Workspace App installiert, wird sie nicht entfernt.
/REMOVEALLWITHCWA

Entfernt CWA zusammen mit dem VDA.
/sendexperiencemetrics

Sendet automatisch bei Installation, Upgrade oder Deinstallation erfasste Analysedaten an Citrix. Wenn diese Option weggelassen wird (oder die Option /disableexperiencemetrics angegeben wird), werden Analysen lokal erfasst, aber nicht automatisch gesendet.
/servervdi

Installiert einen VDA für Einzelsitzungs-OS auf einer Maschine mit einem unterstützten Windows-Multisitzungs-OS. Wenn Sie einen VDA für Multisitzungs-OS auf einer Maschine für Multisitzungs-OS installieren, lassen Sie diese Option aus.

Lesen Sie vor dem Verwenden dieser Option Server-VDI.

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

GUID (Globally Unique Identifier) der Site 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 die beiden Optionen /site_guid und /controllers an.
/tempdir directory

Das Verzeichnis für die temporären Dateien während der Installation. Standard = 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.
/xendesktopcloud

Zeigt an, dass der VDA in Citrix DaaS (Citrix Cloud) installiert ist.

Beispiele für die Installation eines VDAs

Installieren eines VDAs mit dem Komplettinstallationsprogramm:

Mit dem folgenden Befehl werden ein VDA für Einzelsitzungs-OS und die Citrix Workspace-App am Standardspeicherort auf einer VM installiert. Der VDA wird als Image und MCS zum Provisioning von VMs verwendet. Der VDA registriert sich zunächst beim Controller auf dem Server mit dem Namen Contr-Main in der Domäne mydomain. Der VDA verwendet den Benutzerpersonalisierungslayer 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

Installation eines VDAs mit Einzelsitzungs-OS mit dem eigenständigen Installationsprogramm VDAWorkstationCoreSetup:

Mit dem folgenden Befehl wird ein Kernkomponenten-VDA unter einem Einzelsitzungs-OS zur Verwendung in einer Remote-PC-Zugriff- oder VDI-Bereitstellung installiert. Die Citrix Workspace-App 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 VDA

Nachdem VDA installiert wurde, können Sie einige Einstellungen anpassen. Führen Sie im Verzeichnis \x64\XenDesktop Setup auf dem Produktmedium XenDesktopVdaSetup.exe aus. Verwenden Sie dabei folgende Optionen, die unter Befehlszeilenoptionen zum Installieren eines VDA beschrieben sind.

/reconfigure (zum Anpassen des VDAs erforderlich)
/h oder /help
/quiet
/noreboot
/controllers
/portnumber port
/enable_hdx_ports

Problembehandlung bei VDAs

In Studio wird im Bereich Details für Bereitstellungsgruppen unter Installierte VDA-Version möglicherweise nicht die auf den Maschinen installierte Version angezeigt. In der Maschine wird in Windows unter “Programme und Features” die tatsächliche VDA-Version angezeigt.
Nach der Installation kann ein VDA erst dann Apps oder Desktops an Benutzer bereitstellen, wenn er sich bei einem Delivery Controller registriert hat.

Informationen zu VDA-Registrierungsmethoden und zur Behandlung von Registrierungsproblemen finden Sie unter VDA-Registrierung.

Befehlszeilenoptionen zum Installieren eines universellen Druckservers

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

/enable_upsserver_port

Wenn diese Option nicht angegeben wird, wird im Installationsprogramm die Seite Firewall angezeigt. Wählen Sie Automatisch, um die Windows-Firewallregeln automatisch vom Installationsprogramm hinzufügen zu lassen, oder Manuell, damit der Administrator die Firewall manuell konfigurieren kann.

Nach der Installation der Software auf den Druckservern konfigurieren Sie den universellen Druckserver anhand der Anweisungen unter Bereitstellen von Druckern.

Befehlszeilenoptionen zur Installation eines Secure Private Access

Die folgenden Optionen sind für beide gültig:

CVAD-Installationsprogramm: XenDesktopSPASetup.exe
SPA-Installationsprogramm vor Ort: SecurePrivateAccessSetup_XXXX.exe

/enable_spa_ports

Öffnet Ports in der Windows-Firewall, die für Secure Private Access benötigt werden, wenn der Windows-Firewalldienst erkannt wird, auch 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.
/nosql

Verhindert die Installation von Microsoft SQL Server Express auf dem Server, auf dem Sie Secure Private Access installieren. Wenn diese Option ausgelassen wird, wird SQL Server Express zur Verwendung als Sitedatenbank installiert.
/help oder /h oder /?

Zeigt die Hilfe für Befehle an
/noreboot

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 Konfigurationsvorgang ist im Windows Task-Manager. Wenn diese Option ausgelassen wird, wird die grafische Oberfläche gestartet.
/remove

Entfernt den 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 Installationsrückgabecodes.

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

War dieser Artikel hilfreich?

Installieren über die Befehlszeile

February 17, 2025

Beitrag von:

In diesem Artikel

War dieser Artikel hilfreich?