Produktdokumentation
Citrix Virtual Apps and Desktops 7 2203 LTSR
PDF anzeigen

Installation über die Befehlszeile

June 5, 2026
Beitrag von: 
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.

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 ausgegeben 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 Beispielskripts bereitgestellt, die VDAs auf Maschinen in Active Directory installieren, aktualisieren oder entfernen. Einzelheiten finden Sie unter Installieren von VDAs mit Skripts.

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

Informationen dazu, wie Citrix das Ergebnis 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. 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 stellen Sie die ISO-Datei bereit.

  5. Führen Sie aus dem \x64\XenDesktop Setup Verzeichnis 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.

    So installieren Sie einen VDA: Führen Sie XenDesktopVDASetup.exe mit den unter Befehlszeilenoptionen zum Installieren 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 zum Installieren eines Universal Print Servers.

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

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

Befehlszeilenoptionen zum Installieren von Kernkomponenten

Die folgenden Optionen 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 zum Installieren 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 das individuelle Installationsprogramm dieser Komponente. Siehe Bereitstellung aktualisieren.

  • /components Komponente [,component] …

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

    • CONTROLLER: Controller
    • DESKTOPSTUDIO: Studio
    • DESKTOPDIRECTOR: Director
    • LICENSESERVER: Citrix Lizenzserver

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

    (In Versionen 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).

  • /configure_firewall

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

  • /deaktiviereerfahrungsmetriken

    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, auch 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 Fehler bei der Standortprüfung ignoriert und das Upgrade wird fortgesetzt. Wenn weggelassen (oder auf false gesetzt), führt jeder Fehler bei der Standortprüfung 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.

  • /installdir Verzeichnis

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

  • /logpath Pfad

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

  • /no_pending_reboot_check

    Verhindert bei der Installation oder dem Upgrade von Kernkomponenten die Überprüfung auf einen ausstehenden Neustart einer früheren Windows-Installation auf dem Computer.

  • /no_remote_assistance

    Nur bei der Installation von Director gültig. 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.)

  • /keineWiederaufnahme

    Standardmäßig wird das Installationsprogramm, wenn während einer Installation ein Neustart des Computers erforderlich ist, 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 müssen oder Informationen während einer automatisierten Installation erfassen möchten.

  • /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 Auswirkung auf die Installation von SQL Server Express LocalDB, die für den lokalen Hostcache verwendet wird.

  • /quiet oder /passive

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

  • /entfernen

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

  • /alleentfernen

    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.

  • /tempverzeichnis 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. Die für die Komponentenkommunikation erforderlichen Firewallports 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 Firewallports werden automatisch geöffnet.

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

Verwenden eines eigenständigen VDA-Installationsprogramms

Citrix-Anmeldeinformationen sind für den Zugriff auf die Download-Site erforderlich. Sie müssen entweder über erhöhte Administratorrechte verfügen, bevor Sie die Installation starten, oder Als Administrator ausführen verwenden.

  1. Laden Sie das entsprechende Paket von Citrix herunter:
    • Multi-Session-OS Virtual Delivery Agent: VDAServerSetup.exe
    • Single-Session-OS Virtual Delivery Agent: VDAWorkstationSetup.exe
    • Single-Session-OS Core Services Virtual Delivery Agent: VDAWorkstationCoreSetup.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 .\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 in allem außer seinem Namen.

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

