Produktdokumentation
Citrix DaaS™
PDF anzeigen

VDAs über die Befehlszeile installieren

March 25, 2026
Beitrag von: 
C C

Einführung

Dieser Artikel behandelt die Installation, das Upgrade und die Anpassung von Virtual Delivery Agents (VDAs) auf Maschinen mit Windows-Betriebssystemen.

Dieser Artikel beschreibt, wie VDA-Installationsbefehle ausgeführt werden. Bevor Sie mit einer Installation beginnen, lesen Sie VDAs installieren, um sich über Installationsüberlegungen, Installationsprogramme und die bei der Installation anzugebenden Informationen zu informieren.

VDA über die Befehlszeile installieren

Um einen VDA zu installieren (und den Fortschritt der Befehlsausführung sowie Rückgabewerte anzuzeigen), müssen Sie über erhöhte Administratorberechtigungen verfügen oder Als Administrator ausführen verwenden.

  1. Melden Sie sich auf der Maschine, auf der Sie den VDA installieren, bei Citrix Cloud an.
  2. Wählen Sie im Menü oben links Solutions > DaaS aus.
  3. Klicken Sie oben rechts auf Downloads und wählen Sie VDA herunterladen aus. Sie werden zur VDA-Downloadseite weitergeleitet. Suchen Sie das gewünschte VDA-Installationsprogramm und klicken Sie auf Datei herunterladen.

  4. Nach Abschluss des Downloads führen Sie den Namen aus. Verwenden Sie die in diesem Artikel beschriebenen Optionen.

    • Führen Sie für den Multi-Session-OS Virtual Delivery Agent VDAServerSetup.exe aus.

    • Führen Sie für den Single-Session-OS Virtual Delivery Agent VDAWorkstationSetup.exe aus.

    • Führen Sie für den Single-Session-OS Core Services Virtual Delivery Agent VDAWorkstationCoreSetup.exe 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 existieren. 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ühren Sie für VDAServerSetup_XXXX.exe <extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe aus.

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

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

Befehlszeilenoptionen zur Installation eines VDA

