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 Automated Configuration bietet eine Methode zum Zusammenführen mehrerer lokaler Sites zu einer einzigen Cloud-Site.

Die Multi-Site-Unterstützung 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 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 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 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 versieht abhängige Komponentennamen, sofern zutreffend, automatisch mit einem Präfix oder Suffix. Wenn beispielsweise Maschinenkataloge mit „East“ versehen werden, erhalten auch die darauf verweisenden Bereitstellungsgruppen 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 alphabetische Präfixierung die Reihenfolge der verschiedenen Site-Gruppen steuert.

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 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.
  • Dateifreigabereferenz mit SiteMerging.yml: Diese Methode verwendet das Mitglied SiteRootFolder 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 korrekten 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 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 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, 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

Das Folgende ist 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 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. Wenn Sie beispielsweise 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. 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.