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

Konfiguration zu Citrix Cloud™ migrieren

April 7, 2026
Beitrag von: 
C C

Das Automated Configuration Tool (ACT) ermöglicht die Migration der Citrix Virtual Apps and Desktops™-Konfiguration (Richtlinien, Anwendungen, Kataloge, Administratorrollen, Bereiche und andere) von einer oder mehreren lokalen Sites zu Citrix DaaS, das in Citrix Cloud gehostet wird. Es kann auch verwendet werden, um Informationen zwischen verschiedenen Cloud-Regionen oder -Mandanten zu migrieren.

Dieses Tool erkennt und exportiert eine oder mehrere lokale Sites als Sammlung von Konfigurationsdateien, die Sie optional bearbeiten können. Die Konfiguration dieser Dateien kann dann in Citrix DaaS importiert werden.

  • Die Migration erfolgt in Phasen durch mehrmaliges Ausführen des Tools, sodass Sie den gewünschten Konfigurationszustand leicht erreichen können.

  • ACT ist nicht nur ein einmaliges Migrationstool. Sie können es verwenden, um Ihre täglichen Cloud-Operationen zu verwalten, wie zum Beispiel:

  • Automatisierung der Übertragung von Test- oder Staging-Cloud-Konten auf Produktions-Cloud-Konten
  • Sichern und Wiederherstellen Ihrer Konfiguration

  • Aufteilen einer Cloud-Umgebung in mehrere Clouds

  • Das folgende 2-minütige Video bietet einen kurzen Überblick über Automated Configuration.

Voraussetzungen für die Migration Ihrer Konfiguration

Für den Export Ihrer Konfiguration aus Citrix Virtual Apps™ and Desktops benötigen Sie:

  • Citrix Virtual Apps and Desktops: aktuelle Version und deren direkter Vorgänger oder Citrix Virtual Apps and Desktops, XenApp und XenDesktop® LTSRs: alle Versionen
  • Eine in die Domäne eingebundene Maschine mit .NET Framework 4.7.2 oder höher und dem Citrix PowerShell SDK. Dies wird automatisch auf dem Delivery Controller installiert. (Um auf einer anderen Maschine als dem lokalen Delivery Controller ausgeführt zu werden, muss Citrix Studio installiert sein, da Studio die korrekten PowerShell-Snap-Ins installiert. Das Studio-Installationsprogramm finden Sie auf den Citrix Virtual Apps and Desktops Installationsmedien.)

Für den Import Ihrer Konfiguration in Citrix DaaS benötigen Sie:

  • Eine Maschine mit Zugriff auf Citrix Cloud. Dies muss kein Delivery Controller™ oder eine in die Domäne eingebundene Maschine sein.
  • Citrix DaaS bereitgestellt.
  • Einen aktiven Ressourcenstandort mit installiertem Connector und in dieselbe Domäne eingebunden wie das lokale Setup.
  • Die Konnektivität zu Sites, die auf Citrix Cloud zugreifen, muss zugelassen und verfügbar sein. Weitere Informationen finden Sie unter System- und Konnektivitätsanforderungen.

Hinweis:

Automated Configuration kann nicht auf einem Cloud Connector-System installiert werden.

Wichtige Schritte

  1. Laden Sie das Automated Configuration Tool herunter und überprüfen Sie die Systemanforderungen. Siehe Automated Configuration herunterladen.
  2. Füllen Sie die Datei CustomerInfo.yml mit Ihren Werten für CustomerName, CustomerID und SecretKey aus, die im Citrix Cloud-Portal generiert wurden. Siehe Kunden-ID, Client-ID und geheimen Schlüssel generieren und Kundeninformationsdatei ausfüllen.
  3. Wenn die lokale Site mehrere Zonen enthält, aktualisieren Sie die Datei ZoneMapping.yml, um Zonen Citrix DaaS-Ressourcenstandorten zuzuordnen. Siehe Zonen-Mapping-Datei ausfüllen.
  4. Wenn die Site mehrere Hosting-Verbindungen enthält, aktualisieren Sie die Datei CvadAcSecurity.yml mit den Verbindungsinformationen für jeden Hosttyp, der zu Citrix DaaS migriert wird. Wenn nur eine einzige Host-Verbindung vorhanden ist, aktualisieren Sie die Datei CvadAcSecurity.yml mit den Verbindungsinformationen für diese Host-Verbindung. Siehe Sicherheitsdatei für Host-Verbindungen aktualisieren.
  5. Öffnen Sie ACT und exportieren Sie Ihre lokale Site mit dem Befehl Export-CvadAcToFile. Eine Liste der für die Migration unterstützten Komponenten finden Sie unter Unterstützte Migrationsobjekte. Informationen zu den Exportschritten finden Sie unter Lokale Konfiguration exportieren.
  6. Importieren Sie Komponenten schrittweise mit dem Befehl Merge-CvadAcToSite. Alternativ können Sie die gesamte Site auf einmal migrieren. Stellen Sie sicher, dass Sie Komponenten in der unter Reihenfolge der Komponentenmigration aufgeführten Reihenfolge migrieren. Informationen zu den Importschritten finden Sie unter Import ausführen.
  7. Aktivieren Sie die Cloud-Site. Siehe Sites aktivieren.

