VDA-Upgrade-Agent

May 4, 2026

Beitrag von:

C C

Voraussetzungen für das Upgrade von VDAs mit VUS

Um VDA-Upgrades mit VUS durchzuführen, müssen die folgenden Voraussetzungen erfüllt sein.

VDA-Upgradedienst aktivieren

Um die Funktion des VDA-Upgradediensts zu aktivieren, verwenden Sie die Option „VDA-Upgrade“ beim Erstellen oder Bearbeiten eines Maschinenkatalogs. Administratoren müssen beim Aktivieren des VUS aus den folgenden Upgrade-Zyklen wählen:

Konnektivit

LTSR
CR
LTSR Early Access Release (EAR)
CR EAR

Um den VDA-Upgradedienst für einen Maschinenkatalog über die vollständige Konfigurationsoberfläche von DaaS zu aktivieren, klicken Sie mit der rechten Maustaste auf einen Katalog, klicken Sie auf „Katalog bearbeiten“, wählen Sie die Registerkarte „VDA-Upgradedienst“, aktivieren Sie das Kontrollkästchen „VDA-Upgradedienst verwenden“ und wählen Sie eine Upgrade-Spur aus.

VDA-Upgradedienst

Um den VDA-Upgradedienst für einen Maschinenkatalog mit PowerShell zu aktivieren, verwenden Sie das Cmdlet Set-VusCatalogUpgradeType.

Der Upgradetyp kann als „LTSR“, „CR“, „EAR_CR“ oder „EAR_LTSR“ festgelegt werden.

Beispiel: Set-VusCatalogUpgradeType -CatalogName "Workstation catalog" -UpgradeType LTSR

Hinweis:

Das Aktivieren der Option „VDA-Upgrade“ führt nicht zum automatischen Upgrade von VDAs. Alle VDA-Upgrades über VUS müssen als separate Aufgabe explizit von Administratoren initiiert werden.

VDA-Anforderungen

VDA-Version

2109 CR oder höher oder 2203 LTSR oder höher

Bereitstellungstyp

    -  Persistente Einzel- oder Mehrsitzungsmaschinen, die mit Nicht-Citrix Provisioning™-Diensten oder -Technologien bereitgestellt werden.
    -  Persistente MCS-bereitgestellte Einzelsitzungsmaschinen (AD-verbunden, Microsoft Entra-verbunden und nicht domänenverbunden).

Remote-PC-Zugriffsmaschinen.
Citrix HDX™ Plus für Windows 365.

VDA-Upgrade-Agent

-  Der VDA-Upgrade-Agent muss auf dem VDA installiert und aktiv sein. Der Agent kann installiert werden:
-  Als zusätzliche Komponente beim Upgrade Ihres VDA oder beim Ändern der VDA-Installation.
-  Mithilfe der eigenständigen MSI, die in der ISO von Citrix Virtual Apps and Desktops™ verfügbar ist.
    -  MSI-Name: CitrixUpgradeAgent_x64.msi
    -  Pfad: x64\Virtual Desktop Components
-  Um LTSR-VDAs auf LTSR CU-Versionen zu aktualisieren, muss der VDA-Upgrade-Agent Version 7.36.0.7 oder höher sein.

