Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

Installation über die Befehlszeile

April 7, 2026
Beitrag von: 
C C

Wichtig:

  • Wenn Sie ein Upgrade durchführen und Ihre aktuelle Version die Personal vDisk- oder AppDisks-Software verwendet oder installiert hat, lesen Sie 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 behandelt 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. Details 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 Citrix Virtual Apps and Desktops-Version 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.

Verwenden des vollständigen Produktinstallationsprogramms

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

  1. Laden Sie das Produktpaket von Citrix herunter. Citrix-Kontodaten sind für den Zugriff auf die Download-Site 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 mounten Sie die ISO-Datei.

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

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

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

    Zur Installation von StoreFront: Führen Sie CitrixStoreFront-x64.exe im Ordner x64 > StoreFront auf dem Installationsmedium aus.

    Zur Installation des Federated Authentication Service: Citrix empfiehlt die Verwendung der grafischen Benutzeroberfläche.

    Zur Installation von Session Recording: Befolgen Sie die Anleitung unter Session Recording.

Befehlszeilenoptionen für die Installation von Kernkomponenten

-  Die folgenden Parameteroptionen sind gültig, wenn Kernkomponenten mit dem Befehl `XenDesktopServerSetup.exe` installiert werden. Weitere Details zu den Optionen finden Sie unter [Kernkomponenten installieren](/de-de/citrix-virtual-apps-desktops/install-configure/install-core-components).

Hinweis:

-  Verwenden Sie `/exclude` nicht, wenn Sie Befehlszeilenoptionen für die Installation von Kernkomponenten verwenden.
-  Wenn Sie eine Komponente mit `/components` aktualisieren, können auch andere Komponenten aktualisiert werden. Dies dient dazu, potenzielle Kompatibilitätsprobleme zwischen verschiedenen Komponenten zu vermeiden.
    • Wenn Sie nur eine Komponente aktualisieren möchten, verwenden Sie das individuelle Installationsprogramm dieser Komponente. Siehe Bereitstellung aktualisieren.
-  **/ceipoptin** *ceipoptin* [,*ceipoptin*] ...