Automated Configuration herunterladen

Laden Sie das Automated Configuration Tool von Citrix Downloads herunter und installieren Sie es.

Automated Configuration aktualisieren

Um Funktionsfehler zu vermeiden, verwenden Sie immer die neueste verfügbare Version von ACT.

Um Ihre Tool-Version zu erfahren, gehen Sie wie folgt vor:

  1. Doppelklicken Sie auf das Symbol Auto Config. Ein PowerShell-Fenster wird angezeigt.

  2. Führen Sie den folgenden Befehl aus, um Ihre Versionsnummer zu überprüfen.

    Get-CvadAcStatus
<!--NeedCopy-->
      1. Vergleichen Sie Ihre Tool-Version mit der unter Citrix Downloads aufgeführten Version. Dort befindet sich die neueste Version des Tools.
      1. Laden Sie die neueste Version des Tools herunter und installieren Sie sie. Sie müssen die alte Version nicht deinstallieren, um Automated Configuration zu aktualisieren.

Hinweis:

Wenn Sie Cmdlets ausführen, um in Automated Configuration auf die Cloud zuzugreifen, benachrichtigt Sie das Tool, wenn eine neuere Version zum Download verfügbar ist. Weitere Informationen zu Cmdlets finden Sie unter Automated Configuration Tool-Cmdlets.

Kunden-ID, Client-ID und geheimen Schlüssel generieren

Um die lokale Site zu Citrix DaaS zu migrieren, füllen Sie die Datei CustomerInfo.yml mit der Kunden-ID, Client-ID und dem geheimen Schlüssel aus dem Citrix Cloud-Portal aus.

So rufen Sie die Kunden-ID ab:

  1. Melden Sie sich bei Ihrem Citrix Cloud-Konto an und wählen Sie den Kunden aus.
  2. Klicken Sie auf das Rastersymbol und wählen Sie Identitäts- und Zugriffsverwaltung.
  3. Navigieren Sie zu API-Zugriff > Sichere Clients. Die Kunden-ID wird auf der Seite angezeigt.

So rufen Sie die Client-ID und den geheimen Schlüssel ab:

  1. Geben Sie auf der Seite Sichere Clients einen Namen in das Feld ein. Dieser Name wird verwendet, um zwischen mehreren Client-IDs und geheimen Schlüsseln zu unterscheiden.
  2. Klicken Sie auf Client erstellen, um die Client-ID und den geheimen Schlüssel zu erstellen.
  3. Kopieren Sie die Client-ID und den geheimen Schlüssel an einen sicheren Ort und laden Sie die .csv-Datei mit diesen Informationen herunter. Verwenden Sie die .csv-Datei, um die Datei CustomerInfo.yml zu füllen.

Hinweis:

  • Die Client-ID und der geheime Schlüssel laufen nicht ab. Wenn sie kompromittiert werden, entfernen Sie sie sofort mithilfe des Papierkorb-Symbols und erstellen Sie neue.
    • Der geheime Schlüssel kann nicht wiederhergestellt werden, wenn er verloren geht oder vergessen wird; eine neue Client-ID und ein neuer geheimer Schlüssel müssen erstellt werden.

Kundendaten-Datei füllen

Die Datei CustomerInfo.yml macht es überflüssig, bei jeder Ausführung des Cmdlets Kundeninformationsparameter anzugeben. Jede Kundeninformation kann durch die Verwendung von Cmdlet-Parametern überschrieben werden.

Verwenden Sie das Cmdlet New-CvadAcCustomerInfoFile, um die Datei CustomerInfo.yml zu erstellen.

Wichtig:

Bearbeiten Sie die Datei CustomerInfo.yml nicht manuell. Dies kann zu unbeabsichtigten Formatierungsfehlern führen.

