Cloud-Konfigurationen in lokale Umgebungen migrieren

Last published : Nov 03, 2026
Dieser Artikel beschreibt die Sicherung und Migration Ihrer Cloud-Konfigurationen zu lokalen Sites.
Related information
Konfiguration zu Citrix Cloud™ migrieren

Voraussetzungen für die Migration Ihrer Konfiguration

  • Citrix Virtual Apps and Desktops™ On-Premises-Umgebung mit mindestens einem registrierten VDA.
  • Citrix Virtual Apps and Desktops On-Premises-Umgebung, die auf einer der folgenden Versionen ausgeführt wird:
    • Die aktuellste Long-Term Service Release (LTSR)-Version – 2402.
    • Eine der Current Releases (CR)-Versionen – 2308, 2311.
  • Führen Sie die Befehle des Automated Configuration Tool (ACT) auf einem in die Domäne eingebundenen Computer mit .Net 4.7.2 oder höher aus.
  • Ein Computer mit dem Citrix PowerShell SDK. Das PowerShell SDK ist im Installationspaket des Citrix Delivery Controller™ enthalten.
Hinweis:
  • Wenn Sie das ACT auf einem anderen Computer ausführen, muss dieser in die Domäne eingebunden sein und Studio muss die korrekten PowerShell-Snap-Ins installiert haben. Den Installer erhalten Sie auf der Citrix Virtual Apps and DesktopsDownload-Website.
  • Auf der lokalen Site empfehlen wir, ACT auf dem DDC zu installieren. ACT kann über das Desktopsymbol gestartet werden.
  • Wenn ACT über das Standard-Powershell-Fenster verwendet werden soll, führen Sie den folgenden Befehl aus: Import-Module Citrix.AutoConfig.Commands
ACT ist nicht Teil des System-PowerShell-Pfads und muss daher explizit importiert werden.

Wichtige Schritte

Befolgen Sie die Anweisungen, um die Migration Ihrer Cloud-Konfigurationen in die lokale Umgebung abzuschließen:
  1. Cloud-Konfiguration sichern.
  2. YML-Dateien ändern.
  3. Konfigurationen in die lokale Umgebung importieren.

Cloud-Konfiguration sichern

  1. Installieren Sie die Automated Configuration.
  2. Doppelklicken Sie auf das Symbol Auto Config. Ein PowerShell-Fenster wird angezeigt.
  3. Führen Sie New-CvadAcCustomerInfoFile aus, um eine Datei CustomerInfo.yml zu erstellen. Weitere Informationen finden Sie unter Kundeninformationsdatei füllen.
  4. Führen Sie den Befehl Backup-CvadAcToFile aus, um eine Sicherung Ihrer Cloud-Konfigurationen zu erstellen.
    Hinweis:
    • Nachdem Sie ein Cmdlet zum ersten Mal ausgeführt haben, wird ein Sicherungsordner mit den .yml-Konfigurationsdateien und Protokollen erstellt. Der Ordner befindet sich unter %HOMEPATH%\Documents\Citrix\AutoConfig.
    • Wenn Fehler oder Ausnahmen auftreten, lesen Sie den Abschnitt Fixups in der Protokolldatei.
    • Backup-CvadToFile unterstützt die Parameter IncludeByName oder ExcludeByName nicht.
Wichtig:
Citrix empfiehlt, alle Komponenten zusammen zu sichern.

YML-Dateien ändern

Ändern Sie die .yml Dateien, die sich unter %HOMEPATH%\Documents\Citrix\AutoConfig befinden, um die Details der lokalen Umgebung aufzunehmen, wie in der folgenden Tabelle beschrieben:
YML-Datei Parameter Beschreibung Beispiele
CustomerInfo.yml Environment Ändern Sie Environment in OnPrem. Der Wert des Parameters Environment ist Groß-/Kleinschreibung-sensitiv.
ZoneMapping.yml DaaS:CVAD Ordnen Sie Ihre Cloud-Ressourcenstandorte Ihren lokalen Zonen zu. Es müssen alte:neue Zonen sein
CvadAcSecurity.yml Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ Fügen Sie den Hypervisor-Benutzernamen und die Kennwörter hinzu. Wenn der Hypervisor XenServer ist,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

Konfigurationen in die lokale Umgebung importieren

  1. Führen Sie je nach Ihren Anforderungen einen der folgenden Befehle auf Ihrer lokalen Site aus:
    1. Merge-CvadAcToSite – wenn eine lokale Site ausgeführt wird und Sie die Cloud-Konfigurationen damit zusammenführen möchten.
    2. Import-CvadAcToSite -Environment OnPrem – Wenn keine lokalen Konfigurationen verfügbar sind und Sie die Cloud-Konfigurationen importieren, um eine zu erstellen.
Wichtig:
Citrix empfiehlt, jeweils eine Komponente zu importieren, um Konflikte zu vermeiden.