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 vorbereiten

April 6, 2026
Beitrag von: 
C 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-Site verfügbar. Alle Installationsprogramme bieten grafische Benutzeroberflächen und Befehlszeilenschnittstellen. Siehe Installationsprogramme.

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

  • Informationen, die vor der Installation zu prüfen sind

  • 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 Sitedatenbank installieren. Die meisten Datenbankinformationen konfigurieren Sie beim Erstellen einer Site, nachdem Sie die Kernkomponenten installiert haben.
  • Remote PC Access: 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 zum Hosten oder Bereitstellen von VMs für Anwendungen und Desktops verwenden. Sie können die erste Verbindung 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 Access 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.

Wo Komponenten installiert werden

Lesen Sie die Systemanforderungen für unterstützte Plattformen, Betriebssysteme und Versionen. Komponenten-Voraussetzungen werden automatisch installiert, sofern nicht anders angegeben. Informationen zu unterstützten Plattformen und Voraussetzungen für Citrix StoreFront und Citrix Lizenzserver finden Sie in deren 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 funktionieren.
  • 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-Betriebssysteme auf demselben Server installieren. Starten Sie das Installationsprogramm und wählen Sie den Delivery Controller (plus alle anderen Kernkomponenten, die Sie auf dieser Maschine wünschen). Starten Sie dann das Installationsprogramm erneut und wählen Sie den Virtual Delivery Agent für Multi-Session-Betriebssysteme.

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 XenServers kann der Energiezustand der virtuellen Maschine als unbekannt angezeigt werden, selbst wenn sie registriert ist. Um dieses Problem zu beheben, bearbeiten Sie den Registrierungsschlüsselwert 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, z. B. Local. Diese Änderung deaktiviert effektiv die Zeitsynchronisierung mit dem Host.

Optimierungsleitfäden für Windows 10 Einzel-Sitzungs-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, auf dem Hyper-V ausgeführt wird, 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.

  • Berechtigungs- und Active Directory-Anforderungen

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

    • Um einen eigenständigen VDA-Installer 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 mit Active Directory-Domänendiensten betreiben.
    • Installieren Sie keine Citrix Virtual Apps™ and Desktops-Komponenten auf einem Domänencontroller.

    • Verwenden Sie keinen Schrägstrich (/) bei der Angabe von Namen von Organisationseinheiten in Studio.

    • Das Windows-Benutzerkonto, das zur Installation des Citrix Lizenzservers verwendet wird, wird automatisch als delegierter Administrator mit vollen Rechten konfiguriert.

Weitere Informationen:

Installationsanleitung, Überlegungen und Best Practices

Während der Installation einer beliebigen Komponente

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

    Dies ist kein von Citrix erzwungener Neustart. Er ist auf andere Komponenten zurückzuführen, die zuvor auf der Maschine installiert wurden. Wenn dies auftritt, starten Sie die Maschine neu und starten Sie dann den Citrix Installer 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.

  • Normalerweise stellt der Installer, wenn eine Komponente Voraussetzungen hat, diese bereit, falls sie nicht vorhanden sind. Einige Voraussetzungen erfordern möglicherweise einen Maschinenneustart.

  • 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, stoppt die Installation mit einer Fehlermeldung. Erfolgreich installierte Komponenten bleiben erhalten. Sie müssen diese 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 wählen, an anderen Citrix-Technologien teilzunehmen, die Diagnosedaten für Wartung und Fehlerbehebung sammeln. 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 das Hochladen, 0 deaktiviert die Erfassung und das Hochladen.

    • Schlägt eine VDA-Installation fehl, analysiert ein MSI-Analyseprogramm das fehlerhafte MSI-Protokoll und zeigt den genauen Fehlercode an. Das Analyseprogramm schlägt einen CTX-Artikel vor, falls es sich um ein bekanntes Problem handelt. Das Analyseprogramm erfasst auch anonymisierte Daten über den Fehlercode des Fehlers. Diese Daten werden zusammen mit anderen von CEIP erfassten Daten übermittelt. Wenn Sie die Teilnahme am CEIP beenden, werden die erfassten MSI-Analysedaten 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 Multimedia-Funktionen 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 Wahl 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 Mehrfachsitzungs-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 hergestellt werden. Sie können Controller-Adressen bei der Installation des VDA oder später angeben. Denken Sie daran, dass dies erfolgen 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 während der VDA-Installation erforderlichen Neustarts 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-Mehrfachsitzungs-Betriebssysteme 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, startet der Computer nach der Installation der Voraussetzung automatisch neu.
  • 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 Upgrade-Fehler

