Produktdokumentation

Installation vorbereiten

June 5, 2026
Beitrag von: 
C

Die Bereitstellung von Citrix Virtual Apps and Desktops™ beginnt mit der Installation der folgenden Komponenten. Dieser Prozess bereitet die Bereitstellung von Anwendungen und Desktops für Benutzer innerhalb Ihrer Firewall vor.

  • Ein oder mehrere Delivery Controller
  • Citrix Director
  • Citrix StoreFront™
  • Citrix Lizenzserver
  • Ein oder mehrere Citrix Virtual Delivery Agents (VDAs)
  • Optionale Komponenten und Technologien wie der Universal Print Server, der Federated Authentication Service und Self-Service Password Reset

Für Benutzer außerhalb Ihrer Firewall installieren und konfigurieren Sie eine zusätzliche Komponente, z. B. Citrix Gateway. Eine Einführung finden Sie unter Citrix Virtual Apps and Desktops in Citrix Gateway integrieren.

Hinweis:

Stellen Sie sicher, dass die folgenden Microsoft-Voraussetzungen auf dem Server-Betriebssystem und dem Workstation-Betriebssystem erfüllt sind:

Wenn Ihre Bereitstellung Windows Server-Workloads umfasst, konfigurieren Sie einen Microsoft RDS-Lizenzserver.

Sie können das vollständige Produktinstallationsprogramm auf der Produkt-ISO verwenden, um viele Komponenten und Technologien bereitzustellen. Sie können ein eigenständiges VDA-Installationsprogramm verwenden, um VDAs zu installieren. Die eigenständigen VDA-Installationsprogramme sind auf der Citrix Download-Website verfügbar. Alle Installationsprogramme bieten grafische und Befehlszeilenschnittstellen. Siehe Installationsprogramme.

Die Produkt-ISO enthält Beispielskripte, die VDAs für Maschinen in einem Active Directory installieren, aktualisieren oder entfernen. Sie können die Skripte auch verwenden, um Images zu verwalten, die von Machine Creation Services (MCS) und Citrix Provisioning (ehemals Provisioning Services) verwendet werden. Weitere Informationen finden Sie unter VDAs mit Skripten installieren.

Informationen zur Überprüfung vor der Installation

  • Technischer Überblick: Um sich mit dem Produkt und seinen Komponenten vertraut zu machen.
  • Sicherheit: Bei der Planung Ihrer Bereitstellungsumgebung.
  • Bekannte Probleme: Probleme, die in dieser Version auftreten können.
  • Datenbanken: Erfahren Sie mehr über die Systemdatenbanken und deren Konfiguration. Während der Controller-Installation können Sie SQL Server Express als Site-Datenbank installieren. Die meisten Datenbankinformationen konfigurieren Sie beim Erstellen einer Site, nachdem Sie die Kernkomponenten installiert haben.
  • Remote-PC-Zugriff: Wenn Sie eine Umgebung bereitstellen, die es Ihren Benutzern ermöglicht, remote auf ihre physischen Maschinen im Büro zuzugreifen.
  • Verbindungen und Ressourcen: Wenn Sie einen Hypervisor oder einen anderen Dienst verwenden, um VMs für Anwendungen und Desktops zu hosten oder bereitzustellen. Die erste Verbindung können Sie beim Erstellen einer Site konfigurieren (nachdem Sie die Kernkomponenten installiert haben). Richten Sie Ihre Virtualisierungsumgebung vorher ein.
  • Microsoft System Center Configuration Manager: Wenn Sie ConfigMgr verwenden, um den Zugriff auf Anwendungen und Desktops zu verwalten, oder wenn Sie die Wake-on-LAN-Funktion mit Remote-PC-Zugriff verwenden.
  • Hostverbindungen zur Public Cloud: Wenn Sie eine Hybrid Rights License besitzen, können Sie Hostverbindungen zur Public Cloud erstellen. Informationen zur Hybrid Rights License finden Sie unter Hybrid Rights Renewals. Informationen zur Public Cloud-Berechtigung und den Gründen für diese Änderung finden Sie unter CTX270373.

Installationsort der Komponenten

Lesen Sie die Systemanforderungen für unterstützte Plattformen, Betriebssysteme und Versionen. Komponentenvoraussetzungen werden automatisch installiert, sofern nicht anders angegeben. Informationen zu den unterstützten Plattformen und Voraussetzungen von Citrix StoreFront und Citrix License Server finden Sie in der jeweiligen Dokumentation.

