Problembehandlung für die automatisierte Konfiguration und weitere Informationen

Wichtig:

Für häufig auftretende Fehlermeldungen bei der automatisierten Konfiguration und entsprechende Lösungen siehe die FAQ zur Problembehandlung im Knowledge Center-Artikel CTX277730.

Fehler des Tools für die automatisierte Konfiguration

Vorgänge des Tools für die automatisierte Konfiguration können manchmal Fehler verursachen. Dabei können Fehler bei der Verarbeitung von Komponenten wie Maschinenkatalogen, Bereitstellungsgruppen oder Gruppenrichtlinien auftreten. Mithilfe von OnErrorAction und Fortsetzungsparametern können Sie Fehler während der Verarbeitung abfangen, beheben und dort fortfahren, wo Sie aufgehört haben.

Der Standardwert für OnErrorAction ist StopCompEnd. Wenn ein Fehler auftritt, beendet das Tool die Verarbeitung der aktuellen Komponente. Es werden keine weiteren Komponenten verarbeitet, und Fehler werden nicht an nachgelagerte, abhängige Komponenten weitergegeben. Nachdem Sie alle Fehler behoben haben, können Sie Ihre Cmdlets mit einem beliebigen Fortsetzungsparameter erneut ausführen.

OnErrorAction-Parameter

Sie können OnErrorAction Parameterwerte für Migrationsbefehle definieren, um zu steuern, wie das Tool auf Fehler reagiert, die es bei der Verarbeitung von Komponenten findet.

Diese Tabelle zeigt Parameterwerte und deren Beschreibungen:

Migrations-Cmdlets

Sie können den Parameter OnErrorAction auf die folgenden Migrationsbefehle anwenden:

• Compare-CvadAcToSite
• Import-CvadAcToSite
• Merge-CvadAcToSite
• New-CvadAcToSite
• Restore-CvadAcToSite

Beispiel: Merge-CvadAcToSite -OnErrorAction StopImmediately

Wiederaufnahme-Parameter

Diese Parameter definieren, wie das Tool die Arbeit fortsetzt, nachdem ein Vorgang aufgrund eines Fehlers angehalten oder beendet wurde.

Sie können Wiederaufnahme-Parameter auf Migrations-Cmdlets anwenden, die einen der folgenden Parameterwerte OnErrorAction enthalten:

• Pause
• StopCompEnd
• StopImmediately

Diese Tabelle zeigt Parameterwerte und deren Beschreibungen:

Die zuletzt verarbeitete Komponente wird in der Datei CurrentComponent.txt im Ordner „AutoConfig“ gespeichert. Das Bearbeiten dieser Datei wird nicht empfohlen. Wenn Sie -Resume oder -Repeat angeben und CurrentComponent.txt fehlt oder ungültig ist, wird die Verarbeitung beendet und Sie werden aufgefordert, eine Komponente auszuwählen.

Festlegen der OnErrorAction in der Datei CustomerInfo.yml

Sie können auch OnErrorAction Werte in der Datei CustomerInfo.yml festlegen. Legen Sie die Werte mit den folgenden Cmdlets fest:

• Für eine neue Datei: New-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately
• Für eine bestehende Datei: Set-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately

Protokolle

Die Ausführung eines Cmdlets führt zur Erstellung einer Protokolldatei und eines Eintrags in der Hauptverlaufsprotokolldatei. Alle Vorgangsprotokolldateien werden in einem Sicherungsordner abgelegt. Alle Protokolldateinamen beginnen mit CitrixLog und zeigen dann den Auto-Config-Vorgang sowie das Datum und den Zeitstempel der Cmdlet-Ausführung an. Protokolle werden nicht automatisch gelöscht.

Das Hauptverlaufsprotokoll befindet sich in *%HOMEPATH%\Documents\Citrix\AutoConfig*, in der Datei mit dem Namen History.Log. Jede Cmdlet-Ausführung führt zu einem Haupteintrag im Protokoll, der Datum, Vorgang, Ergebnis, Sicherung und Speicherorte der Protokolldateien der Ausführung enthält.