Hinweis:

Diese Funktion ist für Einzelsitzungs- und Mehrfachsitzungs-VDAs verfügbar.

Schlägt eine Einzelsitzungs-VDA-Installation oder ein Upgrade fehl und ist die Funktion “Wiederherstellung bei Fehler” aktiviert, wird der Computer auf einen Wiederherstellungspunkt zurückgesetzt, der vor Beginn der Installation oder des Upgrades festgelegt wurde.

Schlägt eine Mehrfachsitzungs-VDA-Installation oder ein Upgrade fehl und ist die Funktion “Wiederherstellung bei Fehler” aktiviert, wird der Computer auf eine Sicherung zurückgesetzt, die vor Beginn der Installation oder des Upgrades durchgeführt wurde.

Wenn eine Installation oder ein Upgrade eines Single-Session-VDAs mit aktivierter Funktion beginnt, erstellt das Installationsprogramm einen Systemwiederherstellungspunkt, bevor die eigentliche Installation oder das Upgrade gestartet wird. 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 eine Installation oder ein Upgrade eines Multi-Session-VDAs mit aktivierter Funktion beginnt, erstellt das Installationsprogramm ein Server-Backup, bevor die eigentliche Installation oder das Upgrade gestartet wird. Schlägt die VDA-Installation oder das Upgrade fehl, wird der Computer auf den Backup-Zustand zurückgesetzt. Der Ordner %temp%/Citrix enthält Bereitstellungsprotokolle und weitere Informationen zur Wiederherstellung. Die Zeit, die für die Erstellung des Server-Backups benötigt wird, hängt von der Größe des benötigten Backups und den dem Server zur Verfügung stehenden Ressourcen ab. Das Backup 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-VDAs.

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

  • Wenn Sie die grafische Benutzeroberfläche eines VDA-Installationsprogramms verwenden (z. B. über Autostart oder den Befehl XenDesktopVDASetup.exe ohne Wiederherstellungs- oder Quiet-Optionen), aktivieren Sie das Kontrollkästchen Automatische Wiederherstellung bei fehlgeschlagenem Update aktivieren auf der Seite Zusammenfassung.

  • Wenn die Installation/das Upgrade erfolgreich abgeschlossen wird, wird der Wiederherstellungspunkt/das Backup 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/das Server-Backup 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 in der ISO enthalten ist, können Sie:

  • Kernkomponenten installieren, aktualisieren oder entfernen: Delivery Controller, Studio, Director und Lizenzserver.
  • StoreFront installieren oder aktualisieren.
  • Windows-VDAs für Single-Session- oder Multi-Session-Betriebssysteme installieren oder aktualisieren.
  • Die Komponente UpsServer des Universal Print Servers auf Ihren Druckservern installieren.
  • Den 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 Multi-Session-Betriebssystem 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.

  • Standalone-VDA-Installationsprogramme

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

  • Elektronische Softwareverteilungspakete (ESD) verwenden, die lokal bereitgestellt oder kopiert werden
  • Physische Maschinen haben
  • Über Außenstellen verfügen

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

Vier Standalone-VDA-Installationsprogramme stehen zum Download zur Verfügung.

Multi-Session-Betriebssystem Virtual Delivery Agent (VDAServerSetup.exe):