Sie können die Kernkomponenten auf demselben Server oder auf verschiedenen Servern installieren.

  • Die Installation aller Kernkomponenten auf einem Server kann für Evaluierungs-, Test- oder kleine Produktionsbereitstellungen geeignet sein.
  • Um zukünftige Erweiterungen zu ermöglichen, sollten Sie die Komponenten auf verschiedenen Servern installieren. Wenn Sie beispielsweise Studio auf einer anderen Maschine als dem Server installieren, auf dem Sie den Controller installiert haben, können Sie die Site remote verwalten.

  • Für die meisten Produktionsbereitstellungen wird die Installation von Kernkomponenten auf separaten Servern empfohlen.

    Installieren Sie den Citrix Lizenzserver und die Lizenzen, bevor Sie andere Komponenten auf anderen Servern installieren.

  • Um eine unterstützte Komponente auf einem Server CoreOS (z. B. einem Delivery Controller) zu installieren, müssen Sie die Befehlszeile verwenden. Dieser Betriebssystemtyp bietet keine grafische Benutzeroberfläche, daher installieren Sie Studio und andere Tools an anderer Stelle und verweisen Sie dann auf den Controller-Server.

Sie können sowohl einen Delivery Controller™ als auch einen VDA für Multi-Session-OS auf demselben Server installieren. Starten Sie das Installationsprogramm und wählen Sie den Delivery Controller (sowie alle anderen Kernkomponenten, die Sie auf diesem Computer wünschen) aus. Starten Sie dann das Installationsprogramm erneut und wählen Sie den Virtual Delivery Agent für Multi-Session-OS aus.

Stellen Sie sicher, dass jedes Betriebssystem die neuesten Updates hat.

Stellen Sie sicher, dass alle Maschinen synchronisierte Systemuhren haben. Die Kerberos-Infrastruktur, die die Kommunikation zwischen den Maschinen sichert, erfordert eine Synchronisierung.

Bei XenServern kann der Energiezustand der virtuellen Maschine als unbekannt angezeigt werden, selbst wenn sie registriert erscheint. Um dieses Problem zu beheben, bearbeiten Sie den Wert des Registrierungsschlüssels HostTime, um die Zeitsynchronisierung mit dem Host zu deaktivieren:

HKEY_LOCAL_MACHINE\Software\Citrix\XenTools\HostTime="Local"

HKEY_LOCAL_MACHINE\Software\Wow6432Node\Citrix\XenTools\HostTime="Local"

Tipp:

Der Standardwert ist HostTime="UTC". Ändern Sie diesen Wert in etwas anderes als UTC, zum Beispiel Local. Diese Änderung deaktiviert effektiv die Zeitsynchronisierung mit dem Host.

Optimierungshinweise für Windows 10 Single-Session-Maschinen finden Sie unter CTX216252.

Wo Komponenten NICHT installiert werden sollten:

  • Installieren Sie keine Komponenten auf einem Active Directory-Domänencontroller.
  • Die Installation eines Controllers auf einem Knoten in einer SQL Server-Clustering-Installation, einer SQL Server-Spiegelungsinstallation oder auf einem Server mit Hyper-V wird nicht unterstützt.

Wenn Sie versuchen, einen VDA auf einem Windows-Betriebssystem zu installieren oder zu aktualisieren, das von dieser Produktversion nicht unterstützt wird, führt Sie eine Meldung zu einem Artikel, der Optionen beschreibt.

Berechtigungen und Active Directory-Anforderungen

Sie müssen ein Domänenbenutzer und ein lokaler Administrator auf den Maschinen sein, auf denen Sie Komponenten installieren.

Um ein eigenständiges VDA-Installationsprogramm zu verwenden, müssen Sie über erhöhte Administratorrechte verfügen oder Als Administrator ausführen verwenden.

Konfigurieren Sie Ihre Active Directory-Domäne, bevor Sie eine Installation starten.

  • Systemanforderungen listet die unterstützten Active Directory-Funktionsebenen auf. In Active Directory eingebunden enthält weitere Informationen.
  • Sie müssen mindestens einen Domänencontroller haben, der Active Directory-Domänendienste ausführt.
  • Installieren Sie keine Citrix Virtual Apps and Desktops-Komponenten auf einem Domänencontroller.
  • Verwenden Sie keinen Schrägstrich (/), wenn Sie Namen von Organisationseinheiten in Studio angeben.