-  Aktiviert 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 von nicht identifizierten 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](/de-de/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-call-home).

 Weitere Details zur CEIP-Datenerfassung finden Sie unter [Citrix Licensing Customer Experience Improvement Program](/de-de/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-customer-experience-improvement-program).

 Weitere Details zu CEIP-Daten finden Sie unter [Citrix Licensing CEIP-Datenelemente](/de-de/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-ceip-data-elements).

 Weitere Details zu Lizenzserver-Lizenzierungsdaten finden Sie unter [Citrix Lizenzierungsdaten](/de-de/licensing/current-release/license-server/licensing-data-collection-programs.html#citrix-licensing-compliance).

  • /components component [,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 Lizenzserver
    • SECUREPRIVATEACCESS: Secure Private Access

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

Diese Option ist nicht gültig, wenn das Installationsprogramm VDAWorkstationCoreSetup_xxxx.exe verwendet wird. Dieses Installationsprogramm kann die Citrix Workspace-App oder andere Citrix-Komponenten nicht installieren.

Wenn diese Option weggelassen wird, werden alle Komponenten installiert (oder entfernt, wenn auch die Option /remove angegeben ist).

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

  • /onlyprereqs

    Es werden nur die Voraussetzungen für die ausgewählten Komponenten installiert. Es werden keine Citrix Produktkomponenten installiert.

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

  • /disableexperiencemetrics

    Verhindert den automatischen Upload von Analysedaten, die während der Installation, des Upgrades oder der Deinstallation 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 während eines Controller-Upgrades gültig. Normalerweise werden alle Site-Testfehler ignoriert und das Upgrade wird fortgesetzt. Wenn diese Option weggelassen (oder auf false gesetzt) wird, führt jeder Site-Testfehler dazu, dass der Installer 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. Einzelheiten finden Sie unter SQL Server-Versionsprüfung.

  • /installdir directory

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

  • /logpath path

    • Speicherort der Protokolldatei. Der angegebene Ordner muss existieren. Der Installer erstellt ihn nicht. Standard = TEMP%\Citrix\XenDesktop Installer

  • /no_remote_assistance

  • Nur bei der Installation des Directors gültig. Deaktiviert die Benutzer-Shadowing-Funktion, die die Windows-Remoteunterstützung verwendet.

    • /noreboot

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

    • /noresume

    • Standardmäßig wird der Installer 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öchten.

    • /nosql

    Verhindert die Installation von Microsoft SQL Server Express auf dem Server, auf dem Sie den Controller installieren. Wenn diese Option weggelassen wird, wird SQL Server Express als Site-Datenbank installiert.

    Diese Option hat keinen Einfluss 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. Wenn diese Option weggelassen wird, wird die grafische Benutzeroberfläche gestartet.

  • /remove

    • Entfernt die Kernkomponenten, die mit der Option /components angegeben wurden.

  • /removeall

    • Entfernt alle installierten Kernkomponenten.

  • /sendexperiencemetrics

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

  • /tempdir directory

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

  • /xenapp

    Installiert Citrix Virtual Apps. Wenn diese Option weggelassen wird, 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. Die für die Komponentenkommunikation erforderlichen 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`

-  Wenn Sie ein Upgrade von Citrix Virtual Apps and Desktops Version 2407 auf 2411 oder höher durchführen oder eine Neuinstallation von Version 2411 oder höher vornehmen, aktualisieren Sie zuerst den Lizenzserver auf die neueste Version (Version 11.2.17 Build 51000). Führen Sie anschließend ein Upgrade des Delivery Controllers durch. Andernfalls schlagen Befehlszeileninstallationen und Upgrades fehl. Führen Sie die folgenden Befehle aus, um den Lizenzserver und Komponenten wie Delivery Controller, Web Studio und Citrix Director zu aktualisieren (vorausgesetzt, Sie befinden sich im Ordner „\x64“ auf der bereitgestellten ISO).

-  1.  Führen Sie Folgendes aus:

```
\x64\Licensing\CitrixLicensing.exe /quiet 
<!--NeedCopy--> ```

Wenn Sie die Lizenzierungsbinärdateien auf eines der lokalen Laufwerke kopiert haben, führen Sie den folgenden Befehl aus:

```
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy--> ```

  1. Führen Sie Folgendes aus:

    \x64\XenDesktop Setup\XenDesktopServerSetup.exe  /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL
<!--NeedCopy-->

Eigenständigen VDA-Installer verwenden

Citrix-Kontozugangsdaten sind erforderlich, um auf die Download-Site zuzugreifen. Sie müssen entweder über erweiterte Administratorrechte verfügen, bevor Sie die Installation starten, oder Als Administrator ausführen verwenden.

  1. Laden Sie das entsprechende Paket von Citrix herunter:
    • Virtual Delivery Agent für Multi-Session-Betriebssysteme: VDAServerSetup_xxxx.exe
    • Virtual Delivery Agent für Single-Session-Betriebssysteme: VDAWorkstationSetup_xxxx.exe
    • Virtual Delivery Agent für Single-Session-Betriebssysteme (Core Services): VDAWorkstationCoreSetup_xxxx.exe

  2. Extrahieren Sie die Dateien aus dem Paket zuerst 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, z. B. 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 <Extraktionsordner>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe aus.

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

    • Für VDAWorkstationSetup_XXXX.exe führen Sie <Extraktionsordner>\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 Produktinstaller vertraut sind:

  • Führen Sie den eigenständigen Installer VDAServerSetup.exe oder VDAWorkstationSetup.exe so aus, als wäre er der Befehl XenDesktopVdaSetup.exe, mit Ausnahme seines Namens.

  • Der Installer VDAWorkstationCoreSetup.exe ist anders, da er eine Untermenge der für die anderen Installer verfügbaren Optionen unterstützt.

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

  • VDA: Virtual Delivery Agent
  • CSA: Citrix Secure Access™ Client
  • PLUGINS: Citrix Workspace™-App für Windows
  • UPL: Citrix User Personalization Layer (nur für WS-VDA)
  • SRAGENT: Session Recording Agent
  • ASSISTANTAPP: ​​Citrix Assistant App (nur für WS-VDA)
    • CEAL: Citrix Elastic App Layering (nur für TS-VDA)

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.

Ab dieser Version sind Citrix Device Trust, Citrix uberAgent und der Citrix Workspace Environment Management™ (WEM) Agent in die Standard-VDA-Installation integriert. Diese Komponenten werden im Rahmen des VDA-Setups im Hintergrund installiert und werden nicht mehr als separate Komponenten verwaltet.

Hinweis: - > Wenn eine vorhandene eigenständige Version von Citrix uberAgent® in der Umgebung erkannt wird, wird sie vom Installer weder installiert, aktualisiert noch deinstalliert.

Um nur den VDA zu installieren und die Installation anderer Citrix-Komponenten auszuschließen, geben Sie „/components vda“ an.

  • Diese Option ist bei Verwendung des Installers „VDAWorkstationCoreSetup_xxxx.exe“ nicht gültig. Dieser Installer kann die Citrix Workspace-App oder andere Citrix-Komponenten nicht installieren.

Befehlszeilenoptionen für die Installation eines VDA

Die folgenden Optionen sind mit einem oder mehreren der folgenden Befehle (Installer) 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 Kommas getrennte Liste der zu installierenden oder zu entfernenden Komponenten. Gültige Werte sind:

    • VDA: Virtual Delivery Agent
    • PLUGINS: Citrix Workspace-App für Windows
    • CSA: Citrix Secure Access Client
    • UPL: Citrix User Personalization Layer (nur für WS-VDA)
    • SRAGENT: Session Recording Agent
    • ASSISTANTAPP: ​​Citrix Assistant App (nur für WS-VDA)
    • CEAL: Citrix Elastic App Layering (nur für TS-VDA)

  • Um den VDA und die Citrix Workspace-App für Windows zu installieren, geben Sie „/components vda, plugins, CSA, UPL“ an oder geben Sie überhaupt keine Komponenten an. Wenn keine Komponenten angegeben werden, werden standardmäßig nur der VDA, SRAGENT und ASSISTANTAPP installiert.

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

  • Diese Option ist ungültig, wenn der Installer VDAWorkstationCoreSetup_xxxx.exe verwendet wird. Dieser Installer kann die Citrix Workspace-App nicht installieren.

  • /onlyprereqs

    • Es werden nur die Voraussetzungen für die ausgewählten Komponenten installiert. Es werden keine Citrix-Produktkomponenten installiert.

  • /controllers “controller [controller]”

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

  • /disableexperiencemetrics

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

  • /enable_hdx_ports

  • Öffnet Ports in der Windows-Firewall, die vom VDA und den aktivierten Funktionen (außer Windows-Remoteunterstützung) benötigt werden, 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. Informationen zu Ports finden Sie unter Netzwerkports.

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

  • /enable_hdx_udp_ports

  • Öffnet UDP-Ports in der Windows-Firewall, die der HDX Adaptive Transport verwendet, 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. 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 auch 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-Firewall-Dienst erkannt wird.

  • /enable_remote_assistance

    Aktiviert die Shadowing-Funktion in der Windows-Remoteunterstützung zur Verwendung mit Director. Wenn Sie diese Option angeben, öffnet die Windows-Remoteunterstü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, falls 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, auch wenn er nicht verwendet wurde.

    Weitere Informationen finden Sie unter Wiederherstellung bei Installations- oder Upgrade-Fehler.

  • /ENABLE_SECURE_DEFAULTS

  • Ändert die Standardeinstellung für verschiedene Funktionen von aktiviert auf deaktiviert, um eine sicherere Out-of-the-Box-Konfiguration zu ermöglichen. Die relevanten Funktionen sind: Clientlaufwerksumleitung, Umleitung spezieller Ordner, Drag & Drop, Client-TWAIN-Geräteumleitung, Client-USB-Plug-and-Play-Geräteumleitung, Client-Druckerumleitung, Client-Zwischenablageumleitung und Client-Mikrofonumleitung.

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

  • /SKIPHDXDRIVERCHECK

    Überspringt die Überprüfung der HDX™-Treiber für den VDA-Meta-Installer.

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

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

    Multi-Session-OS Single-Session-OS Single-Session-OS Core Services
    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 deviceTRUST® Citrix deviceTRUST Citrix deviceTRUST
    uberAgent® uberAgent uberAgent
  • Citrix Secure Access Client Citrix Secure Access Client Citrix Secure Access Client
    Citrix Workspace Environment Management™ Agent Citrix Workspace Environment Management Agent Citrix Workspace Environment Management Agent
  • 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
    Session Recording Agent​ Session Recording Agent​  
    Elastic App Layering ​​Citrix Assistant App  

    Das Ausschließen von Citrix Profile Management von der Installation (/exclude "Citrix Profile Management") wirkt sich auf die Überwachung und Fehlerbehebung von VDAs mit Citrix Director aus. Auf den Seiten Benutzerdetails und Endpunkt schlagen das Personalisierungsfeld und das Anmeldedauerfeld fehl. Auf den Seiten Dashboard und Trends zeigt das Feld “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. Die Aktivierung 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 ungültig, wenn der Installer VDAWorkstationCoreSetup.exe verwendet wird. Dieser Installer schließt viele dieser Elemente automatisch aus.

  • /h oder /help

    Zeigt die Befehlshilfe an.

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

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

    Multi-Session-Betriebssystem Single-Session-Betriebssystem
    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. Konfiguriert den VDA als Image, das zur Erstellung anderer Maschinen verwendet werden soll. Diese Option entspricht /mastermcsimage.

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

  • /mastermcsimage

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

  • /masterpvsimage

    Gibt an, dass diese Maschine als Image mit Citrix Provisioning™ oder einem Drittanbieter-Bereitstellungstool (wie Microsoft System Center Configuration Manager) zur Bereitstellung von VMs verwendet wird.

  • /websockettoken WebSocketToken

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

  • /websockettokenfile DateiMitWebSockToken

    Erstellt einen Web Socket VDA. Die DateiMitWebSockToken steht für die Datei, die das erforderliche Token enthält.

  • /websockettokenstdin <WebSocketToken

    Erstellt einen Web Socket VDA. Der <WebSocketToken steht für das erforderliche Token, das über STDIN übergeben wird.

  • /no_mediafoundation_ack

    Bestätigt, dass Microsoft Media Foundation nicht installiert ist und mehrere HDX-Multimediafunktionen nicht installiert und nicht funktionieren werden. 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, mit Ausnahme der 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.

  • /nodesktopexperience

    Die Funktion „Enhanced Desktop Experience“ 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 „Enhanced Desktop Experience“. Diese Funktion 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

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

  • /physicalmachine

    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.

  • /portnumber Port

    Gültig nur, 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 „Adresse oder PAC-Dateipfad“

    Wenn Sie beabsichtigen, das Rendezvous V2-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. Diese Befehlszeile installiert Citrix Rendezvous V2 automatisch, als ob /includeadditional "Citrix Rendezvous V2" verwendet worden wäre. Einzelheiten zu den Funktionen 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 Hinweis auf den Installations- und Konfigurationsprozess ist der Windows Task-Manager. Wenn diese Option weggelassen wird, startet die grafische Benutzeroberfläche.

  • /reconfigure

    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, startet die grafische Benutzeroberfläche zur Anpassung des VDA.

  • /remotepc

    Gültig nur für Remote PC Access-Bereitstellungen (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 Installers VDAWorkstationCoreSetup.exe nicht gültig. Dieser Installer schließt die Installation dieser Komponenten automatisch aus.

    /remotepc ist nicht mit der Option /servervdi kompatibel.

  • /remove

    Entfernt die mit der Option /components angegebenen Komponenten.

  • /remove_appdisk_ack

    Autorisiert den VDA-Installer, das AppDisks™ VDA-Plug-in zu deinstallieren, falls es installiert ist.

  • /remove_pvd_ack

    Autorisiert den VDA-Installer, Personal vDisk zu deinstallieren, falls es installiert ist.

  • /removeall

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

  • /REMOVEALLWITHCWA

    Entfernt CWA zusammen mit dem VDA.

  • /sendexperiencemetrics

    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 ist), werden Analysedaten lokal gesammelt, aber nicht automatisch gesendet.

  • /servervdi

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

    Bevor Sie diese Option verwenden, lesen Sie Server VDI.

    Verwenden Sie diese Option nur mit dem vollständigen VDA-Installer.

  • /site_guid GUID

    Global eindeutiger Bezeichner (GUID) der Active Directory Organisationseinheit (OU) des Standorts. Dies ordnet einen virtuellen Desktop einem Standort zu, wenn Sie Active Directory zur Erkennung verwenden (automatische Aktualisierung ist die empfohlene und standardmäßige Erkennungsmethode). Die Standort-GUID ist eine in Studio angezeigte Standorteigenschaft. 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.

  • /virtualmachine

    Gültig nur bei der Installation eines VDA auf einer VM. Überschreibt die Erkennung einer physischen Maschine durch den Installer, wenn BIOS-Informationen, die an VMs übergeben werden, diese als physische Maschinen erscheinen lassen.

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

  • /xendesktopcloud

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

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 die Benutzerpersonalisierungsebene und die Windows-Remoteunterstützung.

```
\x64\Licensing\CitrixLicensing.exe /quiet 
<!--NeedCopy--> ```

Einzelsitzungs-Betriebssystem-VDA 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.

```
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log
<!--NeedCopy--> ```

VDA anpassen

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

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

Fehlerbehebung bei VDAs

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

  • Nach der Installation eines VDA kann dieser erst dann Apps oder einen Desktop für Benutzer bereitstellen, wenn er sich bei einem Delivery Controller registriert hat.

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

Befehlszeilenoptionen für die Installation eines Universal Print Servers

Die folgende Option ist mit dem Befehl XenDesktopPrintServerSetup.exe 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-Firewall-Regeln 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 Citrix Universal Print Server (UPS).

Befehlszeilenoptionen für die Installation von Secure Private Access

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

  1. CVAD-Installationsprogramm: XenDesktopSPASetup.exe
  2. SPA On-Prem-Installationsprogramm: SecurePrivateAccessSetup_XXXX.exe

  • /enable_spa_ports

    Öffnet die von Secure Private Access benötigten Ports in der Windows-Firewall, 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. 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 weggelassen wird, wird SQL Server Express zur Verwendung als Sitedatenbank installiert.

  • /help oder /h oder /?

    Zeigt die Befehlshilfe 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 Nachweis des Installations- und Konfigurationsprozesses ist im Windows Task-Manager zu finden. Wenn diese Option weggelassen wird, wird die grafische Benutzeroberfläche gestartet.

  • /remove

    Entfernt Secure Private Access.

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

Installation über die Befehlszeile
April 7, 2026
Beitrag von: 
C C
April 7, 2026
Beitrag von: 
C C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.