Produktdokumentation
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

Zusammenführen mehrerer Sites zu einer einzigen Site

June 5, 2026
Beitrag von: 
C

Die Multi-Site-Unterstützung für die automatisierte Konfiguration bietet eine Methode zum Zusammenführen mehrerer lokaler Sites zu einer einzigen Cloud-Site.

Die Multi-Site-Unterstützung fügt Komponentennamen pro lokaler Site eindeutige Präfixe und Suffixe hinzu, um die Eindeutigkeit der Namen zu gewährleisten, nachdem mehrere lokale Sites zu einer einzigen Cloud-Site zusammengeführt wurden.

Präfixe und Suffixe können für jede der folgenden Komponenten pro lokaler Site zugewiesen werden.

  • AdminScope
  • AdminRole
  • ApplicationAdmin
  • ApplicationFolder
  • ApplicationGroup
  • ApplicationUser
  • DeliveryGroup
  • GroupPolicy
  • HostConnection
  • MachineCatalog
  • StoreFront
  • Tag

Anwendungsordner unterstützen Präfixe, Suffixe und die Neuzuordnung von Stammverzeichnissen. Die Neuzuordnung von Stammverzeichnissen fügt der bestehenden Ordnerstruktur einer Anwendung einen zusätzlichen Ordner der obersten Ebene hinzu.

Regeln für Präfixe und Suffixe

  1. Präfixe und Suffixe dürfen keines der folgenden Sonderzeichen enthalten: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
  2. Präfixe und Suffixe dürfen nachgestellte, aber keine vorangestellten Leerzeichen enthalten.
  3. Präfixe und Suffixe müssen in doppelte Anführungszeichen gesetzt werden, wenn sie nachgestellte Leerzeichen enthalten.
  4. Präfixe und Suffixe werden zum Zeitpunkt des Imports, der Zusammenführung und des Hinzufügens angewendet. Die Quell-.yml-Dateien werden niemals geändert.
  5. Der Präfix- und Suffixprozess fügt abhängigen Komponentennamen, sofern zutreffend, automatisch Präfixe oder Suffixe hinzu. Wenn beispielsweise Maschinenkatalognamen mit „East“ versehen werden, werden Bereitstellungsgruppen, die auf sie verweisen, ebenfalls mit „East“ versehen.
  6. Wenn ein Komponentenname bereits mit dem Präfix oder Suffix beginnt, wird kein Präfix oder Suffix hinzugefügt. Komponentennamen dürfen keine doppelten identischen Präfixe oder Suffixe enthalten.
  7. Präfixe und Suffixe können einzeln oder in Kombination verwendet werden.
  8. Die Verwendung eines Präfixes oder Suffixes für eine Komponente ist optional.

Hinweis:

Studio zeigt Komponenten in alphabetischer Reihenfolge an.

Komponenten nach Site gruppieren

Verwenden Sie Präfixe, um Komponenten einer einzelnen Site visuell zu gruppieren. Jede Site wird in einer eigenen Gruppe aufgeführt, wobei die Präfixe die alphabetische Reihenfolge der verschiedenen Site-Gruppen steuern.

Komponenten nach Namen gruppieren

Verwenden Sie Suffixe, um gleichnamige Komponenten von mehreren Sites visuell zu gruppieren. Gleichnamige Komponenten von verschiedenen Sites wechseln sich visuell ab.

Präfix- und Suffix-Zuordnungsdatei