Das Windows-Benutzerkonto, das zur Installation des Citrix Lizenzservers verwendet wird, wird automatisch als vollständiger Administrator für die delegierte Administration konfiguriert.

Weitere Informationen:

Installationsanleitung, Überlegungen und bewährte Methoden

Während der Installation einer Komponente

  • Wenn Sie einen Delivery Controller, Studio, Lizenzserver oder Director von den vollständigen Produktmedien installieren oder aktualisieren und das Citrix-Installationsprogramm erkennt, dass ein Neustart von einer früheren Windows-Installation auf dem Computer aussteht, stoppt das Installationsprogramm mit dem Exit-/Rückgabecode 9. Sie werden aufgefordert, den Computer neu zu starten.

    Dies ist kein von Citrix erzwungener Neustart. Er ist auf andere Komponenten zurückzuführen, die zuvor auf dem Computer installiert wurden. Tritt dies auf, starten Sie den Computer neu und starten Sie dann das Citrix-Installationsprogramm erneut.

    Bei Verwendung der Befehlszeilenschnittstelle können Sie die Überprüfung auf den ausstehenden Neustart verhindern, indem Sie die Option /no_pending_reboot_check in den Befehl aufnehmen.

  • Wenn eine Komponente Voraussetzungen hat, stellt das Installationsprogramm diese in der Regel bereit, falls sie nicht vorhanden sind. Einige Voraussetzungen erfordern möglicherweise einen Neustart des Computers.

  • Wenn Sie Objekte vor, während und nach der Installation erstellen, geben Sie für jedes Objekt eindeutige Namen an. Geben Sie beispielsweise eindeutige Namen für Netzwerke, Gruppen, Kataloge und Ressourcen an.

  • Wenn eine Komponente nicht erfolgreich installiert wird, wird die Installation mit einer Fehlermeldung beendet. Erfolgreich installierte Komponenten bleiben erhalten. Sie müssen sie nicht neu installieren.

  • Citrix Analytics werden automatisch erfasst, wenn Sie Komponenten installieren (oder aktualisieren). Standardmäßig werden diese Daten nach Abschluss der Installation automatisch zu Citrix hochgeladen. Wenn Sie Komponenten installieren, werden Sie außerdem automatisch in das Citrix Customer Experience Improvement Program (CEIP) aufgenommen, das anonyme Daten hochlädt.

    Während der Installation können Sie auch an anderen Citrix-Technologien teilnehmen, die Diagnosedaten für Wartung und Fehlerbehebung erfassen. Informationen zu diesen Programmen finden Sie unter Citrix Insight Services.

  • Google Analytics werden automatisch erfasst (und später hochgeladen), wenn Sie Studio installieren (oder aktualisieren). Nach der Installation von Studio können Sie diese Einstellung mit dem Registrierungsschlüssel HKLM\Software\Citrix\DesktopStudio\GAEnabled ändern. Ein Wert von 1 aktiviert die Erfassung und den Upload, 0 deaktiviert die Erfassung und den Upload.

  • Schlägt eine VDA-Installation fehl, analysiert ein MSI-Analysator das fehlerhafte MSI-Protokoll und zeigt den genauen Fehlercode an. Der Analysator schlägt einen CTX-Artikel vor, falls es sich um ein bekanntes Problem handelt. Der Analysator erfasst auch anonymisierte Daten zum Fehlercode des Fehlers. Diese Daten werden zusammen mit anderen von CEIP erfassten Daten übermittelt. Wenn Sie die Teilnahme an CEIP beenden, werden die erfassten MSI-Analysatordaten nicht mehr an Citrix gesendet.

