Produktdokumentation

Zusammenführen mehrerer Sites zu einer einzigen Site

June 5, 2026
Beitrag von: 
C

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

Die Unterstützung mehrerer Sites fügt den 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 Neuverankerung. Die Neuverankerung 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 keine der folgenden Sonderzeichen enthalten: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
  2. Präfixe und Suffixe können 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 beim Importieren, Zusammenführen und Hinzufügen angewendet. Die Quell-YML-Dateien werden niemals geändert.
  5. Der Präfix- und Suffixprozess fügt abhängigen Komponentennamen automatisch Präfixe oder Suffixe hinzu, sofern zutreffend. Wenn beispielsweise Maschinenkatalognamen mit „East“ versehen werden, erhalten Bereitstellungsgruppen, die auf diese verweisen, ebenfalls das 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 von 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.

Direkte Dateifreigabe

Dafür 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 verringert 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 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ü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 die Anmeldeinformationen bei Bedarf bereitgestellt wurden.

Um den Export auf einen standortspezifischen Ordner auszurichten, 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 welcher Maschine 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 werden, der auf die Cloud zugreift. Weder das lokale PowerShell SDK, die Delivery Controller noch Active Directory werden verwendet, sodass die Ausführungsanforderungen für den Cloud-Zugriff einfacher sind als die Exportanforderungen.

So führen Sie die 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 die West Delivery Controller mit der Cloud zusammen:

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

Die folgende SitePrefixes.yml-Datei ist eine Beispieldatei, 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 aufwendiger als die direkte Dateifreigabemethode, reduziert diese Methode die Wahrscheinlichkeit, den falschen Ordner beim Exportieren, Importieren, Zusammenführen oder Hinzufügen 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 aus:

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

Es folgt 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 den Merge 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 der anfängliche Merge korrekt ist, führen Sie den Merge der zweiten Site mit der einzelnen Cloud-Site durch.
  5. Wiederholen Sie die Schritte 2 und 3.
  6. Wenn der zweite Merge korrekt ist, führen Sie den Merge der dritten Site mit der einzelnen Cloud-Site durch.
  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 Parameter –IncludeByName des Cmdlets Remove-CvadAcFromSite 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 *”

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.