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

Zusammenführen mehrerer Sites zu einer einzigen Site

April 6, 2026
Beitrag von: 
C C

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

  • Die Unterstützung mehrerer Sites fügt eindeutige Präfixe und Suffixe zu Komponentennamen pro lokaler Site hinzu, wodurch die Eindeutigkeit der Namen gewährleistet wird, 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 (Rerooting). 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 Leerzeichen enthalten, aber keine vorangestellten Leerzeichen.
  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 Maschinenkatalognamen 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 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.

Zuordnungsdatei für Präfixe und Suffixe

Die Site-Präfixbildung beginnt mit der Datei SiteMerging.yml, die die Site-Präfix- und Suffixzuordnung 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

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 Mitglied SiteRootFolder 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. 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 anzugeben. 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 sitespezifischen 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

Nach Abschluss der Exporte 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-Datei, 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, Delivery Controller noch Active Directory werden verwendet, sodass die Anforderungen an die Ausführung des Cloud-Zugriffs 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

Es folgt eine Beispiel-Datei SitePrefixes.yml, 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-->

Dateifreigabe-Referenz mithilfe von SiteMerging.yml

Diese Methode verwendet das Mitglied SiteRootFolder des Präfix-Satzes der Site. Obwohl diese Methode aufwendiger ist als die direkte Dateifreigabe-Methode, reduziert sie die Wahrscheinlichkeit, beim Exportieren, Importieren, Zusammenführen oder Hinzufügen den falschen Ordner anzusteuern.

Legen Sie zunächst den 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 zielen Sie den Export auf einen sitespezifischen Ordner mithilfe der Datei SiteMerging.yml ab:

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 von 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 von 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 Dateifreigabe-Methode 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 korrekten Site-Präfixe auszuwählen.

Sites zusammenführen

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

  1. Führen Sie die ursprüngliche Site mithilfe des entsprechenden SiteName-Werts mit der Cloud zusammen.
  2. Überprüfen Sie die Ergebnisse in Studio.
  3. Wenn die Ergebnisse falsch sind, ermitteln Sie das Problem und dessen 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 ursprü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 Perspektive des Benutzers und vergewissern Sie sich, dass die Ansicht dem gewünschten Zustand entspricht.

Eine Komponente mithilfe des Site-Präfixes entfernen

Sie können einzelne Site-Komponenten selektiv entfernen, indem Sie das Präfix im Parameter –IncludeByName des Cmdlets Remove-CvadAcFromSite verwenden. Im folgenden Beispiel sind die Bereitstellungsgruppen des West Delivery Controllers 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
April 6, 2026
Beitrag von: 
C C
April 6, 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.