Während der VDA-Installation

  • Die Citrix Workspace™-App für Windows ist verfügbar, wird aber bei der Installation eines VDA nicht standardmäßig installiert. Sie oder Ihre Benutzer können die Citrix Workspace-App für Windows und andere Citrix Workspace-Apps von der Citrix-Website herunterladen und installieren (und aktualisieren). Alternativ können Sie diese Citrix Workspace-Apps über Ihren StoreFront-Server bereitstellen. Siehe die StoreFront-Dokumentation.

  • Der Microsoft Print Spooler-Dienst muss aktiviert sein. Sie können einen VDA nicht erfolgreich installieren, wenn dieser Dienst deaktiviert ist.

  • Die meisten unterstützten Windows-Editionen werden mit bereits installierter Microsoft Media Foundation geliefert. Wenn der Computer keine Media Foundation hat (z. B. N-Editionen), werden mehrere Multimediafunktionen nicht installiert und funktionieren nicht.

    • Windows Media-Umleitung
    • HTML5-Video-Umleitung
    • HDX™ RealTime Webcam-Umleitung

    Sie können die Einschränkung bestätigen oder die VDA-Installation beenden und sie später nach der Installation von Media Foundation neu starten. In der grafischen Benutzeroberfläche wird diese Option in einer Meldung angezeigt. In der Befehlszeile können Sie die Option /no_mediafoundation_ack verwenden, um die Einschränkung zu bestätigen.

  • Wenn Sie den VDA installieren, wird automatisch eine neue lokale Benutzergruppe namens Direct Access Users erstellt. Auf einem VDA für Einzelsitzungs-Betriebssysteme gilt diese Gruppe nur für RDP-Verbindungen. Auf einem VDA für Mehrsitzungs-Betriebssysteme gilt diese Gruppe für ICA®- und RDP-Verbindungen.

  • Der VDA muss über gültige Controller-Adressen verfügen, mit denen er kommunizieren kann. Andernfalls können keine Sitzungen eingerichtet werden. Sie können Controller-Adressen bei der Installation des VDA oder später angeben. Denken Sie daran, dass dies geschehen muss. Weitere Informationen finden Sie unter VDA-Registrierung.

Neustarts nach und während der VDA-Installation

Am Ende der VDA-Installation ist ein Neustart erforderlich. Dieser Neustart erfolgt standardmäßig automatisch.

Wenn Sie einen VDA auf Version 7.17 (oder eine später unterstützte Version) aktualisieren, erfolgt während des Upgrades ein Neustart. Dies kann nicht vermieden werden.

Um die Anzahl der Neustarts während der VDA-Installation zu minimieren:

  • Stellen Sie sicher, dass eine unterstützte .NET Framework-Version installiert ist, bevor Sie mit der VDA-Installation beginnen.
  • Installieren und aktivieren Sie für Windows-Mehrsitzungs-Betriebssystemmaschinen die RDS-Rollendienste, bevor Sie den VDA installieren.

Wenn Sie diese Voraussetzungen nicht vor der Installation des VDA installieren:

  • Wenn Sie die grafische Benutzeroberfläche oder die Befehlszeilenschnittstelle ohne die Option /noreboot verwenden, wird der Computer nach der Installation der Voraussetzung automatisch neu gestartet.
  • Wenn Sie die Befehlszeilenschnittstelle mit der Option /noreboot verwenden, müssen Sie den Neustart initiieren.

Wenn Sie eine VDA-Version aktualisieren, erfolgt während des Upgrades ein Neustart. Dies kann nicht vermieden werden.

Wiederherstellung bei Installations- oder Upgradefehler

Hinweis:

Diese Funktion ist für Single-Session- und Multi-Session-VDAs verfügbar.

Wenn die Installation oder das Upgrade eines Single-Session-VDA fehlschlägt und die Funktion „Wiederherstellung bei Fehler“ aktiviert ist, wird der Computer auf einen Wiederherstellungspunkt zurückgesetzt, der vor Beginn der Installation oder des Upgrades festgelegt wurde.

Wenn die Installation oder das Upgrade eines Multi-Session-VDA fehlschlägt und die Funktion „Wiederherstellung bei Fehler“ aktiviert ist, wird der Computer auf eine Sicherung zurückgesetzt, die vor Beginn der Installation oder des Upgrades durchgeführt wurde.

Wenn die Installation oder das Upgrade eines Single-Session-VDA mit aktivierter Funktion beginnt, erstellt das Installationsprogramm einen Systemwiederherstellungspunkt, bevor die eigentliche Installation oder das Upgrade beginnt. Schlägt die VDA-Installation oder das Upgrade fehl, wird der Computer auf den Zustand des Wiederherstellungspunkts zurückgesetzt. Der Ordner %temp%/Citrix enthält Bereitstellungsprotokolle und weitere Informationen zur Wiederherstellung.

