Fehlerbehebung bei der automatisierten Konfiguration und zusätzliche Informationen

Last published : Nov 03, 2026
Wichtig:
Für häufig auftretende Fehlermeldungen bei der automatisierten Konfiguration und entsprechende Lösungen siehe die FAQ zur Fehlerbehebung im Knowledge Center-Artikel CTX277730.
Related information
Konfiguration sichern oder migrieren

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 auftreten, wenn Komponenten wie Maschinenkataloge, Bereitstellungsgruppen oder Gruppenrichtlinien verarbeitet werden. Die Verwendung von OnErrorAction und Fortsetzungsparametern ermöglicht es Ihnen, Fehler während der Verarbeitung abzufangen, zu beheben und dort fortzufahren, 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 beim Verarbeiten von Komponenten findet.
Diese Tabelle zeigt Parameterwerte und deren Beschreibungen:
Wert Beschreibung
Continue Versucht, so viele Komponenten wie möglich zu verarbeiten.
Pause Hält am Ende der Verarbeitung an und fordert Sie auf, fortzufahren oder anzuhalten.
StopCompEnd Versucht, so viel wie möglich von der Komponente zu verarbeiten. Hält an, nachdem die Komponente abgeschlossen ist. (Standard)
StopImmediately Die Verarbeitung wird beendet, wenn ein Fehler gefunden wird.

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

Fortsetzungsparameter

Diese Parameter definieren, wie das Tool fortgesetzt wird, nachdem ein Vorgang aufgrund eines Fehlers angehalten oder beendet wurde.
Sie können Fortsetzungsparameter auf Migrations-Cmdlets anwenden, die einen der folgenden Parameterwerte OnErrorAction enthalten:
  • Pause
  • StopCompEnd
  • StopImmediately
Diese Tabelle zeigt Parameterwerte und deren Beschreibungen:
Wert Beschreibung
-AllRemaining Erfordert eine Startkomponente. Die Verarbeitung beginnt bei der Startkomponente und verarbeitet alle verbleibenden Komponenten. Mehrere Komponenten werden verarbeitet.
-Resume Verwendet die Komponente aus CurrentComponent.txt als Ausgangspunkt. Alle verbleibenden Komponenten werden auf „true“ gesetzt. Mehrere Komponenten werden verarbeitet.
-Repeat Verwendet die Komponente aus CurrentComponent.txt als Ausgangspunkt. Alle verbleibenden Komponenten werden auf „false“ gesetzt. Nur eine Komponente wird verarbeitet.
Die zuletzt verarbeitete Komponente wird in der Datei CurrentComponent.txt im AutoConfig-Ordner 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 vorhandene 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, gefolgt vom Auto-Config-Vorgang sowie dem Datum und der Uhrzeit der Cmdlet-Ausführung. Protokolle werden nicht automatisch gelöscht.
Das Hauptverlaufsprotokoll befindet sich in *%HOMEPATH%\Documents\Citrix\AutoConfig*, in der Datei namens 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 zu sammeln und an Citrix zur Unterstützung 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 unter %HOMEPATH%\Documents\Citrix\AutoConfig abgelegt und basierend auf Datum und Uhrzeit 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 Anzahlen 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 jeweilige 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 Delivery Group-Filter. Die üblichen Ursachen sind Delivery Groups, die nicht importiert wurden.
  2. Anwendungen können nicht importiert oder zusammengeführt werden. Die übliche Ursache sind fehlende Delivery Groups oder Application Groups, die nicht importiert wurden.
  3. Application Groups 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. Führen Sie in diesem Fall 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 Speicherorten 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 lokale 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

Import-, Merge- und Compare-Operationen 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 Quellendateien, die die Cloud-Site ändern, 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 bewahren, verwendet Automated Configuration ein Aufbewahrungsschema, um diese Änderungshistorie 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 Unterordnern pro Vorgang bleibt wie zuvor beschrieben.

Dateien in Unterordner kopiert

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 auch Parameter festlegen, um dasselbe mit der Datei CustomerInfo.yml zu tun.
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 Cmdlets den folgenden Parameter hinzu, um die Protokollierung im PowerShell-Befehlsfenster zu unterdrücken.
-Quiet
Alternativ können die folgenden Parameter in der Datei CustomerInfo.yml platziert werden.
Confirm: False
DisplayLog: False

Exportieren von PCs, die keine Delivery Controller™ sind

Das Tool für die automatisierte Konfiguration verwendet mehrere Citrix PowerShell SDKs, um die lokale Site-Konfiguration 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 vom Tool benötigten Satz von Citrix PowerShell SDKs zu installieren. 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.

Umzug 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 CustomerInfo.yml eine der folgenden Zeilen hinzu (oder ändern Sie sie, falls bereits vorhanden), je nachdem, mit welcher Umgebung Sie sich verbinden möchten.
    Environment: 'ProductionGov'
    oder
    Environment: 'ProductionJP'
Die automatisierte Konfiguration kann nun in diesen Umgebungen verwendet werden.

Datenerfassung in Citrix Cloud

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 Discussion forum for Automated Configuration.

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.