Product Documentation

Installieren von VDAs mit Skripts in Active Directory

Sep 29, 2015

Das Installationsmedium enthält Beispielskripts, um Virtual Delivery Agents (VDAs) für Gruppen von Maschinen in Active Directory zu installieren, zu aktualisieren oder zu entfernen. Sie können die Skripts auch auf einzelne Maschinen anwenden und sie zum Verwalten von Masterimages einsetzen, die von den Maschinenerstellungsdiensten und Provisioning Services verwendet werden.

Erforderliche Zugriffsberechtigungen:
  • Für die Skripts ist Lesezugriff für "Jeder" auf der Netzwerkfreigabe erforderlich, auf der der VDA-Installationsbefehl (XenDesktopVdaSetup.exe) ist.
  • Die Protokolldetails werden auf jeder lokalen Maschine gespeichert. Sollen die Ergebnisse auch zentral zur Überprüfung und Analyse protokolliert werden, benötigen die Skripts Lese- und Schreibzugriff auf der Netzwerkfreigabe für "Jeder".

Um die Ergebnisse der Skriptausführung zu überprüfen, müssen Sie die zentrale Protokollfreigabe untersuchen. Erfasst werden das Skriptprotokoll, das Installationsprogrammprotokoll und die MSI-Installationsprotokolle. Jeder Installations- oder Deinstallationsvorgang wird in einem Ordner mit Zeitstempel aufgezeichnet. Am Präfix "PASS" oder "FAIL" im Ordnertitel ist ersichtlich, ob der Vorgang erfolgreich war oder nicht. Sie können herkömmliche Verzeichnissuchprogramme verwenden, um schnell eine fehlerhafte Installation oder Deinstallation im zentralen Protokoll zu finden, statt lokal auf den Zielmaschinen zu suchen. Weitere Informationen finden Sie weiter unten im Abschnitt "Problembehandlung".

Wichtig: Vor Beginn einer Installation führen Sie die unter Vorbereiten der Installation beschriebenen Schritte durch.

Installieren oder Aktualisieren von VDAs mit dem Skript

  1. Besorgen Sie sich das Beispielskript InstallVDA.bat aus \Support\AdDeploy\ auf dem Installationsmedium. Citrix empfiehlt, dass Sie ein Backup der ursprünglichen Skriptdatei anlegen, bevor Sie sie ändern.
  2. Bearbeiten Sie das Skript:
    • Geben Sie die Version des zu installierenden VDA an: SET DESIREDVERSION. Beispielsweise kann die Version 7 als 7.0 angegeben werden. Der vollständige Wert befindet sich auf dem Installationsmedium in der Datei ProductVersion.txt (z. B. 7.0.0.3018); eine vollständige Übereinstimmung ist jedoch nicht erforderlich.
    • Geben Sie die Netzwerkfreigabe an, von der das Installationsprogramm aufgerufen wird Verweisen Sie auf den Stamm des Layouts (der höchste Punkt der Struktur): die geeignete 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 Netzwerkfreigabeort zum Speichern der zentralen Protokolle an. Beispiel: SET LOGSHARE=\\fileserver1\log1).
    • Geben Sie die VDA-Konfigurationsoptionen wie unter Installieren an der Befehlszeile beschrieben ein. Die Optionen /quiet und /noreboot sind standardmäßig im Skript enthalten und sind erforderlich: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT.
  3. Weisen Sie mit den Startskripts für Gruppenrichtlinien das Skript der Organisationseinheit in Active Directory zu, in der die Maschinen sind. Diese Organisationseinheit sollte nur Maschinen enthalten, auf denen Sie VDA installieren möchten. Wenn die Maschinen in der Organisationseinheit neu gestartet werden, wird das Skript auf allen ausgeführt und VDA auf jeder Maschine installiert, deren Betriebssystem unterstützt wird.

Entfernen von VDAs mit dem Skript

  1. Besorgen Sie sich das Beispielskript UninstallVDA.bat aus \Support\AdDeploy\ auf dem Installationsmedium. Citrix empfiehlt, dass Sie ein Backup der ursprünglichen Skriptdatei anlegen, bevor Sie sie ändern.
  2. Bearbeiten Sie das Skript.
    • Geben Sie die Version des zu entfernenden VDAs an: SET CHECK_VDA_VERSION. Beispielsweise kann die Version 7 als 7.0 angegeben werden. Der vollständige Wert befindet sich auf dem Installationsmedium in der Datei ProductVersion.txt (z. B. 7.0.0.3018); eine vollständige Übereinstimmung ist jedoch nicht erforderlich.
    • Geben Sie optional einen Netzwerkfreigabeort zum Speichern der zentralen Protokolle an.
  3. Weisen Sie mit den Startskripts für Gruppenrichtlinien das Skript der Organisationseinheit in Active Directory zu, in der die Maschinen sind. Diese Organisationseinheit sollte nur Maschinen enthalten, von denen Sie VDA entfernen möchten. Wenn die Maschinen in der Organisationseinheit neu gestartet werden, wird das Skript auf allen ausgeführt und VDA auf jeder Maschine entfernt.

Problembehandlung

Das Skript generiert interne Protokolldateien, die den Skriptausführungsverlauf beschreiben. Das Skript kopiert das Protokoll Kickoff_VDA_Startup_Skript innerhalb von Sekunden nachdem die Bereitstellung auf der Maschine gestartet wurde in die zentrale Protokollfreigabe, sodass Sie den Gesamtvorgang überprüfen können. Wenn dieses Protokoll nicht wie vorgesehen in die Protokollfreigabe kopiert wird, können Sie zur weiteren Fehlerbehebung die lokale Maschine untersuchen, denn durch das Skript werden zwei Debugging-Protokolldateien im Ordner %temp% auf jeder Maschine gespeichert:
  • Kickoff_VDA_Startup_Script_.log
  • VDA_Install_ProcessLog_.log
Überprüfen Sie den Inhalt dieser Protokolle, um Folgendes für das Skript sicherzustellen:
  • Es wird wie erwartet ausgeführt.
  • Das Zielbetriebssystem wird korrekt erkannt.
  • Der Verweis auf ROOT von DEPLOYSHARE ist korrekt konfiguriert (enthält die Datei "AutoSelect.exe").
  • Die Authentifizierung bei den Freigaben DEPLOYSHARE und LOG ist möglich.