Wenn die Installation oder das Upgrade eines Multi-Session-VDA mit aktivierter Funktion beginnt, erstellt das Installationsprogramm eine Serversicherung, bevor die eigentliche Installation oder das Upgrade beginnt. Schlägt die VDA-Installation oder das Upgrade fehl, wird der Computer auf den Sicherungszustand zurückgesetzt. Der Ordner %temp%/Citrix enthält Bereitstellungsprotokolle und weitere Informationen zur Wiederherstellung. Die Zeit, die zum Erstellen der Serversicherung benötigt wird, hängt von der Größe der benötigten Sicherung und der Menge der dem Server zur Verfügung stehenden Ressourcen ab. Die Sicherung wird unter C:\WindowsImageBackup\servername gespeichert.

Standardmäßig ist diese Funktion deaktiviert.

Wenn Sie diese Funktion aktivieren möchten, stellen Sie sicher, dass die Systemwiederherstellung nicht über eine GPO-Einstellung (Computer Configuration > Administrative Templates > System > System Restore) deaktiviert ist.

Hinweis:

Diese GPO-Einstellung gilt nicht für die Wiederherstellung eines Multi-Session-VDA.

So aktivieren Sie diese Funktion bei der Installation oder dem Upgrade eines Single- oder Multi-Session-VDA:

  • Wenn Sie die grafische Benutzeroberfläche eines VDA-Installationsprogramms verwenden (z. B. mit Autostart oder dem Befehl XenDesktopVDASetup.exe ohne Wiederherstellungs- oder unbeaufsichtigte Optionen), aktivieren Sie das Kontrollkästchen Automatische Wiederherstellung bei Updatefehlern aktivieren auf der Seite Zusammenfassung.

    Wenn die Installation/das Upgrade erfolgreich abgeschlossen wird, wird der Wiederherstellungspunkt/die Sicherung nicht verwendet, aber beibehalten.

  • Führen Sie ein VDA-Installationsprogramm mit der Option /enablerestore oder /enablerestorecleanup über die Befehlszeile aus.

    • Wenn Sie die Option /enablerestorecleanup verwenden und die Installation/das Upgrade erfolgreich abgeschlossen wird, wird der Wiederherstellungspunkt/die Serversicherung automatisch entfernt.

    • Wenn Sie die Option /enablerestore verwenden und die Installation/das Upgrade erfolgreich abgeschlossen wird, wird der Wiederherstellungspunkt nicht verwendet, aber beibehalten.

Installationsprogramme

Vollständiges Produktinstallationsprogramm

Mit dem vollständigen Produktinstallationsprogramm, das auf der ISO bereitgestellt wird, können Sie:

  • Kernkomponenten installieren, aktualisieren oder entfernen: Delivery Controller, Studio, Director und Lizenzserver.
  • StoreFront installieren oder aktualisieren.
  • Windows-VDAs für Einzel- oder Mehrsitzungsbetriebssysteme installieren oder aktualisieren.
  • Die Komponente UpsServer des Universal Print Servers auf Ihren Druckservern installieren.
  • Federated Authentication Service installieren.
  • Session Recording installieren.

  • Workspace Environment Management installieren.

    Hinweis:

    Das Installationsprogramm für den Workspace Environment Management™ Agent ist nicht lokalisiert. Es ist nur in englischer Sprache verfügbar.

Um einen Desktop von einem Multisitzungs-OS für einen Benutzer (z. B. für die Webentwicklung) bereitzustellen, verwenden Sie die Befehlszeilenschnittstelle des vollständigen Produktinstallationsprogramms. Weitere Informationen finden Sie unter Server-VDI.

Eigenständige VDA-Installationsprogramme

Eigenständige VDA-Installationsprogramme sind auf den Citrix-Downloadseiten verfügbar. (Sie sind nicht auf den Produktinstallationsmedien verfügbar.) Die eigenständigen VDA-Installationsprogramme sind wesentlich kleiner als die vollständige Produkt-ISO. Sie eignen sich besser für Bereitstellungen, die:

  • Electronic Software Distribution (ESD)-Pakete verwenden, die bereitgestellt oder lokal kopiert werden
  • Physische Maschinen haben
  • Über Remotebüros verfügen

Standardmäßig werden Dateien in den selbstextrahierenden eigenständigen VDAs in den Ordner Temp extrahiert. Beim Extrahieren in den Ordner Temp ist auf dem Computer mehr Speicherplatz erforderlich als bei Verwendung des vollständigen Produktinstallationsprogramms. Dateien, die in den Ordner Temp extrahiert werden, werden jedoch nach Abschluss der Installation automatisch gelöscht. Alternativ können Sie den Befehl /extract mit einem absoluten Pfad verwenden.