Das Cmdlet New-CvadAcCustomerInfoFile hat die folgenden erforderlichen Parameter.

-  CustomerId: Kunden-ID.
-  ClientId: Die auf Citrix Cloud erstellte Client-ID des Kunden.
  • Secret: Der auf Citrix Cloud erstellte geheime Schlüssel des Kunden.

Beispiel:

New-CvadAcCustomerInfoFile -CustomerId markhof123 -ClientId 6813EEA6-46CC-4F8A-BC71-539F2DAC5984 -Secret TwBLaaaaaaaaaaaaaaaaaw==
<!--NeedCopy-->

Sie können die Datei CustomerInfo.yml auch mit dem Parameter SecurityCsvFileSpec erstellen, der auf die heruntergeladene Datei security.csv verweist. Sie müssen auch die CustomerId angeben.

New-CvadAcCustomerInfoFile -SecurityCsvFileSpec C:\Users\my_user_name\downloads/security.csv -CustomerId markhof123
<!--NeedCopy-->

-  Verwenden Sie das Cmdlet `Set-CvadAcCustomerInfoFile`, um die Datei `CustomerInfo.yml` zu aktualisieren. Dieses Cmdlet ändert nur die Client-ID.

    -  Set-CvadAcCustomerInfoFile -ClientId C80487EE-7113-49F8-85DD-2CFE30CC398E
<!--NeedCopy-->

-  Das Folgende ist eine Beispiel-Datei `CustomerInfo.yml`.

-  # Created/Updated on 2020/01/29 16:46:47
            CustomerId: ‘markhof123’
            ClientId: ‘6713FEA6-46CC-4F8A-BC71-539F2DDK5384’
            Secret: ‘TwBLaaabbbaaaaaaaaaaw==’
            Environment: Production
            AltRootUrl: ‘’
            StopOnError: False
  • AlternateFolder: ‘’
    • Locale: ‘en-us’
    • Editor: ‘C:\Program Files\Notepad++\notepad++.exe’
    • Confirm: True
    • DisplayLog: True

Zonenzuordnungsdatei füllen

-  Eine lokale Zone entspricht dem Cloud-Ressourcenstandort. Im Gegensatz zu anderen Site-Komponenten können Sie die lokale Zone nicht automatisch in die Cloud importieren. Stattdessen muss sie manuell mithilfe der Datei `ZoneMapping.yml` zugeordnet werden. Importfehler können auftreten, wenn der Zonenname keinem vorhandenen Ressourcenstandortnamen zugeordnet ist.

-  Wenn die lokalen Sites nur eine Zone und die Cloud-Sites nur einen Ressourcenstandort haben, stellt das Automated Configuration Tool die korrekte Zuordnung her, wodurch die manuelle Verwaltung der Datei `ZoneMapping.yml` entfällt.

-  Wenn die lokalen Sites jedoch mehrere Zonen oder die Cloud-Sites mehrere Ressourcenstandorte haben, aktualisieren Sie die Datei `ZoneMapping.yml` manuell, um die korrekte Zuordnung von lokalen Zonen zu Cloud-Ressourcenstandorten widerzuspiegeln.

-  Die Datei `ZoneMapping.yml` befindet sich unter `%HOMEPATH%\Documents\Citrix\AutoConfig`. Der Inhalt der `.yml`-Datei ist ein Wörterbuch mit dem Zonennamen als Schlüssel und dem Ressourcenstandortnamen als Wert.

-  Zum Beispiel wird eine lokale Citrix Virtual Apps and Desktops-Site mit einer primären Zone namens "Zone-1" und einer sekundären Zone namens "Zone-2" zu einer Citrix DaaS-Bereitstellung mit zwei neu erstellten Cloud-Ressourcenstandorten namens "Cloud-RL-1" und "Cloud-RL-2" migriert. In diesem Fall würde die ZoneMapping.yml wie folgt konfiguriert:

-  Zone-1: Cloud-RL-1

-  Zone-2: Cloud-RL-2

-  > **Hinweis:**
-  >
-  > Fügen Sie ein Leerzeichen zwischen dem Doppelpunkt und dem Namen des Ressourcenstandorts ein. Wenn im Zonen- oder Ressourcenstandortnamen Leerzeichen verwendet werden, setzen Sie den Namen in Anführungszeichen.

Aktualisieren der Sicherheitsdatei für Hostverbindungen

-  Hostverbindungen und die zugehörigen Hypervisoren können mit ACT exportiert und importiert werden.