Sie können auch das Cmdlet New-CvadAcZipInfoForSupport verwenden, um Protokolle für den Support an Citrix zu senden. Dieses Cmdlet komprimiert alle Protokoll- und .yml-Dateien in einer einzigen ZIP-Datei. Kundenbezogene sensible Informationen (CustomerInfo.yml und CvadAcSecurity.yml) sind nicht in der ZIP-Datei enthalten. Die Datei Icon.yml wird aufgrund ihrer Größe ebenfalls ausgeschlossen. Die ZIP-Datei wird in %HOMEPATH%\Documents\Citrix\AutoConfig abgelegt und basierend auf Datum und Zeitstempel CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip genannt. Diese ZIP-Datei kann auch als Sicherung dienen.

Jede Protokolldatei enthält Folgendes:

• Der Name des Vorgangs und ob der Prüfmodus aktiviert ist
• Das Start- und Enddatum sowie die Start- und Endzeit
• Mehrere Einträge für die Aktionen jeder Komponente und Erfolgs-/Fehlermeldungen
• Zusammenfassung der durchgeführten Aktionen, einschließlich verschiedener Zählungen erstellter Objekte
• Vorgeschlagene Korrekturen, wo zutreffend
• Speicherort des Sicherungsordners, wo zutreffend
• Speicherort des Hauptprotokolls
• Dauer

Diagnosedateien

Diagnosedateien helfen Ihnen bei der Ermittlung und Behebung von Problemen. Die folgenden Dateien werden erstellt, wenn der entsprechende Vorgang ausgeführt wird. Sie befinden sich im aktionsspezifischen Unterordner unter %HOMEPATH%\Documents\Citrix\AutoConfig. Fügen Sie diese Dateien bei, wenn Sie Informationen zur Unterstützung bei der Problemlösung bereitstellen.

Exportieren

PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1

Diese Datei zählt alle Broker PowerShell SDK-Aufrufe, die zum Exportieren der Sitekonfiguration in Dateien getätigt wurden.

Importieren, Zusammenführen, Wiederherstellen, Synchronisieren, Sichern, Vergleichen

Transaction_yyyy_mm_dd_hh_mm_ss.txt

Diese Datei dokumentiert jeden Rest-API-Aufruf und die zugehörigen Informationen.

RestApiContent_yyyy_mm_dd_hh_mm_ss.txt

Diese Datei enthält den gesamten Add, Update und Delete Rest-API-Inhalt.

Probleme aufgrund von Abhängigkeiten

Importe und Zusammenführungen können aufgrund fehlender Abhängigkeiten fehlschlagen. Einige häufige Probleme sind:

1. Gruppenrichtlinien fehlen Bereitstellungsgruppenfilter. Die üblichen Ursachen sind Bereitstellungsgruppen, die nicht importiert wurden.
2. Anwendungen können nicht importiert oder zusammengeführt werden. Die übliche Ursache sind fehlende Bereitstellungsgruppen oder Anwendungsgruppen, die nicht importiert wurden.
3. Anwendungsgruppen fehlt ein RestrictToTag. Die üblichen Ursachen sind Tags, die nicht importiert wurden.
4. Hostverbindungen schlagen fehl. Die übliche Ursache sind fehlende Sicherheitsinformationen in der Datei CvadAcSecurity.yml.
5. Maschinenkataloge schlagen fehl. Die übliche Ursache sind Hostverbindungen, die nicht importiert wurden.
6. Maschinen fehlen in Maschinenkatalogen und Bereitstellungsgruppen. Die übliche Ursache sind Maschinen, die in Active Directory nicht gefunden wurden.
7. Benutzer fehlen in Bereitstellungsgruppen. Die übliche Ursache sind Benutzer, die in Active Directory nicht gefunden wurden.

Empfehlungen

• Führen Sie nicht mehr als eine Instanz der automatisierten Konfiguration gleichzeitig aus. Das Ausführen mehrerer gleichzeitiger Instanzen führt zu unvorhersehbaren Ergebnissen in der Cloud-Site. In diesem Fall führen Sie eine Instanz der automatisierten Konfiguration erneut aus, um die Site in den erwarteten Zustand zu versetzen.
• Arbeiten oder ändern Sie keine Daten in Studio, während die automatisierte Konfiguration ausgeführt wird.
• Überprüfen Sie die Zusammenführungs-, Import- oder Wiederherstellungsergebnisse in Studio immer visuell, um sicherzustellen, dass die Cloud-Site die Erwartungen erfüllt.