Die Site-Präfixierung beginnt mit der Datei SiteMerging.yml, die die Site-Präfix- und Suffix-Zuordnung für eine oder mehrere lokale Sites enthält. Sie können die Datei SiteMerging.yml manuell oder mithilfe der verfügbaren Cmdlets verwalten, die im Abschnitt (/de-de/citrix-virtual-apps-desktops/2503/manage-deployment/auto-config-cmdlets-migration#merging-multiple-on-premises-sites-cmdlets) aufgeführt sind.

Lokale Site exportieren

Das Zusammenführen kann erst beginnen, wenn Sie eine lokale Site exportiert haben. Informationen zum Exportieren einer lokalen Site finden Sie unter (/de-de/citrix-virtual-apps-desktops/2503/manage-deployment/migrate#export-on-premises-configuration).

Zentraler Export-Zielordner

Die in diesem Abschnitt beschriebenen Methoden legen mehrere Site-Exporte an einem zentralen Dateifreigabespeicherort ab. Die Datei SiteMerging.yml, die Datei CustomerInfo.yml und alle Exportdateien befinden sich an diesem Dateifreigabespeicherort, sodass Sie den Import von einem Speicherort aus unabhängig von den lokalen Sites durchführen können.

Cloud-Zugriffsoperationen verweisen niemals auf die lokalen Sites oder Active Directory, wodurch Sie Cloud-Zugriffsoperationen von überall aus durchführen können.

Dafür gibt es zwei Methoden:

  • (#direct-file-share): Um aus der direkten Dateifreigabe zu importieren, zusammenzuführen oder hinzuzufügen, müssen Sie entscheiden, von welcher Maschine aus Sie den Cloud-Zugriffsvorgang durchführen möchten.
  • Dateifreigabereferenz unter Verwendung von SiteMerging.yml: Diese Methode verwendet das SiteRootFolder-Element des Präfixsatzes der Site und verringert die Wahrscheinlichkeit, den falschen Ordner anzusteuern, wenn Sie exportieren, importieren, zusammenführen oder hinzufügen.

Wenn Sie keine zentrale Dateifreigabemethode verwenden, führen Sie den Import, das Zusammenführen oder das Hinzufügen von den einzelnen Delivery Controllern aus durch. Erstellen und replizieren Sie die Datei SiteMerging.yml auf jedem Delivery Controller, der in die Cloud migriert wird. Der Standardspeicherort ist %HOMEPATH%\Documents\Citrix\AutoConfig. Sie müssen den Parameter –SiteName angeben, um die richtigen Site-Präfixe auszuwählen.

Direkte Dateifreigabe

Die Export-, Import-, Zusammenführungs- und Neu-/Hinzufügevorgänge bieten einen Parameter, um einen anderen Ordner als den Standardordner %HOMEPATH%\Documents\Citrix\AutoConfig als Ziel oder Quelle anzugeben. Die folgenden Beispiele verwenden eine zentrale Dateifreigabe unter \\share.central.net, auf die der Administrator bereits Zugriff hat, nachdem die erforderlichen Anmeldeinformationen bereitgestellt wurden.

Um den Export in einen standortspezifischen Ordner zu leiten, verwenden Sie den Parameter –TargetFolder:

Vom East Delivery Controller™:

mkdir \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast

Vom West Delivery Controller:

mkdir \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest

Nachdem die Exporte abgeschlossen sind, erstellen Sie die Dateien CustomerInfo.yml und SiteMerging.yml und legen Sie sie in \\share.central.net\AutoConfig ab.

Hinweis:

Verwenden Sie den Parameter SiteRootFolder nicht beim Erstellen der SitePrefixes.yml, wenn Sie diese Methode der direkten Dateifreigabereferenz verwenden.

Um aus der direkten Dateifreigabe zu importieren, zusammenzuführen oder hinzuzufügen, müssen Sie entscheiden, von welchem Computer aus Sie den Cloud-Zugriffsvorgang durchführen möchten. Optionen umfassen:

  • Einer der lokalen Delivery Controller, auf dem das Tool bereits installiert ist.
  • Der Computer, der die Dateifreigabe hostet.
  • Ein anderer Computer.

Automated Configuration muss auf dem Computer installiert sein, der auf die Cloud zugreift. Weder das lokale PowerShell SDK, der Delivery Controller noch Active Directory werden verwendet, daher sind die Anforderungen an die Ausführung des Cloud-Zugriffs einfacher als die Exportanforderungen.

Zum Zusammenführen des East Delivery Controllers mit der Cloud:

Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Zum Zusammenführen des West Delivery Controllers mit der Cloud:

Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Im Folgenden finden Sie eine Beispiel-SitePrefixes.yml-Datei, die im vorherigen Beispiel verwendet wurde.

        East:
          SiteRootFolder: "" # Important: leave this empty
          AdminScopePrefix: "East_"
          AdminRolePrefix: "East_"
          ApplicationAdminPrefix: "East_"
          ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
          ApplicationFolderRoot: "East"
          ApplicationGroupPrefix: "East_"
          ApplicationUserPrefix: "East_"
          DeliveryGroupPrefix: "East_"
          GroupPolicyPrefix: "East_"
          HostConnectionPrefix: "East_"
          MachineCatalogPrefix: "East_"
          StoreFrontPrefix: "East_"
          TagPrefix: "East_"
          AdminScopeSuffix: "_east"
          AdminRoleSuffix: "_east"
          ApplicationAdminSuffix: "_east"
          ApplicationFolderSuffix: "_east"
          ApplicationGroupSuffix: "_east"
          ApplicationUserSuffix: "_east"
          DeliveryGroupSuffix: "_east"
          GroupPolicySuffix: "_east"
          HostConnectionSuffix: "_east"
          MachineCatalogSuffix: "_east"
          StoreFrontSuffix: "_east"
          TagSuffix: "_east"
        West:
          SiteRootFolder: "" # Important: leave this empty
          AdminScopePrefix: "Western "
          AdminRolePrefix: "Western "
          ApplicationAdminPrefix: "Western "
          ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
          ApplicationFolderRoot: "Western"
          ApplicationGroupPrefix: "Western "
          ApplicationUserPrefix: "Western "
          DeliveryGroupPrefix: "Western "
          GroupPolicyPrefix: "Western "
          HostConnectionPrefix: "Western "
          MachineCatalogPrefix: "Western "
          StoreFrontPrefix: "Western "
          TagPrefix: "Western "
          AdminScopeSuffix: ""
          AdminRoleSuffix: ""
          ApplicationAdminSuffix: ""
          ApplicationFolderSuffix: ""
          ApplicationGroupSuffix: ""
          ApplicationUserSuffix: ""
          DeliveryGroupSuffix: ""
          GroupPolicySuffix: ""
          HostConnectionSuffix: ""
          MachineCatalogSuffix: ""
          StoreFrontSuffix: ""
          TagSuffix: ""
<!--NeedCopy-->

Dateifreigabereferenz unter Verwendung von SiteMerging.yml

Diese Methode verwendet das SiteRootFolder-Element der Präfixe-Sammlung des Standorts. Obwohl aufwendiger als die direkte Dateifreigabemethode, verringert diese Methode die Wahrscheinlichkeit, den falschen Ordner beim Exportieren, Importieren, Zusammenführen oder Hinzufügen anzusteuern.

Legen Sie zunächst das SiteRootFolder für jeden Standort in der Datei SiteMerging.yml fest. Dies müssen Sie am freigegebenen Speicherort tun.

New-CvadAcSiteMergingInfo –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -SitePrefixesFolder \\share.central.net\AutoConfig

New-CvadAcSiteMergingInfo –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder \\share.central.net\AutoConfig

In diesem Beispiel ist East eine vollständig qualifizierte Ordnerspezifikation und West eine relative Ordnerspezifikation.

Um den Export in einen standortspezifischen Ordner unter Verwendung der Datei SiteMerging.yml zu leiten:

Vom East Delivery Controller:

mkdir \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Vom West Delivery Controller:

mkdir \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Das Export-Cmdlet verwendet den Ordnerspeicherort CustomerInfo.yml, um die Datei SiteMerging.yml zu finden. Im Fall von East ist SiteRootFolder vollständig qualifiziert. Es wird unverändert verwendet. Im Fall von West ist SiteRootFolder nicht vollständig qualifiziert. Es wird mit dem Ordnerspeicherort CustomerInfo.yml kombiniert, um einen vollständig qualifizierten Ordnerspeicherort für West abzurufen.

So führen Sie den East Delivery Controller mit der Cloud zusammen:

Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

So führen Sie den West Delivery Controller mit der Cloud zusammen:

Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml

Im Folgenden finden Sie eine Beispiel-Datei SitePrefixes.yml, die im vorherigen Beispiel verwendet wurde.

          East:
          SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
          AdminScopePrefix: "East_"
          AdminRolePrefix: "East_"
          ApplicationAdminPrefix: "East_"
          ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
          ApplicationFolderRoot: "East"
          ApplicationGroupPrefix: "East_"
          ApplicationUserPrefix: "East_"
          DeliveryGroupPrefix: "East_"
          GroupPolicyPrefix: "East_"
          HostConnectionPrefix: "East_"
          MachineCatalogPrefix: "East_"
          StoreFrontPrefix: "East_"
          TagPrefix: "East_"
          AdminScopeSuffix: "_east"
          AdminRoleSuffix: "_east"
          ApplicationAdminSuffix: "_east"
          ApplicationFolderSuffix: "_east"
          ApplicationGroupSuffix: "_east"
          ApplicationUserSuffix: "_east"
          DeliveryGroupSuffix: "_east"
          GroupPolicySuffix: "_east"
          HostConnectionSuffix: "_east"
          MachineCatalogSuffix: "_east"
          StoreFrontSuffix: "_east"
          TagSuffix: "_east"
        West:
          SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteWest"
          AdminScopePrefix: "Western "
          AdminRolePrefix: "Western "
          ApplicationAdminPrefix: "Western "
          ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
          ApplicationFolderRoot: "Western"
          ApplicationGroupPrefix: "Western "
          ApplicationUserPrefix: "Western "
          DeliveryGroupPrefix: "Western "
          GroupPolicyPrefix: "Western "
          HostConnectionPrefix: "Western "
          MachineCatalogPrefix: "Western "
          StoreFrontPrefix: "Western "
          TagPrefix: "Western "
          AdminScopeSuffix: ""
          AdminRoleSuffix: ""
          ApplicationAdminSuffix: ""
          ApplicationFolderSuffix: ""
          ApplicationGroupSuffix: ""
          ApplicationUserSuffix: ""
          DeliveryGroupSuffix: ""
          GroupPolicySuffix: ""
          HostConnectionSuffix: ""
          MachineCatalogSuffix: ""
          StoreFrontSuffix: ""
          TagSuffix: ""
<!--NeedCopy-->

Wenn keine zentrale Dateifreigabemethode verwendet wird und der Import, das Zusammenführen oder das Hinzufügen von den einzelnen Delivery Controllern aus erfolgt, erstellen und replizieren Sie die Datei SiteMerging.yml auf jedem Delivery Controller, der in die Cloud migriert wird. Der Standardspeicherort ist %HOMEPATH%\Documents\Citrix\AutoConfig. Sie müssen den Parameter –SiteName angeben, um die richtigen Site-Präfixe auszuwählen.

Sites zusammenführen

Citrix® empfiehlt, die Cloud-Vorgänge schrittweise durchzuführen und jedes Ergebnis vollständig zu überprüfen, bevor der nächste Cloud-Vorgang ausgeführt wird. Beispiel: Wenn Sie drei Sites zu einer einzigen Cloud-Site zusammenführen:

  1. Führen Sie die ursprüngliche Site mit der Cloud zusammen, indem Sie den entsprechenden Wert SiteName verwenden.
  2. Überprüfen Sie die Ergebnisse in Studio.
  3. Wenn die Ergebnisse falsch sind, ermitteln Sie das Problem und seine Ursache, beheben Sie es und führen Sie die Zusammenführung dann erneut aus. Entfernen Sie bei Bedarf die Cloud-Komponenten und beginnen Sie von vorne, indem Sie Remove-CvadAcFromSite für die ausgewählte Komponente und die Mitglieder verwenden. Wenn die Ergebnisse korrekt sind, fahren Sie fort.
  4. Wenn die anfängliche Zusammenführung korrekt ist, führen Sie die zweite Site mit der einzelnen Cloud-Site zusammen.
  5. Wiederholen Sie die Schritte 2 und 3.
  6. Wenn die zweite Zusammenführung korrekt ist, führen Sie die dritte Site mit der einzelnen Cloud-Site zusammen.
  7. Wiederholen Sie die Schritte 2 und 3.
  8. Überprüfen Sie die Ressourcen aus der Benutzerperspektive und stellen Sie sicher, dass die Ansicht den gewünschten Zustand aufweist.

Komponente mithilfe des Site-Präfixes entfernen

Sie können einzelne Site-Komponenten selektiv entfernen, indem Sie das Präfix für den –IncludeByName-Parameter des Remove-CvadAcFromSite-Cmdlets verwenden. Im folgenden Beispiel sind die Delivery Controller-Bereitstellungsgruppen für West nicht korrekt. So entfernen Sie die Bereitstellungsgruppen nur für die West-Site:

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Um alle West-Komponenten zu entfernen, führen Sie die folgenden Cmdlets der Reihe nach aus.

  1. Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”

  2. Remove-CvadAcFromSite –Applications –IncludeByName “Western *”

  3. Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”

  4. Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

  5. Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”

  6. Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”

  7. Remove-CvadAcFromSite –Tags –IncludeByName “Western *”

Zum Entfernen der Gruppenrichtlinien der East-Komponenten verwenden Sie das Suffix:

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

Zusammenführen mehrerer Sites zu einer einzigen Site
June 5, 2026
Beitrag von: 
C
June 5, 2026
Beitrag von: 
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.