Fehlerbehebung bei der automatisierten Konfiguration und zusätzliche Informationen
Wichtig:
Informationen zu häufig auftretenden Fehlermeldungen bei der automatisierten Konfiguration und entsprechenden Lösungen finden Sie in den häufig gestellten Fragen 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. Dabei können beispielsweise 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 an der Stelle fortzufahren, an der 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 die Parameterwerte und ihre 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 OnErrorAction-Parameter auf die folgenden Migrationsbefehle anwenden:
Compare-CvadAcToSiteImport-CvadAcToSiteMerge-CvadAcToSiteNew-CvadAcToSiteRestore-CvadAcToSite
Beispiel: Merge-CvadAcToSite -OnErrorAction StopImmediately
Fortsetzungsparameter
Diese Parameter definieren, wie das Tool nach einer Unterbrechung oder einem Stopp aufgrund eines Fehlers fortgesetzt wird.
Sie können Fortsetzungsparameter auf Migrations-Cmdlets anwenden, die einen der folgenden OnErrorAction-Parameterwerte enthalten:
PauseStopCompEndStopImmediately
Diese Tabelle zeigt die Parameterwerte und ihre 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. Alle verbleibenden Komponenten werden auf „true“ gesetzt. Es werden mehrere Komponenten verarbeitet. |
-Repeat |
Verwendet die Komponente aus CurrentComponent.txt als Startpunkt. Alle verbleibenden Komponenten werden 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 der 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 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 unter *%HOMEPATH%\Documents\Citrix\AutoConfig* in der Datei History.Log. Jede Cmdlet-Ausführung führt zu einem Hauptprotokolleintrag, 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 Citrix Support zu sammeln. Dieses Cmdlet komprimiert 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 erhält den Namen CvadAcSupport_JJJJ_MM_TT_hh_mm_ss.zip, basierend auf Datum und Zeitstempel. 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 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 Unterstützung bei der Problemlösung bereitstellen.
Export
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 die zugehörigen 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:
- Gruppenrichtlinien fehlen Bereitstellungsgruppenfilter. Die üblichen Ursachen sind Bereitstellungsgruppen, die nicht importiert wurden.
- Anwendungen können nicht importiert oder zusammengeführt werden. Die übliche Ursache sind fehlende Bereitstellungsgruppen oder Anwendungsgruppen, die nicht importiert wurden.
- Anwendungsgruppen fehlt ein RestrictToTag. Die üblichen Ursachen sind Tags, die nicht importiert wurden.
- Hostverbindungen schlagen fehl. Die übliche Ursache sind fehlende Sicherheitsinformationen in der Datei CvadAcSecurity.yml.
- Maschinenkataloge schlagen fehl. Die übliche Ursache sind Hostverbindungen, die nicht importiert wurden.
- Maschinen fehlen in Maschinenkatalogen und Bereitstellungsgruppen. Die übliche Ursache sind Maschinen, die nicht im Active Directory gefunden wurden.
- Benutzer fehlen in Bereitstellungsgruppen. Die übliche Ursache sind Benutzer, die nicht im 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. Sollte dies der Fall sein, 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 Ergebnisse des Zusammenführens, Importierens oder Wiederherstellens in Studio immer visuell, um sicherzustellen, dass die Cloud-Site den Erwartungen entspricht.
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.
Export
Alle exportierten Dateien werden an zwei Speicherorten abgelegt, was die Benutzerfreundlichkeit und eine Historie der Exporte gewährleistet. 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 Site-Konfiguration. 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 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-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 ein Verlauf der Quellendateien für die Cloud-Site-Änderung 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 über den 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 diesen Änderungsverlauf zu speichern und eine Methode zur Wiederherstellung früherer Zustände bereitzustellen.
Cloud-Site-Konfigurationsbackups 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 vorstehenden 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 vorstehenden 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 Ordners, der im Parameter -RestoreFolder angegeben ist.
Automatisierung
Cmdlets des Automated Configuration Tools können in Automatisierungsskripten ohne Administratorintervention 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 dasselbe erreicht wird, 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 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 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:
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.
- Bearbeiten Sie im Ordner %HOMEPATH%\Documents\Citrix\AutoConfig die Datei CustomerInfo.yml.
-
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.
In diesem Artikel
- Fehler des Tools für die automatisierte Konfiguration
- Protokolle
- Diagnosedateien
- Probleme aufgrund von Abhängigkeiten
- Empfehlungen
- Ordner
- Backups
- Automatisierung
- Exportieren von PCs, die nicht der Delivery Controller™ sind
- Umzug zu Citrix Cloud™ Government und Japan Control Plane
- Citrix Cloud-Datenerfassung
- Zusätzliche Ressourcen