Vier eigenständige VDA-Installationsprogramme stehen zum Download zur Verfügung.

Virtual Delivery Agent für Multisitzungs-OS (VDAServerSetup.exe):

Installiert einen VDA für Multisitzungs-OS. Er unterstützt alle Optionen für den VDA für Multisitzungs-OS, die mit dem vollständigen Produktinstallationsprogramm verfügbar sind.

Virtual Delivery Agent für Einzelsitzungs-OS (VDAWorkstationSetup.exe):

Installiert einen VDA für Einzelsitzungs-OS. Er unterstützt alle Optionen für den VDA für Einzelsitzungs-OS, die mit dem vollständigen Produktinstallationsprogramm verfügbar sind.

Virtual Delivery Agent für Einzelsitzungs-OS-Kerndienste (VDAWorkstationCoreSetup.exe):

Installiert einen VDA für Einzelsitzungs-OS, der für Remote-PC-Zugriffsbereitstellungen oder Core-VDI-Installationen optimiert ist. Der Remote-PC-Zugriff verwendet physische Maschinen. Core-VDI-Installationen sind VMs, die nicht als Image verwendet werden. Es werden nur die Kerndienste installiert, die für VDA-Verbindungen solcher Bereitstellungen erforderlich sind. Daher unterstützt es nur eine Untergruppe der Optionen, die mit dem vollständigen Produktinstallationsprogramm oder den VDAWorkstationSetup.exe Installationsprogrammen gültig sind.

Dieses Installationsprogramm installiert oder enthält nicht die Komponenten, die verwendet werden für:

  • App-V.
  • Profile Management. Das Ausschließen von Citrix Profile Management von der Installation wirkt sich auf die Anzeigen von Citrix Director aus. Weitere Informationen finden Sie unter VDAs installieren.
  • Machine Identity Service.
  • Citrix MCS IODriver
  • Citrix Sicherung und Wiederherstellung
  • deviceTRUST
  • uberAgent
  • WEM

Der VDAWorkstationCoreSetup.exe-Installer installiert oder enthält die folgenden Komponenten nicht: Citrix Workspace-App für Windows (CWA), Citrix Secure Access Client (CSA) und Citrix User Personalization Layer (UPL).

Die Verwendung von VDAWorkstationCoreSetup.exe entspricht der Verwendung des Vollprodukt- oder VDAWorkstationSetup-Installers zur Installation eines Single-Session-OS-VDA und entweder:

  • In der grafischen Benutzeroberfläche: Auswählen der Option Remote PC Access auf der Seite Umgebung.
  • In der Befehlszeilenschnittstelle: Angeben der Option /remotepc.
  • In der Befehlszeilenschnittstelle: Angeben von /components vda plus der Option /exclude, die alle gültigen Namen zusätzlicher Komponenten auflistet.

Sie können die weggelassenen Komponenten/Funktionen später durch Ausführen des Vollprodukt-Installers installieren. Diese Aktion ermöglicht Ihnen die Installation aller fehlenden Komponenten.

Der VDAWorkstationCoreSetup.exe-Installer installiert automatisch die Browser Content Redirection MSI. Diese automatische Installation gilt für VDA Release 2003 und spätere unterstützte Releases.

Virtual Delivery Agent für Kernservices für Einzelsitzungen (VDASingleSessionCoreSetup.exe):

Ab Release 2507 CU1 ist ein neuer, schlanker VDA-Meta-Installer für Einzelsitzungen für Windows 365 Cloud PC- und Remote PC-Bereitstellungen verfügbar. Dieser Installer basiert auf dem bestehenden VDAWorkstationCoreSetup.exe-Installer und liefert wesentliche VDA-Komponenten zusammen mit Profile Management, deviceTRUST, uberAgent, WEM, Backup and Restore und dem VDA Upgrade Agent. Die Backup- und Restore-Funktionalität kann über die Befehlszeilenoption /enablerestore oder /enablerestorecleanup aktiviert werden.

Er reduziert die Paketgröße erheblich und verbessert die Installationszuverlässigkeit für cloudbasierte Workloads. Dieser Installer wurde für moderne Remote PC-Szenarien entwickelt und bietet eine vereinfachte und leistungsstarke Option für die Bereitstellung von Citrix-Workloads auf Windows 365 und Remote PC.

Best Practices für die Verwendung von Einzelsitzungs-VDA-Installationsprogrammen