-  Das Hinzufügen eines Hypervisors zu einer Hostverbindung erfordert sicherheitsrelevante Informationen, die spezifisch für den Hypervisor-Typ sind. Diese Informationen können aus Sicherheitsgründen nicht vom lokalen Standort exportiert werden. Sie müssen die Informationen manuell bereitstellen, damit Automated Configuration Hostverbindungen und Hypervisoren erfolgreich in den Cloud-Standort importieren kann.

-  Der Exportvorgang erstellt die Datei `CvadAcSecurity.yml` unter `%HOMEPATH%\Documents\Citrix\AutoConfig`, die Platzhalter für jedes Sicherheitselement enthält, das für den jeweiligen Hypervisor-Typ erforderlich ist. Sie müssen die Datei `CvadAcSecurity.yml` aktualisieren, bevor Sie sie in den Cloud-Standort importieren. Administratoraktualisierungen bleiben über mehrere Exporte hinweg erhalten, wobei bei Bedarf neue Sicherheitsplatzhalter hinzugefügt werden. Sicherheitselemente werden niemals entfernt. Weitere Informationen finden Sie unter [Manuelles Aktualisieren der Datei CvadAcSecurity.yml](/de-de/tech-zone/learn/poc-guides/citrix-automated-configuration.html#manually-update-the-cvadacsecurityyml-file)

-  HostConn1:
            ConnectionType: XenServer®
            UserName: root
            PasswordKey: rootPassword
            HostCon2:
            ConnectionType: AWS
            ApiKey: 78AB6083-EF60-4D26-B2L5-BZ35X00DA5CH
            SecretKey: TwBLaaaaaaaaaaaaaaaaaw==
            Region: East

Sicherheitsspezifische Informationen pro Hypervisor

Im Folgenden sind die für jeden Hypervisor-Typ erforderlichen Sicherheitsinformationen aufgeführt.

-  XenServer, Hyper-V, VMware
-  Benutzername
-  Klartext-Passwort
-  Microsoft Azure
-  Abonnement-ID
-  Anwendungs-ID
-  Anwendungsgeheimnis
-  AWS
-  Dienstkonto-ID
-  Anwendungsgeheimnis
-  Region

-  ### Besondere Sicherheitsaspekte

Alle Sicherheitsinformationen werden als Klartext eingegeben. Wenn Klartext nicht empfohlen wird, können die Hostverbindungen und zugehörigen Hypervisoren manuell mit Studio erstellt werden. Die Hostverbindungen und Hypervisor-Namen müssen exakt mit ihren lokalen Gegenstücken übereinstimmen, damit Maschinenkataloge, die die Hostverbindungen verwenden, erfolgreich importiert werden können.

-  ## Exportieren Ihrer lokalen Citrix Virtual Apps and Desktops-Konfiguration

-  Mithilfe eines `export`-PowerShell-Befehls können Sie Ihre vorhandene lokale Konfiguration exportieren und die erforderlichen `.yml`-Dateien abrufen. Diese Dateien werden verwendet, um Ihre gewünschte Konfiguration in Citrix Cloud zu importieren.

Unterstützte Migrationsobjekte 

-  Automated Configuration unterstützt die Übertragung der Konfiguration der folgenden Komponenten:

-  Tags
-  Delegierte Administration
-  Bereiche
-  Rollen
-  Hostverbindungen
-  Ein einzelner Ressourcenpool
-  Administrationsbereiche
-  Maschinenkataloge
-  Administrationsbereiche
-  Maschinen
-  Remote-PC-Zugriff, Physisch, Gepoolt, Bereitgestellt, [MCS](#understand-migrating-machine-creation-services-provisioned-catalogs), Zugewiesen
-  StoreFront™
-  Bereitstellungsgruppen
-  Zugriffsrichtlinie
-  Zuordnung von Administrationsbereichen
-  Anwendungszugriffsrichtlinie
-  Zuweisungsrichtlinie
-  Berechtigungs-/Desktoprichtlinie
-  Energiezeitpläne
-  Sitzungsverweildauer
-  Sitzungsvorstart
-  Neustartzeitpläne
-  Tags
-  Anwendungsgruppen
-  Zuordnung von Administrationsbereichen
-  Bereitstellungsgruppen
-  Benutzer und Gruppen
  • Anwendungen
    • Anwendungsordner
    • Symbole
    • Anwendungen
    • Broker-konfigurierte FTAs
    • Tags
    • Gruppenrichtlinien
    • Benutzerzonenpräferenzen

Lokale Konfiguration exportieren

  1. Doppelklicken Sie auf das Symbol Auto Config. Ein PowerShell-Fenster wird angezeigt.

  2. Führen Sie den folgenden Befehl aus, um alle Komponenten zu exportieren. Das Exportieren Ihrer lokalen Konfiguration ändert diese in keiner Weise.

    Export-CvadAcToFile
<!--NeedCopy-->
  • Nachdem Sie ein Cmdlet zum ersten Mal ausgeführt haben, wird ein Exportordner mit den .yml-Konfigurationsdateien und Protokollen erstellt. Der Ordner befindet sich unter %HOMEPATH%\Documents\Citrix\AutoConfig. Jeder weitere Export erstellt einen Unterordner. Der übergeordnete Ordner %HOMEPATH%\Documents\Citrix\AutoConfig enthält immer die exportierten Dateien des letzten Exports.

Hinweis:

Wenn Automated Configuration nicht auf dem Delivery Controller installiert ist, führen Sie import-module Citrix.AutoConfig.Commands aus, bevor Sie das Tool über PowerShell verwenden. Dieser Schritt ist nicht erforderlich, wenn Sie Automated Configuration über das Symbol Auto Config öffnen.

Wenn Fehler oder Ausnahmen auftreten, lesen Sie den Abschnitt Fixups in der Protokolldatei.

Importieren Ihrer Konfiguration in Citrix DaaS

Wichtig:

  • Wenn Sie eine lokale Bereitstellung in die Cloud migrieren, stellen Sie sicher, dass die Domänen- und OU-GPOs, die die Citrix-Einstellungen enthalten, in die Cloud migriert werden. Citrix Web Studio™ unterstützt GPMC nicht, und daher sind die Domänen- und OU-GPOs im Web Studio nicht sichtbar. Die Citrix-Richtlinien-Engine erzwingt die Domänen- und OU-GPOs auf VDAs und Benutzern, die sich in den Domänen und OUs befinden. Nach der Anmeldung an einem VDA kann ein Benutzer feststellen, dass die Richtlinien der Domänen- und OU-GPOs auf seine Sitzung angewendet werden. Administratoren können diese Richtlinien und Einstellungen jedoch nicht sehen, was zu Verwirrung führen kann.
-  ### Reihenfolge der Komponentenmigration

-  Die Komponenten und ihre Abhängigkeiten sind hier aufgeführt. Die Abhängigkeiten einer Komponente müssen vorhanden sein, bevor sie importiert oder zusammengeführt werden kann. Wenn eine Abhängigkeit fehlt, kann dies dazu führen, dass der Import- oder Zusammenführungsbefehl fehlschlägt. Der Abschnitt **Fixups** der Protokolldatei zeigt fehlende Abhängigkeiten an, wenn ein Import oder eine Zusammenführung fehlschlägt.
    1. Tags
      • Keine Vorabhängigkeiten
    1. Delegierte Administration
      • Keine Vorabhängigkeiten
  1. Hostverbindungen
    • Sicherheitsinformationen in CvadAcSecurity.yml
  2. Maschinenkataloge
    • Maschinen im Active Directory vorhanden
    • Hostverbindungen
    • Tags
  3. StoreFront
  4. Bereitstellungsgruppen
    • Maschinen im Active Directory vorhanden
    • Benutzer im Active Directory vorhanden
    • Maschinenkataloge
    • Tags
  5. Anwendungsgruppen
    • Bereitstellungsgruppen
    • Tags
  6. Anwendungen
    • Bereitstellungsgruppen
    • Anwendungsgruppen
    • Tags
  7. Gruppenrichtlinien
    • Bereitstellungsgruppen
    • Tags
  8. Benutzerzonenpräferenzen

Import ausführen

  1. Doppelklicken Sie auf das Symbol Auto Config. Ein PowerShell-Fenster wird angezeigt.

  2. Führen Sie den folgenden Befehl aus, um alle Komponenten zu importieren.

    Merge-CvadAcToSite
<!--NeedCopy-->

Vergleichen Sie den erwarteten Zustand mit dem neuen aktuellen Zustand. Verschiedene Importoptionen steuern, ob die Importergebnisse identisch sind oder eine Teilmenge der lokalen Site darstellen.

Nachdem Sie das Cmdlet ausgeführt haben, wird ein Exportordner 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.

  • Hinweis:

  • Wenn Automated Configuration nicht auf dem Delivery Controller installiert ist, führen Sie import-module Citrix.AutoConfig.Commands aus, bevor Sie das Tool über PowerShell verwenden. Dieser Schritt ist nicht erforderlich, wenn Sie Automated Configuration über das Symbol Auto Config öffnen.

Importvorgang verstehen

Der Importprozess ist darauf ausgelegt, Updates präzise durchzuführen, nur notwendige Updates auszuführen und zu überprüfen, ob alle Updates korrekt vorgenommen wurden. Die folgenden Schritte werden bei allen Importvorgängen ausgeführt:

  1. Lesen der exportierten .yml-Datei (erwarteter Zustand).
  2. Lesen der Cloud (aktueller Zustand).
  3. Sichern des Cloud-Zustands vor dem Import in .yml-Dateien (Pre-Backup kann bei Bedarf wiederhergestellt werden).
  4. Bewerten der Unterschiede zwischen dem erwarteten und dem aktuellen Zustand. Dies bestimmt, welche Updates vorgenommen werden müssen.
  5. Durchführen der Updates.
  6. Erneutes Lesen der Cloud (neuer aktueller Zustand).
  7. Sichern des Cloud-Zustands nach dem Import in .yml-Dateien (Post-Backup kann bei Bedarf wiederhergestellt werden).
  8. Vergleichen des neuen aktuellen Zustands mit dem erwarteten Zustand.
  9. Berichten der Vergleichsergebnisse.

Granulare Migration

Wichtig:

Weitere Informationen zur Reihenfolge der Komponentenmigration finden Sie unter Reihenfolge der Komponentenmigration.

Sie können Komponenten selektiv oder sogar nur Komponentennamen migrieren.

  • Unterstützte Komponentenparameter umfassen MachineCatalogs, Tags und weitere.
  • Unterstützte Komponentennamenparameter umfassen IncludeByName und ExcludeByName sowie andere Parameter.

Weitere Informationen zu Parametern und deren Verwendung finden Sie unter Granulare Migrationsparameter.

Sites aktivieren

Der Delivery Controller in lokalen und Cloud-Sites steuert Ressourcen wie das Brokering von Desktops, Anwendungen und das Neustarten von Maschinen. Probleme treten auf, wenn ein gemeinsamer Satz von Ressourcen von zwei oder mehr Sites gesteuert wird. Eine solche Situation kann bei der Migration von einer lokalen Site zu einer Cloud-Site auftreten. Es ist möglich, dass sowohl die lokalen als auch die Cloud-Delivery Controller denselben Satz von Ressourcen verwalten. Eine solche duale Verwaltung kann dazu führen, dass Ressourcen nicht verfügbar und nicht verwaltbar werden, und kann schwierig zu diagnostizieren sein.

Die Site-Aktivierung ermöglicht es Ihnen, zu steuern, wo die aktive Site gesteuert wird.

Die Site-Aktivierung wird über den Wartungsmodus der Bereitstellungsgruppe verwaltet. Bereitstellungsgruppen werden in den Wartungsmodus versetzt, wenn die Site inaktiv ist. Der Wartungsmodus wird für Bereitstellungsgruppen von aktiven Sites entfernt.

Die Site-Aktivierung hat keinen Einfluss auf die VDA-Registrierung oder Maschinenkataloge und verwaltet diese auch nicht.

  • Set-CvadAcSiteActiveStateCloud
  • Set-CvadAcSiteActiveStateOnPrem

Alle Cmdlets unterstützen die Filterung mit IncludeByName und ExcludeByName. Dieser Parameter ermöglicht es Ihnen, auszuwählen, welche Bereitstellungsgruppen ihren Wartungsmodus ändern können. Bereitstellungsgruppen können bei Bedarf selektiv geändert werden.

Importieren und Übertragen der Kontrolle an die Cloud

Im Folgenden wird auf hoher Ebene beschrieben, wie die Kontrolle von der lokalen Site an die Cloud-Site importiert und übertragen wird.

  1. Exportieren und importieren Sie die lokale Site in die Cloud. Stellen Sie sicher, dass der Parameter –SiteActive bei keinem der Import-Cmdlets vorhanden ist. Die lokale Site ist aktiv und die Cloud-Site inaktiv. Standardmäßig befinden sich die Bereitstellungsgruppen der Cloud-Site im Wartungsmodus.
  2. Überprüfen Sie den Cloud-Inhalt und die Konfiguration.
  3. Stellen Sie außerhalb der Geschäftszeiten die lokale Site auf inaktiv. Der Parameter –SiteActive darf nicht vorhanden sein. Alle Bereitstellungsgruppen der lokalen Site befinden sich im Wartungsmodus.
    • Set-CvadAcSiteActiveStateOnPrem
  4. Stellen Sie die Cloud-Site auf aktiv. Der Parameter –SiteActive muss vorhanden sein. Keine Bereitstellungsgruppen der Cloud-Site befinden sich im Wartungsmodus.
    • Set-CvadAcSiteActiveStateCloud –SiteActive
  5. Überprüfen Sie, ob die Cloud-Site aktiv und die lokale Site inaktiv ist.

Kontrolle zurück an die lokale Site übertragen

Um die Kontrolle von der Cloud-Site an die lokale Site zu übertragen:

  1. Stellen Sie außerhalb der Geschäftszeiten die Cloud-Site auf inaktiv. Alle Bereitstellungsgruppen der Cloud-Site befinden sich im Wartungsmodus.
    • Set-CvadAcSiteActiveStateCloud
  2. Stellen Sie die lokale Site auf aktiv. Keine Bereitstellungsgruppen der lokalen Site befinden sich im Wartungsmodus.
    • Set-CvadAcSiteActiveStateOnPrem -SiteActive

Zusätzliche Informationen zur Site-Aktivierung

  • Wenn keine Maschinen energieverwaltet sind und keine Neustartpläne vorhanden sind (was normalerweise bedeutet, dass auch keine Hostverbindungen bestehen), können alle Cloud-Bereitstellungsgruppen als aktiv importiert werden. Fügen Sie -SiteActive zu Merge-CvadAcToSite/Import-CvadAcToSite hinzu oder führen Sie Set-CvadAcSiteActiveStateCloud -SiteActive nach dem Import aus.
  • Wenn Maschinen energieverwaltet sind oder Neustartpläne vorhanden sind, ist ein anderer Prozess erforderlich. Wenn Sie beispielsweise in dieser Situation von lokal zu Cloud wechseln, stellen Sie die lokale Site mit Set-CvadAcSiteActiveStateOnPrem auf inaktiv. Stellen Sie dann die Cloud-Site mit Set-CvadAcSiteActiveStateCloud -SiteActive auf aktiv.
  • Die Cmdlets Set-CvadAcSiteActiveStateCloud und Set-CvadAcSiteActiveStateOnPrem werden auch verwendet, um den Prozess umzukehren. Führen Sie beispielsweise Set-CvadAcSiteActiveStateCloud ohne den Parameter -SiteActive aus und anschließend Set-CvadAcSiteActiveStateOnPrem mit dem Parameter -SiteActive.

Migrieren von Machine Creation Services bereitgestellten Katalogen verstehen

Hinweis:

Diese Funktion ist nur in Versionen 3.0 und höher verfügbar. Überprüfen Sie Ihre Version, indem Sie Get-CvadAcStatus innerhalb der Automatisierten Konfiguration verwenden.

Machine Creation Services (MCS)-Kataloge erstellen zwei verschiedene Arten von Katalogen:

  • Wenn an einer Maschine vorgenommene Änderungen verloren gehen oder rückgängig gemacht werden (üblicherweise Server-Betriebssysteme, auf denen Anwendungen veröffentlicht werden) – dies ist ein Anwendungsfall für gepoolte VDI / Multi-Session
  • Wenn an einer Maschine vorgenommene Änderungen über einen Neustart hinweg erhalten bleiben (üblicherweise Client-Betriebssysteme mit einem dedizierten Benutzer) – dies ist ein Anwendungsfall für statische VDI

Der Katalogtyp kann im Katalogknoten in Citrix Studio überprüft werden, indem der Wert “Benutzerdaten:” des Katalogs betrachtet wird.

Hinweis:

MCS kann nicht aus der Cloud mithilfe der Automatisierten Konfiguration gesichert werden.

Gepoolte VDI- / Multi-Session-Kataloge

Kataloge mit “Benutzerdaten: Verwerfen” sind gepoolte VDI-Kataloge und können nur das Hauptimage und die Konfiguration migrieren. Virtuelle Maschinen in diesen Katalogen werden nicht migriert. Dies liegt daran, dass der Lebenszyklus der virtuellen Maschine von der Site verwaltet wird, von der Sie importieren, was bedeutet, dass sich ihr Zustand jedes Mal ändern kann, wenn die Maschinen eingeschaltet werden. Dies macht den Import unmöglich, da die Importdaten für die virtuellen Maschinen schnell desynchronisiert werden.

Wenn Sie diese Kataloge mit dem Tool migrieren, erstellt es Katalogmetadaten und initiiert die Erstellung des Hauptimages, es werden jedoch keine Maschinen importiert.

Da dieser Prozess je nach Größe des Hauptimages einige Zeit in Anspruch nehmen kann, startet der Importbefehl innerhalb des Tools nur die MCS-Katalogerstellung und wartet nicht auf deren Abschluss. Nach Abschluss des Imports überwachen Sie den Fortschritt der Katalogerstellung mit Studio in der Cloud-Bereitstellung.

Sobald das Hauptimage erstellt ist, können Sie Maschinen bereitstellen. Berücksichtigen Sie die Kapazitätsüberlegungen, da Sie Kapazität von Ihrer lokalen Nutzung verbraucht hätten.

Alle anderen Objekte (Bereitstellungsgruppen, Anwendungen, Richtlinien usw.), die diesen Katalog verwenden, können importiert werden und müssen nicht auf die Erstellung des Hauptimages warten. Wenn der Katalog fertig erstellt wurde, können Maschinen zum importierten Katalog hinzugefügt werden, und Benutzer können dann ihre Ressourcen starten.

Hinweis:

Verwenden Sie dieselben Befehle, die im Tool verfügbar sind, um Kataloge und alle anderen Objekte zu migrieren.

Statische VDI-Kataloge

Hinweis:

Da dieser Vorgang Low-Level-Details importiert, die in der Datenbank gespeichert sind, muss dieser Prozess von einer Maschine mit Datenbankzugriff ausgeführt werden.

Die statischen VDI-Kataloge migrieren das Hauptimage, Konfigurationen und alle virtuellen Maschinen. Im Gegensatz zum Anwendungsfall gepoolter VDI müssen keine Images erstellt werden.

Die VDAs müssen auf den Connector zeigen, damit sie sich bei der Cloud registrieren können.

Lesen Sie den Abschnitt Sites aktivieren, um die Cloud-Site aktiv zu schalten, damit der Neustartzeitplan, die Energieverwaltung und andere Elemente von der Cloud gesteuert werden.

Nach Abschluss der Migration müssen Sie, wenn Sie diesen Katalog von Ihrer lokalen Site löschen möchten, VM und AD-Konto beibehalten auswählen. Andernfalls werden sie gelöscht, und die Cloud-Site würde auf die gelöschte VM verweisen.

MCS-Tags aktualisieren, um verwaiste Ressourcen nach der Migration zu erkennen

Nachdem Sie von einer lokalen Konfiguration zu einer Cloud-Site oder von Ihrer Cloud-Konfiguration zu einer anderen Cloud-Site migriert haben, müssen Sie die MCS-Site-ID-Tags im Falle persistenter VMs aktualisieren, damit verwaiste Ressourcen korrekt erkannt werden können. Verwenden Sie dazu den PowerShell-Befehl Set-ProvResourceTags. Derzeit ist diese Funktion für Azure anwendbar.

Die detaillierten Schritte sind wie folgt:

  1. Aktualisieren Sie die MCS-Site-ID-Tags von der neuen Citrix-Site mithilfe des PowerShell-Befehls Set-ProvResourceTags. Zum Beispiel:

    Set-ProvResourceTags -ProvisioningSchemeUid xxxxx  [-VMName <String>] [-VMBatchSize XX] [-ResourceType XX]
<!--NeedCopy-->

    Oder,

    Set-ProvResourceTags -ProvisioningSchemeName xxxxx  [-VMName <String>] [-VMBatchSize XX] [-ResourceType XX]
<!--NeedCopy-->

Die Parameterdetails sind wie folgt:

  • ProvisioningSchemeUid oder ProvisioningSchemeName ist ein obligatorischer Parameter.
  • VMName ist ein optionaler Parameter. Wenn kein VMName angegeben wird, werden die Tags aller VMs dieses Maschinenkatalogs aktualisiert.
  • VMBatchSize ist ein optionaler Parameter, um alle VMs in Batches aufzuteilen. Wenn kein VMBatchSize angegeben wird, wird der Standardwert (10) angewendet. Der Bereich liegt zwischen 1 und 60.

  • ResourceType kann einer der folgenden sein:

    • MachineCatalog: Zum Aktualisieren von Tags von Maschinenkatalogressourcen.
    • VirtualMachine: Zum Aktualisieren von Tags von VM-bezogenen Ressourcen.
    • All: (Standard-ResourceType): Zum Aktualisieren von Tags sowohl von Maschinenkatalog- als auch von VM-bezogenen Ressourcen.
Konfiguration zu Citrix Cloud™ migrieren
April 7, 2026
Beitrag von: 
C C
April 7, 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.