Produktdokumentation

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, um mehrere lokale Sites zu einer einzigen Cloud-Site zusammenzuführen.

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 das Neuverankern. Das Neuverankern fügt der vorhandenen Ordnerstruktur einer Anwendung einen zusätzlichen Ordner auf oberster 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, um nachgestellte Leerzeichen zu enthalten.
  4. Präfixe und Suffixe werden zum Zeitpunkt des Imports, des Zusammenführens und des Hinzufügens angewendet. Die Quell-.yml-Dateien werden niemals geändert.
  5. Der Präfix- und Suffixprozess versieht abhängige Komponentennamen bei Bedarf automatisch mit Präfixen oder Suffixen. Wenn beispielsweise Maschinenkatalog-Namen mit „East“ versehen werden, erhalten auch die darauf verweisenden Bereitstellungsgruppen den Präfix „East“.
  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 „Cmdlets zum Zusammenführen mehrerer lokaler Sites“ 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 „Lokale Konfiguration exportieren.“.

Zentraler Exportzielordner

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, sodass Sie Cloud-Zugriffsoperationen von überall aus durchführen können.

Dazu gibt es zwei Methoden:

  • Direkte Dateifreigabe: 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.
  • Dateifreigabereferenz mit SiteMerging.yml: Diese Methode verwendet das SiteRootFolder-Element des Präfixsatzes der Site und reduziert die Wahrscheinlichkeit, beim Exportieren, Importieren, Zusammenführen oder Hinzufügen den falschen Ordner anzusteuern.

Wenn Sie keine zentrale Dateifreigabemethode verwenden, führen Sie den Import, das Zusammenführen oder das Hinzufügen von den einzelnen Delivery Controllern aus. 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ügeoperationen bieten einen Parameter, um einen anderen Ordner als den Standardordner %HOMEPATH%\Documents\Citrix\AutoConfig als Ziel oder Quelle festzulegen. Die folgenden Beispiele verwenden eine zentrale Dateifreigabe unter \\share.central.net, auf die der Administrator bereits Zugriff hat, nachdem er bei Bedarf Anmeldeinformationen bereitgestellt hat.

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

Vom östlichen Delivery Controller™:

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

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

Vom westlichen 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 von 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. Mögliche Optionen sind:

  • 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.

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

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

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

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

Im Folgenden sehen 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 mit SiteMerging.yml

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

Legen Sie zunächst das SiteRootFolder für jede Site 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.

So richten Sie den Export mithilfe der Datei SiteMerging.yml auf einen sitespezifischen Ordner aus:

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 der SiteRootFolder vollständig qualifiziert. Er wird unverändert verwendet. Im Fall von West ist der SiteRootFolder nicht vollständig qualifiziert. Er 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 sehen 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 drei Sites zu einer einzigen Cloud-Site zusammengeführt werden sollen:

  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 dann die Zusammenführung 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.

Eine 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. Um die Bereitstellungsgruppen nur für die West-Site zu entfernen:

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 *”

Um Gruppenrichtlinien der East-Komponenten zu entfernen, 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.