Ordner

Standardspeicherort des Stammordners

Alle Vorgänge des Tools zur automatisierten Konfiguration erfolgen im Stammordner oder in Unterordnern darin. Der Stammordner befindet sich unter %HOMEPATH%\Documents\Citrix\AutoConfig.

Exportieren

Alle exportierten Dateien werden an zwei Ordnerspeicherorten abgelegt, was die Benutzerfreundlichkeit und eine Historie der Exporte bietet. Exporte werden immer im Stammordner abgelegt. Kopien werden in einem Unterordner namens Export mit Datum und Uhrzeit des Exports abgelegt.

Der Stammordner enthält immer die zuletzt exportierte On-Premises-Sitekonfiguration. Jeder Unterordner Export enthält den Export, der am angegebenen Datum und zur angegebenen Uhrzeit durchgeführt wurde, wodurch eine Historie der Exporte erhalten bleibt. Sie können jeden Unterordner Export verwenden, um die Cloud-Site zu konfigurieren. Die automatisierte Konfiguration löscht oder ändert keine vorhandenen Export-Unterordner.

Importieren/Zusammenführen/Synchronisieren/Vergleichen

Die Operationen Import, Merge und Compare werden immer aus Dateien im Stammordner bezogen. Jede Operation führt zur Erstellung eines Unterordners, in den Dateien aus dem Stammordner kopiert werden, wodurch eine Historie der sich ändernden Quelldateien der Cloud-Site bereitgestellt wird.

Wiederherstellen

Die Restore-Operation verwendet einen vorhandenen Unterordner, um die Cloud-Site zu konfigurieren. Der Quellordner wird im erforderlichen -RestoreFolder-Parameter angegeben. Im Gegensatz zu anderen Befehlen wird kein neuer Unterordner erstellt, da die Restore-Operation einen vorhandenen Unterordner verwendet. Der Wiederherstellungsordner kann der Stammordner sein, muss aber dennoch im -RestoreFolder-Parameter angegeben werden.

Sicherungen

Automated Configuration initialisiert, aktualisiert und sichert eine Cloud-Site-Konfiguration. Bei längerem Gebrauch können sich viele verschiedene Konfigurationen auf der Cloud-Site ändern. Um die langfristige Nutzung zu erleichtern und Verlaufsänderungen zu erhalten, verwendet Automated Configuration ein Aufbewahrungsschema, um diesen Änderungsverlauf zu speichern und eine Methode zur Wiederherstellung früherer Zustände bereitzustellen.

Sicherungen der Cloud-Site-Konfiguration werden immer in einem Unterordner namens Backup mit Datum und Uhrzeit der Sicherung erstellt. Automated Configuration löscht oder ändert keine vorhandenen Export-Unterordner.

Sie können die Sicherungen verwenden, um bestimmte Komponenten oder Ihre gesamte Konfiguration wiederherzustellen. Um die gesamte Bereitstellungsgruppe und die Maschinenkatalogkomponenten wiederherzustellen, verwenden Sie das Cmdlet:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs

Hinweis:

Die Sicherungsdateiinformationen im vorhergehenden Cmdlet basieren auf Ihren eigenen Sicherungen.

Um die gesamte Cloud-Site-Konfiguration wiederherzustellen, verwenden Sie das Cmdlet:

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Hinweis:

Die Sicherungsdateiinformationen im vorhergehenden Cmdlet basieren auf Ihren eigenen Sicherungen.

Ändern des Standard-Stammordners

Die Vorgänge Export, Import, Merge, Sync und Compare können den Standard-Stammordner mithilfe des Parameters –AlternateFolder ändern. Die Erstellung und Verwaltung von vorgangsspezifischen Unterordnern bleibt wie zuvor beschrieben.

In Unterordner kopierte Dateien

Alle Dateien mit der Erweiterung „.yml“ werden in Vorgangsunterordner kopiert, mit Ausnahme der folgenden:

• CustomerInfo.yml
• ZoneMapping.yml
• CvadAcSecurity.yml

Automatisierte ausfallsichere Cloud-Site-Backups

