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

Fehlerbehebung bei der automatisierten Konfiguration und zusätzliche Informationen

April 6, 2026
Beitrag von: 
C C

Wichtig:

Häufig auftretende Fehlermeldungen bei der automatisierten Konfiguration und entsprechende Lösungen finden Sie in den FAQs zur Fehlerbehebung 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. In diesem Fall können Fehler bei der Verarbeitung von Komponenten wie Maschinenkatalogen, Bereitstellungsgruppen oder Gruppenrichtlinien auftreten. 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.

Parameter OnErrorAction

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:

  • 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 zu stoppen.
  • StopCompEnd Versucht, so viel wie möglich von der Komponente zu verarbeiten. Stoppt, nachdem die Komponente abgeschlossen ist. (Standard)
    StopImmediately Die Verarbeitung stoppt, 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 nach einer Pause oder einem Stopp aufgrund eines Fehlers fortgesetzt wird.

  • Sie können Fortsetzungsparameter auf Migrations-Cmdlets anwenden, die einen der folgenden OnErrorAction-Parameterwerte 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. Es werden mehrere Komponenten verarbeitet.
  • -Resume Verwendet die Komponente aus CurrentComponent.txt als Startpunkt. “All remaining” ist auf “true” gesetzt. Es werden mehrere Komponenten verarbeitet.
  • -Repeat Verwendet die Komponente aus CurrentComponent.txt als Startpunkt. “All remaining” ist auf “false” gesetzt. Es wird nur eine Komponente 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, stoppt die Verarbeitung, und Sie werden aufgefordert, eine Komponente auszuwählen.

Festlegen von OnErrorAction in der Datei CustomerInfo.yml

Sie können OnErrorAction-Werte auch 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

Das Ausführen 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 und dem Datum und der Uhrzeit der Cmdlet-Ausführung. Protokolle werden nicht automatisch gelöscht.

Das Hauptverlaufsprotokoll befindet sich unter *%HOMEPATH%\Documents\Citrix\AutoConfig* in der Datei 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 zippt alle Protokoll- und .yml-Dateien in einer einzigen Zip-Datei. Kundenspezifische 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 heißt CvadAcSupport_jjjj_mm_tt_hh_mm_ss.zip, basierend auf Datum und Uhrzeit. Diese Zip-Datei kann auch als Sicherung dienen.

Jede Protokolldatei enthält Folgendes:

  • Den Namen des Vorgangs und ob der Prüfmodus aktiviert ist
  • Das Start- und Enddatum sowie die Uhrzeit
  • 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, falls zutreffend
  • Speicherort des Sicherungsordners, falls zutreffend
  • Speicherort des Hauptprotokolls
  • Dauer

Diagnosedateien

Diagnosedateien helfen Ihnen bei der Ermittlung und Behebung von Problemen. Die folgenden Dateien werden erstellt, wenn ihr 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 Problemlösung bereitstellen.

Exportieren

PoshSdk_jjjj_mm_tt_hh_mm_ss.ps1

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

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

Transaction_jjjj_mm_tt_hh_mm_ss.txt

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

RestApiContent_jjjj_mm_tt_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 nicht in Active Directory gefunden wurden.
  7. Benutzer fehlen in Bereitstellungsgruppen. Die übliche Ursache sind Benutzer, die nicht in Active Directory 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. Wenn dies auftritt, 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 für die automatisierte Konfiguration erfolgen im Stammordner oder in Unterordnern darin. Der Stammordner befindet sich unter %HOMEPATH%\Documents\Citrix\AutoConfig.

Exportieren

Alle exportierten Dateien werden an zwei Ordnerorten 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 aktuellste exportierte lokale Standortkonfiguration. Jeder Export-Unterordner enthält den Export, der zum angegebenen Datum und zur angegebenen Uhrzeit durchgeführt wurde, wodurch eine Historie der Exporte gepflegt wird. Sie können jeden Export-Unterordner verwenden, um den Cloud-Standort zu konfigurieren. Die automatisierte Konfiguration löscht oder ändert keine vorhandenen Export-Unterordner.

Importieren/Zusammenführen/Synchronisieren/Vergleichen

Import-, Merge- und Compare-Vorgänge werden immer aus Dateien im Stammordner bezogen. Jeder Vorgang führt zur Erstellung eines Unterordners, in den Dateien aus dem Stammordner kopiert werden, wodurch eine Historie der Quellendateien für Cloud-Sites bereitgestellt wird.

Wiederherstellen

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

Backups

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.

Cloud-Site-Konfigurations-Backups werden immer in einem Unterordner namens Backup mit Datum und Uhrzeit des Backups erstellt. Automated Configuration löscht oder ändert keine vorhandenen Export-Unterordner.

Sie können die Backups 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 Informationen zur Sicherungsdatei 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 Informationen zur Sicherungsdatei 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 die 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 operativen Unterordners.

Im Falle von Restore ist der Backup-Ordner ein Unterordner des im Parameter -RestoreFolder angegebenen Ordners.

Automatisierung

Cmdlets des Automated Configuration Tools können in Automatisierungsskripten ohne Administratorintervention ausgeführt werden, indem Eingabeaufforderungen und die Anzeige der Protokoll-Ergebnisse 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 keine Delivery Controller™ sind

Das Automated Configuration Tool 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 Satz der vom Tool benötigten 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:

Automated Configuration kann nicht auf dem Cloud Connector ausgeführt werden.

Umzug zu Citrix Cloud™ Government und Japan Control Plane

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

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

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

    Environment: 'ProductionGov'

    oder

    Environment: 'ProductionJP'

Automated Configuration kann nun in diesen Umgebungen verwendet werden.

Citrix Cloud Datenerfassung

Informationen darüber, welche Daten Citrix Cloud sammelt, 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.

Fehlerbehebung bei der automatisierten Konfiguration und zusätzliche Informationen
April 6, 2026
Beitrag von: 
C C
April 6, 2026
Beitrag von: 
C 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.