Installiert einen VDA für Multi-Session-Betriebssysteme. Er unterstützt alle Optionen des VDA für Multi-Session-Betriebssysteme, die mit dem vollständigen Produktinstallationsprogramm verfügbar sind.

Single-Session-Betriebssystem Virtual Delivery Agent (VDAWorkstationSetup.exe):

Installiert einen VDA für Single-Session-Betriebssysteme. Er unterstützt alle Optionen des VDA für Single-Session-Betriebssysteme, die mit dem vollständigen Produktinstallationsprogramm verfügbar sind.

Single-Session-Betriebssystem-Kerndienste Virtual Delivery Agent (VDAWorkstationCoreSetup.exe):

Installiert einen VDA für Single-Session-Betriebssysteme, der für Remote PC Access-Bereitstellungen oder Core VDI-Installationen optimiert ist. Remote PC Access verwendet physische Maschinen. Core VDI-Installationen sind VMs, die nicht als Image verwendet werden. Er installiert nur die Kerndienste, die für VDA-Verbindungen in solchen Bereitstellungen erforderlich sind. Daher unterstützt er nur eine Untermenge der Optionen, die mit dem vollständigen Produktinstallationsprogramm oder dem VDAWorkstationSetup.exe-Installationsprogramm gültig sind.

Dieses Installationsprogramm installiert oder enthält die Komponenten für Folgendes nicht:

  • App-V.
  • Profilverwaltung. Das Ausschließen der Citrix Profilverwaltung 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 Backup and Restore
  • deviceTRUST
  • uberAgent
  • WEM

Das Installationsprogramm VDAWorkstationCoreSetup.exe installiert oder enthält die folgenden Komponenten nicht: Citrix Workspace-App für Windows (CWA), Citrix Secure Access Client (CSA), Citrix User Personalization Layer (UPL), Session Recording Agent (SRAGENT) und Citrix Assistant App (ASSISTANTAPP).

Die Verwendung von VDAWorkstationCoreSetup.exe entspricht der Verwendung des vollständigen Produktinstallationsprogramms oder des VDAWorkstationSetup-Installationsprogramms zur Installation eines Single-Session-Betriebssystem-VDA und einer der folgenden Optionen:

  • 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 zusätzlichen Komponentennamen auflistet.

Sie können die weggelassenen Komponenten/Funktionen später installieren, indem Sie das vollständige Produktinstallationsprogramm ausführen. Diese Aktion ermöglicht Ihnen die Installation aller fehlenden Komponenten.

Das Installationsprogramm VDAWorkstationCoreSetup.exe installiert automatisch das Browser Content Redirection MSI. Diese automatische Installation gilt für VDA-Release 2003 und später unterstützte Releases.

Single-Session-Kerndienste Virtual Delivery Agent (VDASingleSessionCoreSetup.exe):

Ein neuer, schlanker Single-Session VDA Meta Installer, verfügbar für Windows 365 Cloud PC- und Remote PC-Bereitstellungen. Dieses Installationsprogramm basiert auf dem bestehenden VDAWorkstationCoreSetup.exe-Installationsprogramm und liefert wesentliche VDA-Komponenten zusammen mit Profilverwaltung, 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.

Es reduziert die Paketgröße erheblich und verbessert die Installationszuverlässigkeit für cloudbasierte Workloads. Dieses Installationsprogramm 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 Single-Session-VDA-Installationsprogrammen

Für Single-Session-Betriebssysteme stehen vier verschiedene Installationsprogramme zur Verfügung. Das vollständige Produkt-VDA-Installationsprogramm und das VDAWorkstationSetup.exe-Installationsprogramm ermöglichen die Installation aller Komponenten, während einige Standard- und zusätzliche Komponenten in den Installationsprogrammen VDAWorkstationCoreSetup.exe und VDASingleSessionCoreSetup.exe nicht enthalten sind.

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

Risiken beim Mischen von Installationstypen:

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