Ein Backup der aktuellen Cloud-Site-Konfiguration wird erstellt, bevor Vorgänge ausgeführt werden, die die Konfiguration ändern. Dies umfasst die Parameter Import, Merge, Sync und Restore. Das Backup befindet sich immer in einem Unterordner unterhalb des Vorgangsunterordners.

Im Fall von Restore ist der Backup-Ordner ein Unterordner des Ordners, der im Parameter -RestoreFolder angegeben ist.

Automatisierung

Cmdlets des automatisierten Konfigurationstools können in Automatisierungsskripten ohne Administratorinteraktion ausgeführt werden, indem Eingabeaufforderungen und die Anzeige der Protokollergebnisse nach Abschluss des Cmdlets unterdrückt werden. Sie können Parameter auch so einstellen, dass sie dasselbe tun, indem Sie die Datei CustomerInfo.yml verwenden.

Fügen Sie den folgenden Parameter zu Cloud-modifizierenden Cmdlets hinzu, um die Anzeige von Eingabeaufforderungen zu unterdrücken.

-Confirm $false

Fügen Sie den folgenden Parameter zu Cmdlets hinzu, um die Anzeige des Protokolls nach Abschluss des Cmdlets zu unterdrücken.

-DisplayLog $false

Fügen Sie den folgenden Parameter zu Cmdlets hinzu, um die Protokollierung im PowerShell-Befehlsfenster zu unterdrücken.

-Quiet

Als weitere Methode können die folgenden Parameter in der Datei CustomerInfo.yml platziert werden.

Confirm: False

DisplayLog: False

Exportieren von PCs, die nicht der Delivery Controller™ sind

Das Tool für die automatisierte Konfiguration verwendet mehrere Citrix PowerShell SDKs, um die lokale Sitekonfiguration in Dateien zu exportieren. Diese SDKs werden automatisch auf dem Delivery Controller installiert, sodass das Tool ohne zusätzliche Maßnahmen auf dem Delivery Controller ausgeführt werden kann. Beim Ausführen auf Nicht-Delivery Controller-Maschinen ist es erforderlich, den Satz von Citrix PowerShell SDKs zu installieren, die vom Tool benötigt werden. Dieser SDK-Satz ist Teil von Citrix Studio, das von den Installationsmedien von Citrix Virtual Apps and Desktops™ installiert werden kann.

Hinweis:

Die automatisierte Konfiguration kann nicht auf dem Cloud Connector ausgeführt werden.

Wechsel zu Citrix Cloud™ Government und Japan Control Plane

Die Umgebungen von Citrix Cloud Government und Japan Control Plane verwenden unterschiedliche Zugriffspunkte zur Authentifizierung und Zuweisung von Zugriffstoken. Diese einzigartige Anforderung gilt für jedes Tool zur automatisierten Konfiguration, das auf die Cloud zugreift. Führen Sie die folgenden Schritte aus, um die automatisierte Konfiguration in diesen Umgebungen zu verwenden.

1. Bearbeiten Sie im Ordner %HOMEPATH%\Documents\Citrix\AutoConfig die Datei CustomerInfo.yml.

2. Fügen Sie eine der folgenden Zeilen zu CustomerInfo.yml hinzu (oder ändern Sie sie, falls bereits vorhanden), je nachdem, mit welcher Umgebung Sie sich verbinden möchten.

   Environment: 'ProductionGov'

   oder

   Environment: 'ProductionJP'

Automated Configuration kann nun in diesen Umgebungen verwendet werden.

Citrix Cloud-Datenerfassung

Informationen dazu, welche Daten Citrix Cloud erfasst, finden Sie unter Citrix Cloud Services Customer Content and Log Handling.

Zusätzliche Ressourcen

Diskussionsforum

Besuchen Sie das Citrix Diskussionsforum für Automated Configuration.

Video

Sehen Sie sich Under the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktops auf YouTube an.

Schulung

Das Cloud Learning Center enthält Schritt-für-Schritt-Videoanleitungen zum Aufbau einer Servicebereitstellung, einschließlich der in diesem Artikel beschriebenen Aufgaben. Siehe Migrating Citrix Virtual Apps and Desktops to Citrix Cloud Learning Path.