Die folgenden Optionen sind mit einem oder mehreren der Befehle gültig: VDAServerSetup.exe, VDAWorkstationSetup.exe und VDAWorkstationCoreSetup.exe.

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

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

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

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

  • /controllers “Controller [Controller]…”

    Durch Leerzeichen getrennte FQDNs von Citrix Cloud Connectors, 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 erfasst wurden, an Citrix.

  • /enable_hdx_ports

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

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

  • /enable_hdx_udp_ports

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

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

  • /enable_real_time_transport

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

  • /enable_remote_assistance

    Aktiviert die Shadowing-Funktion in der Windows-Remoteunterstützung zur Verwendung mit den Monitor-Funktionen. 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, wenn die VDA-Installation oder das Upgrade fehlschlägt.

    Wenn die Installation/das Upgrade erfolgreich abgeschlossen wird:

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

  • /enable_ss_ports

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

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

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

    • Machine Identity Service
    • Citrix Profile Management
    • Citrix Profile Management WMI-Plug-in
    • Citrix Personalization für App-V - VDA
    • Citrix MCS IODriver
    • Citrix VDA Upgrade Agent
    • Citrix Rendezvous V2

    Der Ausschluss von Citrix Profile Management von der Installation (/exclude "Citrix Profile Management") beeinträchtigt die Überwachung und Fehlerbehebung von VDAs über die Monitor-Konsole. 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 das Profilmanagement 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 MCS zur Bereitstellung von VMs verwenden möchten, schließen Sie den Machine Identity Service nicht aus.

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

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

  • /h oder /help

    Zeigt die Befehlshilfe an.

  • /includeadditional “component”[,”component”] …

    Ermöglicht die Installation einer oder mehrerer durch Kommas getrennter optionaler Komponenten, die jeweils in geraden Anführungszeichen eingeschlossen sind. Die Komponentennamen sind Groß-/Kleinschreibung-sensitiv.

    Diese Option kann hilfreich sein, wenn Sie eine Remote-PC-Zugriffsbereitstellung erstellen und Komponenten installieren möchten, die standardmäßig nicht enthalten sind. Gültige Werte sind:

    • Citrix Profile Management
    • Citrix Profile Management WMI-Plug-in
    • Citrix Personalization für App-V - VDA
    • Citrix MCS IODriver
    • Citrix VDA Upgrade Agent
    • Citrix Rendezvous V2
    • Benutzerpersonalisierungsebene
    • Citrix Web Socket VDA Registrierungstool

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

  • /installdir directory

    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 path

    Speicherort der Protokolldatei. Der angegebene Ordner muss existieren. Der Installer 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. Diese Option entspricht /mastermcsimage.

    Diese Option ist bei Verwendung des VDAWorkstationCoreSetup.exe-Installers 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) verwendet wird.

  • /no_mediafoundation_ack

    Bestätigt, dass Microsoft Media Foundation nicht installiert ist und mehrere HDX™ Multimedia-Funktionen nicht installiert werden und nicht funktionieren. 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 installiertem Media Foundation geliefert, außer N-Editionen.

  • /nodesktopexperience

    Nur gültig bei der Installation eines Multi-Session-OS-VDA. 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 der Installer bei einem erforderlichen Neustart während einer Installation nach Abschluss des Neustarts automatisch fortgesetzt. Um die Standardeinstellung zu überschreiben, geben Sie /noresume an. Dies kann hilfreich sein, wenn Sie das Medium neu einbinden oder Informationen während einer automatisierten Installation erfassen möchten.

  • /portnumber port

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

  • /proxyconfig “address or PAC file path”

    Nur gültig, wenn der Befehl /includeadditional "Citrix Rendezvous V2" enthält. Die Adresse oder der PAC-Dateipfad des Proxys zur Verwendung mit dem Rendezvous-Protokoll. Details zur Funktion finden Sie unter Rendezvous-Protokoll.

    • Format der Proxy-Adresse: 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 im Windows Task-Manager sichtbar. 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, wird die grafische Benutzeroberfläche zur Anpassung des VDA gestartet.

  • /remotepc

    Gültig nur für Remote PC Access-Bereitstellungen (Einzelsitzungs-Betriebssystem) oder vermittelte Verbindungen (Mehrfachsitzungs-Betriebssystem).

    Diese Option ist bei Verwendung des Installationsprogramms VDAWorkstationCoreSetup.exe nicht gültig. Dieses Installationsprogramm schließt die Installation dieser Komponenten automatisch aus.

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

  • /remove

    Entfernt die mit der Option /components angegebenen Komponenten.

  • /removeall

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

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

  • /servervdi

    Installiert einen Einzelsitzungs-OS-VDA auf einem unterstützten Windows-Server. Lassen Sie diese Option weg, wenn Sie einen Mehrfachsitzungs-VDA auf einem Windows-Server installieren. Bevor Sie diese Option verwenden, lesen Sie Server-VDI.

  • /site_guid guid

    Globally Unique Identifier (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 directory

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

  • /xendesktopcloud

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

Beispiele: VDA installieren

  • VDA auf einem Mehrfachsitzungs-Betriebssystem installieren. Der folgende Befehl installiert einen VDA auf einem Mehrfachsitzungs-Betriebssystem.

    VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage

    Der VDA wird als Image verwendet.

  • Mehrfachsitzungs-OS-VDA oder Einzelsitzungs-OS-VDA installieren. Der folgende Befehl installiert einen Mehrfachsitzungs-OS-VDA oder einen Einzelsitzungs-OS-VDA.

    VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot

    Trennen Sie jeden Delivery Controller™ FQDN durch ein Komma. Beachten Sie, dass XXXX die VDA-Version darstellt.

  • Core Services VDA auf einem Einzelsitzungs-Betriebssystem installieren. Der folgende Befehl installiert einen Core Services VDA auf einem Einzelsitzungs-Betriebssystem zur Verwendung in einer Remote PC Access- oder VDA-Bereitstellung.

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

    Die Citrix Workspace-App und andere Nicht-Core-Dienste werden nicht installiert. Die Adresse eines Cloud Connectors wird angegeben, und Ports im Windows-Firewall-Dienst werden automatisch geöffnet. Der Administrator übernimmt die Neustarts.

VDA über die Befehlszeile anpassen

Nach der Installation eines VDA können Sie verschiedene Einstellungen anpassen. Führen Sie XenDesktopVDASetup.exe aus und verwenden Sie eine oder mehrere der folgenden Optionen.

  • /reconfigure (erforderlich bei der Anpassung eines VDA)
  • /h oder /help
  • /quiet
  • /noreboot
  • /controllers
  • /portnumber port
  • /enable_hdx_ports

Nächste Schritte

VDAs über die Befehlszeile installieren
March 25, 2026
Beitrag von: 
C C
March 25, 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.