Szenario 2: Wenn ein Single-Session-VDA ursprünglich mit dem vollständigen Produkt-VDA-Installationsprogramm oder VDAWorkstationSetup.exe installiert und später mit VDAWorkstationCoreSetup.exe oder VDASingleSessionCoreSetup.exe aktualisiert wird, werden alle Komponenten, die nicht vom Core Services VDA-Installationsprogramm installiert wurden, vom Upgrade ausgeschlossen. Diese Komponenten werden weder während des Upgrade-Prozesses aktualisiert noch während der Deinstallation entfernt.

Szenario 3: Wenn ein Single-Session-VDA ursprünglich mit dem Installer VDAWorkstationCoreSetup.exe installiert und anschließend mit VDASingleSessionCoreSetup.exe aktualisiert wird, stehen Ihnen die neuen Funktionen zur Verfügung. 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 Installer-Typen:

Wenn es notwendig wird, Installer-Typen zu mischen, ist es unerlässlich sicherzustellen, dass dieselben Komponenten während des Upgrade-Prozesses enthalten sind.

In Fällen, in denen Installer-Typen versehentlich gemischt wurden, was zur Installation zusätzlicher Komponenten oder dazu führte, dass bestimmte Komponenten nicht mehr verwaltet werden, und die Notwendigkeit besteht, die vorherige Umgebung wiederherzustellen, 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 anschließend 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 Installer VDAWorkstationSetup.exe.

  • Für Szenario 3: Wenn Sie die neuen Funktionen weiterhin 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 zuerst über die Windows-Funktion zum Deinstallieren oder Ändern von Programmen und installieren Sie den VDA anschließend mit VDAWorkstationCoreSetup.exe neu.

Citrix Installationsrückgabecodes

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 = 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 = Abbruch aufgrund ausstehendem Neustart
  • 15 = Vorabprüfung bestanden – Dies wird zurückgegeben, wenn die Vorabprüfungen nach Verwendung der neuen Befehlszeilenoption /precheckonly bestanden wurden.
  • 16 = Vorabprüfung fehlgeschlagen – Dies wird zurückgegeben, wenn die Vorabprüfungen nach Verwendung der neuen Befehlszeilenoption /precheckonly fehlgeschlagen sind.
  • 17 = Optionale Software fehlgeschlagen – Dies wird zurückgegeben, wenn eine der neuen optionalen Softwarekomponenten nicht installiert werden konnte und die Option „Mit der VDA-Installation oder dem Upgrade fortfahren, wenn andere ausgewählte Komponenten fehlschlagen.“ ausgewählt wurde.

Wenn Sie beispielsweise Tools wie Microsoft System Center Configuration Manager verwenden, kann eine skriptgesteuerte VDA-Installation fehlschlagen, wenn das Installationsprotokoll den Rückgabecode 3 enthält. Dies kann auftreten, wenn der VDA-Installer auf einen Neustart wartet, den Sie initiieren müssen (z. B. nach einer RDS-Rollen-Voraussetzungsinstallation 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 einbetten (die Microsoft-Exit-Codes zurückgeben) oder die Erfolgscodes in Ihrem Configuration Manager-Paket ändern.

Konfigurieren eines Microsoft RDS-Lizenzservers für Windows Server-Workloads

Dieses Produkt greift auf die Remote-Sitzungsfunktionen von Windows Server zu, wenn es eine Windows Server-Workload bereitstellt, z. B. Windows 2016. 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 Aktivieren des Remote Desktop Services-Lizenzservers. 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 Lizenzieren Ihrer RDS-Bereitstellung mit Clientzugriffslizenzen (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. Weitere Informationen finden Sie im Microsoft-Dokument Angeben des Remotedesktop-Lizenzierungsmodus für einen RD-Sitzungshostserver.

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

Weitere Informationen

Zum Einrichten des Ressourcenstandorts für bestimmte Hosttypen:

Installation vorbereiten
April 6, 2026
Beitrag von: 
C C
April 6, 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.