Für Einzelsitzungs-Betriebssysteme stehen vier verschiedene Installer zur Verfügung. Der vollständige VDA-Installer und der VDAWorkstationSetup.exe-Installer ermöglichen die Installation aller Komponenten, während einige Standard- und zusätzliche Komponenten in den Installern VDAWorkstationCoreSetup.exe und VDASingleSessionCoreSetup.exe nicht enthalten sind.

Um die Stabilität der Umgebung, eine konsistente Leistung und die fortlaufende Supportfähigkeit zu gewährleisten, empfiehlt Citrix, über den gesamten Lebenszyklus eines Citrix VDA – einschließlich Installation, Upgrade und Deinstallation – einen konsistenten Installationstyp zu verwenden. Das Mischen von Installationstypen kann bestimmte Risiken mit sich bringen.

Risiken beim Mischen von Installationstypen:

Szenario 1: Wenn ein VDA für Einzelsitzungen ursprünglich mit dem Installer VDAWorkstationCoreSetup.exe oder VDASingleSessionCoreSetup.exe installiert und anschließend mit dem vollständigen VDA-Installer oder dem VDAWorkstationSetup.exe-Installer aktualisiert wurde, können zuvor ausgeschlossene Komponenten während des Upgrades installiert werden, es sei denn, sie werden explizit ausgeschlossen.

Szenario 2: Wenn ein VDA für Einzelsitzungen ursprünglich mit dem vollständigen VDA-Installer oder VDAWorkstationSetup.exe installiert und später mit VDAWorkstationCoreSetup.exe oder VDASingleSessionCoreSetup.exe aktualisiert wird, werden alle Komponenten, die nicht vom VDA-Installer für Kernservices installiert wurden, vom Upgrade ausgeschlossen. Diese Komponenten werden weder während des Upgrade-Prozesses aktualisiert noch bei der Deinstallation entfernt.

Szenario 3: Wenn ein VDA für Einzelsitzungen ursprünglich mit dem Installer VDAWorkstationCoreSetup.exe installiert und anschließend mit VDASingleSessionCoreSetup.exe aktualisiert wird, profitieren Sie von den neuen Funktionen. Wenn Sie das nächste Mal mit VDAWorkstationCoreSetup.exe aktualisieren, werden die neu hinzugefügten Komponenten von VDASingleSessionCoreSetup.exe weder im Upgrade-Prozess aktualisiert noch bei der Deinstallation entfernt.

Anleitung zum Umgang mit gemischten Installationstypen:

Sollte es notwendig werden, Installationstypen zu mischen, ist es unerlässlich sicherzustellen, dass dieselben Komponenten während des Upgrade-Prozesses enthalten sind.

In Fällen, in denen Installationstypen versehentlich gemischt wurden, was dazu führte, dass zusätzliche Komponenten installiert wurden oder bestimmte Komponenten nicht mehr verwaltet werden konnten, und die vorherige Umgebung wiederhergestellt werden muss, gehen Sie bitte wie folgt vor:

  • Für Szenario 1: Deinstallieren Sie den VDA über die Windows-Funktion zum Deinstallieren oder Ändern von Programmen und installieren Sie den VDA dann mit dem ursprünglich verwendeten Installer (VDAWorkstationCoreSetup.exe oder VDASingleSessionCoreSetup.exe) neu.

  • Für Szenario 2: Aktualisieren Sie die fehlenden Komponenten mit dem vollständigen VDA-Installer oder dem VDAWorkstationSetup.exe-Installer.

  • Für Szenario 3: Wenn Sie weiterhin neue Funktionen nutzen möchten, aktualisieren Sie die fehlenden Komponenten mit dem Installer VDASingleSessionCoreSetup.exe. Wenn Sie die neuen Funktionen nach dem Upgrade mit VDASingleSessionCoreSetup.exe nicht nutzen möchten, deinstallieren Sie den VDA zunächst über die Windows-Funktion zum Deinstallieren oder Ändern von Programmen und installieren Sie den VDA dann mit VDAWorkstationCoreSetup.exe neu.

Rückgabecodes für Citrix-Installationen