Befehlszeilenoptionen zum Installieren 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]

    Kommagetrennte Liste der zu installierenden oder zu entfernenden Komponenten. Gültige Werte sind:

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

    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 von Controllern, 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.

  • /erfahrungsmetrikendeaktivieren

    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 aktivierten Funktionen (außer Windows-Remotedesktopunterstützung) benötigt werden, wenn der Windows-Firewall-Dienst erkannt wird, selbst 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 die Option /enable_hdx_udp_ports zusätzlich zu dieser Option /enable_hdx_ports an.

  • /enable_hdx_udp_ports

    Öffnet UDP-Ports in der Windows-Firewall, die der adaptive HDX-Transport verwendet, wenn der Windows-Firewall-Dienst erkannt wird, selbst 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 die Option /enable_hdx_ports zusätzlich zu dieser Option /enable_hdx_udp_ports an.

  • /enable_real_time_transport

    Aktiviert oder deaktiviert die Verwendung von UDP für Audiopakete (Echtzeit-Audiotransport 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-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

    (Gilt nur 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 Upgradefehler.

  • /enable_ss_ports

    Öffnet Ports in der Windows-Firewall, die für die Bildschirmfreigabe erforderlich sind, wenn der Windows-Firewall-Dienst erkannt wird, selbst 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. Wenn Sie beispielsweise einen VDA auf einem nicht von MCS verwalteten Image installieren oder aktualisieren, ist die Komponente „Machine Identity Service“ nicht erforderlich. 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 Supportability Tools Citrix Supportability Tools Machine Management Provider
    Citrix Telemetry Service Citrix Telemetry Service VDA Monitor Plug-in
    Citrix Universal Print Client Citrix Universal Print Client VDA WMI Proxy Plug-in
    Citrix Vda Log Capture Service Citrix Vda Log Capture Service  
    Citrix VDA Upgrade Agent Citrix VDA Upgrade Agent  
    Citrix WEM Agent Citrix WEM 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  

    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 die Installation und Ausführung des Citrix Profile Management Service. 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 bei Verwendung des VDAWorkstationCoreSetup.exe-Installationsprogramms nicht gültig. Dieses Installationsprogramm schließt viele dieser Elemente automatisch aus.

  • /h oder /help

    Zeigt die Befehlshilfe an.

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

    Umfasst 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 Supportability Tools Citrix Supportability Tools
    Citrix VDA Upgrade Agent Citrix VDA Upgrade Agent
    Citrix WEM Agent Citrix WEM Agent
    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.

  • /Master-Image

    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 ungültig, wenn der VDAWorkstationCoreSetup_xxxx.exe Installer verwendet wird.

  • /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 Drittanbieter-Bereitstellungstool (wie Microsoft System Center Configuration Manager) zur Bereitstellung von VMs verwendet wird.

  • /no_mediafoundation_ack

    Bestätigt, dass Microsoft Media Foundation nicht installiert ist und mehrere HDX™ Multimedia-Funktionen nicht installiert und nicht funktionieren werden. Wenn diese Option weggelassen wird und Media Foundation nicht installiert ist, schlägt die VDA-Installation fehl. Die meisten unterstützten Windows-Editionen werden mit bereits installierter Media Foundation geliefert, mit Ausnahme der N-Editionen.

  • /ohneDesktopErfahrung

    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.

  • /ohneNeustart

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

  • /ohneFortsetzung

    Standardmäßig wird der Installer, wenn während einer Installation ein Maschinenneustart erforderlich ist, nach Abschluss des Neustarts 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öchten.

  • /Portnummer 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“

    Gültig nur, wenn der Befehl /includeadditional “Citrix Rendezvous V2” enthält. Die Adresse oder der PAC-Dateipfad des Proxys zur Verwendung mit dem Rendezvous-Protokoll. Details zu dieser Funktion finden Sie unter Rendezvous-Protokoll.

    • Format der Proxyadresse: http://<url-or-ip>:<port>
    • Format der PAC-Datei: 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. Wird diese Option weggelassen, wird die grafische Benutzeroberfläche gestartet.

  • Rekonfigurieren

    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.

  • Remote-PC

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

    /remotepc ist nicht mit der Option /servervdi kompatibel.

  • Entfernen

    Entfernt die mit der Option /components angegebenen Komponenten.

  • /remove_appdisk_ack

    Autorisiert das VDA-Installationsprogramm, das AppDisks™ VDA-Plug-In zu deinstallieren, falls es installiert ist.

  • /remove_pvd_ack

    Autorisiert das VDA-Installationsprogramm, Personal vDisk zu deinstallieren, falls es installiert ist.

  • /allesentfernen

    Entfernt den VDA. Es entfernt nicht die Citrix Workspace-App (falls installiert).

  • /erfahrungsmetrikensenden

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

  • /ServerVDI

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

    Bevor Sie diese Option verwenden, siehe Server-VDI.

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

  • /standort_guid GUID

    Globale eindeutige Kennung der Active Directory-Organisationseinheit (OU) der Site. Dies ordnet einen virtuellen Desktop einer Site zu, wenn Sie Active Directory zur 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.

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

  • /virtuellemaschine

    Nur gültig bei der Installation eines VDA auf einer VM. Überschreibt die Erkennung einer physischen Maschine durch das Installationsprogramm, 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.

  • /wem_add_firewall_rules

    Fügt WEM-Agent-Firewallregeln hinzu.

  • /wem_agent_cache_location

    Alternativer WEM-Agent-Cache-Speicherort.

  • /wem_agent_port

    Port, den der WEM-Agent für die Kommunikation mit dem WEM-Infrastrukturserver verwendet.

  • /wem_cached_data_sync_port

    Port, den der WEM-Agent zur Synchronisierung des Caches mit dem WEM-Infrastrukturserver verwendet.

  • /wem_cloud_connectors

    Durch Kommas getrennte Liste der Citrix Cloud™ Connectors am Ressourcenstandort, der die WEM-Bereitstellung enthält.

  • /wem_server

    FQDN oder IP-Adresse des WEM-Infrastrukturservers.

  • /xendesktopcloud

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

Beispiele für die Installation eines VDA

Installieren Sie einen VDA mit dem vollständigen Produktinstallationsprogramm:

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\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /components vda,plugins /controllers "Contr-Main.mydomain.local" /enable_hdx_ports /includeadditional "user personalization layer" /mastermcsimage /enable_remote_assistance

Installieren Sie einen Einzelsitzungs-OS-VDA mit dem eigenständigen Installationsprogramm VDAWorkstationCoreSetup:

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

Einen VDA anpassen

Nachdem Sie einen VDA installiert haben, können Sie verschiedene Einstellungen anpassen. Führen Sie aus dem Verzeichnis \x64\XenDesktop Setup auf dem Produktmedium XenDesktopVdaSetup.exe aus, unter Verwendung einer oder mehrerer der folgenden Optionen, 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 entspricht der Eintrag Installierte VDA-Version im Bereich Details möglicherweise nicht der auf den Maschinen installierten Version. Die Anzeige „Programme und Funktionen“ von Windows auf 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
Software Ordner Dateiname
Microsoft Visual C++ 2017 Runtime, 32-Bit und 64-Bit Support > VcRedist_2017 vcredist_x64.exe und vcredist_x86.exe
Citrix Diagnosefunktion x64 > Komponenten für virtuelle Desktops cdf_x64.msi
Universal Print Server-Serverkomponente x64 > Universal Print Server UpsServer_x64.msi

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

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

Weitere Informationen

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

Installation über die Befehlszeile
June 5, 2026
Beitrag von: 
C
June 5, 2026
Beitrag von: 
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.