> **Hinweis:**
> > Der VDA-Upgrade-Agent wird automatisch aktualisiert, wenn der VDA Zugriff auf die unter [Konnektivität](https://stage-docs.citrix.com/en-us/citrix-daas/upgrade-vda-test/upgrade-vda-prereq#connectivity) aufgeführten URLs hat.

Berechtigungen

    -  Sie müssen die Rolle „Vollständiger Administrator“ oder „Maschinenkatalogadministrator“ in Citrix DaaS innehaben.

VDA-Status

    -  Damit über VUS geplante Upgrades wie vorgesehen ablaufen, müssen die für das Upgrade vorgesehenen VDAs die folgenden Voraussetzungen erfüllen:

    -  Der VDA darf nicht manuell in den Wartungsmodus versetzt werden.
    -  Damit ein VDA-Upgrade erfolgreich durchgeführt werden kann, dürfen keine Benutzer angemeldet sein.
    -  VDAs werden in den Wartungsmodus versetzt, wenn der Upgrade-Prozess beginnt, Benutzersitzungen während des gesamten Upgrade-Fensters zu entleeren. Sie werden aus dem Wartungsmodus entfernt, sobald das Upgrade erfolgreich abgeschlossen wurde.
    -  Wenn ein Benutzer während der gesamten Dauer des Upgrade-Fensters eine aktive oder getrennte Sitzung hat, wird das Upgrade am Ende des Upgrade-Fensters abgebrochen.

Hinweis:

Aktive und getrennte Sitzungen können mithilfe der Option erzwungene Abmeldung in VUS beendet werden.

-  VDAs, die nicht über MCS bereitgestellt wurden (manuell bereitgestellt), müssen einer Bereitstellungsgruppe hinzugefügt werden, bevor ein Upgrade über VUS durchgeführt wird.
-  VDAs müssen eingeschaltet sein.

Hinweis:

AutoScale™ beendet die Energieverwaltung von Maschinen nicht, wenn VDA-Upgrades geplant sind. Erwägen Sie, AutoScale-Zeitpläne für die Bereitstellungsgruppe zu deaktivieren, wenn Upgrades ausgeführt werden.

Konnektivität

    -  VDAs müssen mit den folgenden URLs kommunizieren können:
        -  Wenn das Citrix Content Delivery Network (CDN) zum Herunterladen des VDA-Installers verwendet wird, müssen VDAs mit den folgenden URLs kommunizieren können.
        -  Produktion – Vereinigte Staaten (USA): <https://prod-us-vus-storage-endpoint.azureedge.net/>*
        -  Produktion – Europäische Union (EU): <https://prod-eu-vus-storage-endpoint.azureedge.net/>*
        -  Produktion – Asien-Pazifik Süd (APS): <https://prod-aps-vus-storage-endpoint.azureedge.net/>*
            -  Produktion – Japan (JP): <https://prod-jp-vus-storage-endpoint.azureedge.net/>*
            -  Um zu überprüfen, ob der VDA-Installer mit einem gültigen Zertifikat signiert ist, müssen VDAs mit den folgenden URLs kommunizieren.
    -  <http://crl3.digicert.com/>*
    -  <http://crl4.digicert.com/>*
    -  <http://ocsp.digicert.com/>*
        -  <http://cacerts.digicert.com/>*
    -  Der VDA-Upgrade-Agent kommuniziert mit DaaS unter den folgenden URLs.
        -  https://[customerId].xendesktop.net/citrix/VdaUpdateService/*, wobei [customerId] der Kunden-ID-Parameter ist, der auf der Registerkarte „Sichere Clients“ (Identitäts- und Zugriffsverwaltung > API-Zugriff > Sichere Clients) der Citrix Cloud-Verwaltungskonsole angezeigt wird.

VDAs mit Proxykonfigurationen

Unterstützt für VDA-Upgrade-Agent-Version 7.40 und höher.
Es werden nur Proxys in Form von Hostname:Port (IP:Port) und PAC-Datei unterstützt. SOCKS5-Proxys werden nicht unterstützt.
Der VDA-Upgrade-Agent muss für die Verwendung eines Proxys über die vollständige Konfigurationsoberfläche oder die Registrierung konfiguriert werden.
- Proxykonfiguration des VDA-Upgrade-Agents über die vollständige Konfigurationsoberfläche
  - Aktivieren Sie die Citrix Richtlinieneinstellung für die VDA-Upgrade-Proxykonfiguration für die VDAs, die einen Proxy verwenden.
  - Geben Sie die Proxyadresse oder den Pfad zur PAC-Datei in den Einstellungen ein.
- Proxykonfiguration des VDA-Upgrade-Agents über die Registrierung
  - Schlüssel: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\VirtualDesktopAgent
    - Werttyp: String
    - Wertname: ProxySettings
    - Wertdaten: Proxyadresse oder Pfad zur PAC-Datei.
    - Zum Beispiel:
      - Proxyadresse: http://<URL oder IP>:<Port>
      - PAC-Datei: http://<URL oder IP>/<Pfad/<Dateiname>.pac
Die Zertifikatsvalidierung verwendet die Windows CryptoAPI, die keine Proxy-Kommunikation unterstützt.
- So konfigurieren Sie den Systemproxy auf dem VDA, um ausgehende CRL-Aufrufe zu ermöglichen. Geben Sie einen der folgenden Befehle in die Befehlszeile des VDA ein, um den Systemproxy zu konfigurieren:
  - So kopieren Sie Proxy-Einstellungen aus Internet Explorer:
    - netsh winhttp import proxy source=ie
  - So verwenden Sie eine separate Proxy-Einstellung:
    - netsh winhttp set proxy proxy-server=http://Proxy_Server:Port

VDAs, die mit VDAWorkstationCoreSetup.exe installiert wurden

Wenn der VDA ursprünglich mit VDAWorkstationCoreSetup.exe installiert wurde, kann er weiterhin mit VUS aktualisiert werden, das VDAWorkstationSetup.exe verwendet. Beim Upgrade von VDAs, die mit VDAWorkstationCoreSetup.exe installiert wurden, mithilfe von VUS sollten Sie die Installationsoptionen überprüfen, um sicherzustellen, dass nur die gewünschten Funktionen aktiviert sind, insbesondere wenn Sie von einer minimalen Core-Installation migrieren.

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

War dieser Artikel hilfreich?

VDA-Upgrade-Agent

May 4, 2026

Beitrag von:

C C

May 4, 2026

Beitrag von:

C C

In diesem Artikel

Voraussetzungen für das Upgrade von VDAs mit VUS
VDA-Upgradedienst aktivieren
VDA-Anforderungen

War dieser Artikel hilfreich?