Das Installationsprotokoll enthält das Ergebnis der Komponenteninstallationen als Citrix-Rückgabecode, nicht als Microsoft-Wert.

  • 0 = Erfolg
  • 1 = Fehlgeschlagen
  • 2 = Teilerfolg
  • 3 = Teilerfolg und Neustart erforderlich
  • 4 = Fehler und Neustart erforderlich
  • 5 = Vom Benutzer abgebrochen
  • 6 = Ungültiges Befehlszeilenargument
  • 7 = Neuere Version gefunden
  • 8 = Erfolg, Neustart erforderlich
  • 9 = Dateisperre, Neustart
  • 10 = Abgebrochen
  • 11 = Medienfehler
  • 12 = Lizenzfehler
  • 13 = Vorabprüfung fehlgeschlagen
  • 14 = Abgebrochene Prüfung auf ausstehenden Neustart
  • 15 = Vorabprüfung bestanden – Dies wird zurückgegeben, wenn die Vorabprüfungen nach Verwendung der neuen Befehlszeilenoption /precheckonly erfolgreich sind.
  • 16 = Vorabprüfung fehlgeschlagen – Dies wird zurückgegeben, wenn die Vorabprüfungen nach Verwendung der neuen Befehlszeilenoption /precheckonly fehlschlagen.
  • 17 = Optionale Software fehlgeschlagen – Dies wird zurückgegeben, wenn eine der neuen optionalen Softwarekomponenten nicht installiert werden konnte und die Option „VDA-Installation oder -Upgrade fortsetzen, wenn andere ausgewählte Komponenten fehlschlagen.“ ausgewählt wurde.

Wenn Sie beispielsweise Tools wie den Microsoft System Center Configuration Manager verwenden, kann eine skriptgesteuerte VDA-Installation fehlschlagen, wenn das Installationsprotokoll den Rückgabecode 3 enthält. Dies kann vorkommen, wenn das VDA-Installationsprogramm auf einen Neustart wartet, den Sie initiieren müssen (z. B. nach der Installation einer RDS-Rollen-Voraussetzung auf einem Server). Eine VDA-Installation gilt erst dann als erfolgreich, wenn alle Voraussetzungen und ausgewählten Komponenten installiert sind und der Computer nach der Installation neu gestartet wurde.

Alternativ können Sie Ihre Installation in CMD-Skripte einschließen (die Microsoft-Exitcodes zurückgeben) oder die Erfolgscodes in Ihrem Configuration Manager-Paket ändern.

Einen Microsoft RDS-Lizenzserver für Windows Server-Workloads konfigurieren

Dieses Produkt greift auf Windows Server-Remotesitzungsfunktionen zu, wenn es eine Windows Server-Workload, z. B. Windows 2016, bereitstellt. Dies erfordert in der Regel eine Remote Desktop Services-Clientzugriffslizenz (RDS-CAL). Der VDA muss in der Lage sein, einen RDS-Lizenzserver zu kontaktieren, um RDS-CALs anzufordern. Installieren und aktivieren Sie den Lizenzserver. Weitere Informationen finden Sie im Microsoft-Dokument Activate the Remote Desktop Services License Server. Für Proof-of-Concept-Umgebungen können Sie die von Microsoft bereitgestellte Kulanzfrist nutzen.

Mit dieser Methode können Sie diesen Dienst die Lizenzservereinstellungen anwenden lassen. Sie können den Lizenzserver und den Pro-Benutzer-Modus in der RDS-Konsole auf dem Image konfigurieren. Sie können den Lizenzserver auch mithilfe von Microsoft Gruppenrichtlinieneinstellungen konfigurieren. Weitere Informationen finden Sie im Microsoft-Dokument License your RDS deployment with client access licenses (CALs).

So konfigurieren Sie den RDS-Lizenzserver mithilfe von Gruppenrichtlinieneinstellungen:

  1. Installieren Sie einen Remote Desktop Services-Lizenzserver auf einem verfügbaren Computer. Der Computer muss immer verfügbar sein. Die Citrix-Produkt-Workloads müssen diesen Lizenzserver erreichen können.
  2. Geben Sie die Lizenzserveradresse und den Pro-Benutzer-Lizenzmodus mithilfe von Microsoft Gruppenrichtlinien an. Einzelheiten finden Sie im Microsoft-Dokument Specify the Remote Desktop Licensing Mode for an RD Session Host Server.

Windows 10-Workloads erfordern eine entsprechende Windows 10-Lizenzaktivierung. Wir empfehlen, dass Sie die Microsoft-Dokumentation zur Aktivierung von Windows 10-Workloads befolgen.

Weitere Informationen

Zum Einrichten des Ressourcenstandorts für bestimmte Hosttypen:

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