Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

VDAs mithilfe von Skripten installieren

March 18, 2026
Beitrag von: 
C

Hinweis:

Citrix ist nicht verantwortlich für Probleme, die durch Skripte verursacht werden, die an die Produktionsumgebungen der Kunden angepasst wurden. Bei installationsbezogenen Citrix-Problemen öffnen Sie einen technischen Supportfall mit den entsprechenden Installationsprotokollen über das Citrix Support-Portal.

Dieser Artikel behandelt die Installation von VDAs auf Maschinen mit Windows-Betriebssystemen. Informationen zu VDAs für Linux-Betriebssysteme finden Sie in der Dokumentation zum Linux Virtual Delivery Agent.

Die Installationsmedien enthalten Beispielskripte, die Virtual Delivery Agents (VDAs) für Maschinen in Active Directory installieren, aktualisieren oder entfernen. Sie können die Skripte auch verwenden, um Master-Images zu verwalten, die von Machine Creation Services™ und Citrix Provisioning (ehemals Provisioning Services) verwendet werden.

Erforderlicher Zugriff:

  • Die Skripte benötigen Lesezugriff für „Jeder“ auf die Netzwerkfreigabe, auf der sich der VDA-Installationsbefehl befindet. Der Installationsbefehl ist XenDesktopVdaSetup.exe in der vollständigen Produkt-ISO oder VDAWorkstationSetup.exe oder VDAServerSetup.exe in einem eigenständigen Installationsprogramm.
  • Protokolldetails werden auf jeder lokalen Maschine gespeichert. Um Ergebnisse zur Überprüfung und Analyse zentral zu protokollieren, benötigen die Skripte Lese- und Schreibzugriff für „Jeder“ auf die entsprechende Netzwerkfreigabe.

Um die Ergebnisse der Skriptausführung zu überprüfen, untersuchen Sie die zentrale Protokollfreigabe. Erfasste Protokolle umfassen das Skriptprotokoll, das Installationsprotokoll und die MSI-Installationsprotokolle. Jeder Installations- oder Entfernungsversuch wird in einem Ordner mit Zeitstempel aufgezeichnet. Der Ordnername gibt das Operationsergebnis mit dem Präfix PASS oder FAIL an. Sie können Standard-Verzeichnissuchtools verwenden, um eine fehlgeschlagene Installation oder Entfernung in der zentralen Protokollfreigabe zu finden. Diese Tools bieten eine Alternative zur lokalen Suche auf den Zielmaschinen.

Bevor Sie mit einer Installation beginnen, lesen und erledigen Sie die Aufgaben unter Vorbereitung der Installation.

VDAs mithilfe des Skripts installieren oder aktualisieren

  1. Rufen Sie das Beispielskript InstallVDA.bat von \Support\AdDeploy\ auf den Installationsmedien ab. Citrix empfiehlt, eine Sicherungskopie des Originalskripts zu erstellen, bevor Sie es anpassen.
  2. Bearbeiten Sie das Skript:
    • Geben Sie die zu installierende VDA-Version an: SET DESIREDVERSION. Der vollständige Wert ist auf den Installationsmedien in der Datei ProductVersion.txt zu finden. Eine exakte Übereinstimmung ist jedoch nicht erforderlich.
    • Geben Sie die Netzwerkfreigabe an, von der das Installationsprogramm aufgerufen wird. Zeigen Sie auf das Stammverzeichnis des Layouts (den höchsten Punkt des Baums). Die entsprechende Version des Installationsprogramms (32-Bit oder 64-Bit) wird automatisch aufgerufen, wenn das Skript ausgeführt wird. Beispiel: SET DEPLOYSHARE=\\fileserver1\share1.
    • Geben Sie optional einen Speicherort für eine Netzwerkfreigabe zum Speichern zentralisierter Protokolle an. Beispiel: SET LOGSHARE=\\fileserver1\log1).
    • Geben Sie die VDA-Konfigurationsoptionen an, wie unter Installation über die Befehlszeile beschrieben. Die Optionen /quiet und /noreboot sind standardmäßig im Skript enthalten und erforderlich: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME.
  3. Weisen Sie das Skript mithilfe von Gruppenrichtlinien-Startskripten der OU zu, die Ihre Maschinen enthält. Diese OU sollte nur Maschinen enthalten, auf denen Sie den VDA installieren möchten. Wenn die Maschinen in dieser OU neu gestartet werden, wird das Skript auf allen ausgeführt. Auf jeder Maschine mit einem unterstützten Betriebssystem wird ein VDA installiert.

VDAs mithilfe des Skripts entfernen

  1. Rufen Sie das Beispielskript UninstallVDA.bat von \Support\AdDeploy\ auf den Installationsmedien ab. Citrix empfiehlt, eine Sicherungskopie des Originalskripts zu erstellen, bevor Sie es anpassen.
  2. Bearbeiten Sie das Skript.
    • Geben Sie die zu entfernende VDA-Version an: SET CHECK\_VDA\_VERSION. Der vollständige Wert ist auf den Installationsmedien in der Datei ProductVersion.txt zu finden (z. B. 7.0.0.3018). Eine exakte Übereinstimmung ist jedoch nicht erforderlich.
    • Geben Sie optional einen Speicherort für eine Netzwerkfreigabe zum Speichern zentralisierter Protokolle an.
  3. Weisen Sie das Skript mithilfe von Gruppenrichtlinien-Startskripten der OU zu, die Ihre Maschinen enthält. Diese OU sollte nur Maschinen enthalten, von denen Sie den VDA entfernen möchten. Wenn die Maschinen in der OU neu gestartet werden, wird das Skript auf allen ausgeführt. Der VDA wird von jeder Maschine entfernt.

Fehlerbehebung

  • Das Skript generiert interne Protokolldateien, die den Fortschritt der Skriptausführung beschreiben. Das Skript kopiert ein Kickoff_VDA_Startup_Script-Protokoll innerhalb von Sekunden nach Beginn der Bereitstellung in die zentrale Protokollfreigabe. Sie können überprüfen, ob der Gesamtprozess funktioniert. Wenn dieses Protokoll nicht wie erwartet in die zentrale Protokollfreigabe kopiert wird, beheben Sie das Problem weiter, indem Sie die lokale Maschine überprüfen. Das Skript legt zwei Debugging-Protokolldateien im Ordner %temp% auf jeder Maschine ab:

    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log

    Überprüfen Sie diese Protokolle, um sicherzustellen, dass das Skript:

    • wie erwartet ausgeführt wird.
    • das Zielbetriebssystem ordnungsgemäß erkennt.
    • korrekt konfiguriert ist, um auf das ROOT der DEPLOYSHARE-Freigabe zu verweisen (enthält die Datei AutoSelect.exe).
    • sich sowohl bei den DEPLOYSHARE- als auch bei den LOG-Freigaben authentifizieren kann.

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

  • In der Studio-Anzeige für eine Bereitstellungsgruppe ist der Eintrag Installierte VDA-Version im Bereich Details möglicherweise nicht die auf den Maschinen installierte Version. Die Anzeige der Programme und Funktionen der Maschine zeigt die tatsächliche VDA-Version an.

  • Nach der Installation eines VDA kann dieser keine Apps oder Desktops an Benutzer bereitstellen, bevor er sich bei einem Delivery Controller registriert hat.

Informationen zu VDA-Registrierungsmethoden und zur Behebung von Registrierungsproblemen finden Sie unter VDA-Registrierung.

VDAs mithilfe von Skripten installieren
March 18, 2026
Beitrag von: 
C
March 18, 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.