Citrix Virtual Apps and Desktops

Fusion de plusieurs sites en un seul site

April 8, 2026

Contributeur:

C C

La prise en charge multisite pour la configuration automatisée offre une méthode pour fusionner plusieurs sites sur site en un seul site cloud.

La prise en charge multisite ajoute des préfixes et des suffixes uniques aux noms de composants par site sur site, garantissant l’unicité des noms après la fusion de plusieurs sites sur site en un seul site cloud.
Des préfixes et des suffixes peuvent être attribués pour chacun des composants suivants, par site sur site.
AdminScope
AdminRole
ApplicationAdmin
ApplicationFolder
ApplicationGroup
ApplicationUser
DeliveryGroup
GroupPolicy
HostConnection
MachineCatalog
StoreFront™
Tag

Les dossiers d’applications prennent en charge l’ajout de préfixes, de suffixes et la redéfinition de la racine. La redéfinition de la racine ajoute un dossier de niveau supérieur supplémentaire à la structure de dossiers existante d’une application.

Règles d’ajout de préfixes et de suffixes

Les préfixes et les suffixes ne peuvent pas contenir les caractères spéciaux suivants : \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
Les préfixes et les suffixes peuvent contenir des espaces de fin, mais pas des espaces de début.
Les préfixes et les suffixes doivent être placés entre guillemets doubles pour contenir des espaces de fin.
Les préfixes et les suffixes sont appliqués au moment de l’importation, de la fusion et de l’ajout. Les fichiers .yml source ne sont jamais modifiés.
Le processus d’ajout de préfixes et de suffixes ajoute automatiquement des préfixes ou des suffixes aux noms de composants dépendants, le cas échéant. Par exemple, si les noms de catalogues de machines sont préfixés par « East », les groupes de mise à disposition qui y font référence sont également préfixés par « East ».
Si un nom de composant commence déjà par le préfixe ou le suffixe, aucun préfixe ou suffixe n’est ajouté. Les noms de composants ne peuvent pas contenir de préfixes ou de suffixes doubles identiques.
Les préfixes et les suffixes peuvent être utilisés individuellement ou en combinaison.
L’utilisation d’un préfixe ou d’un suffixe sur un composant est facultative.

Remarque :

Studio affiche les composants par ordre alphabétique.

Regrouper les composants par site

Utilisez l’ajout de préfixes pour regrouper visuellement les composants d’un même site. Chaque site est répertorié dans son propre groupe, l’ajout de préfixes contrôlant alphabétiquement l’ordre des différents groupes de sites.

Regrouper les composants par nom

Utilisez l’ajout de suffixes pour regrouper visuellement les composants de noms similaires provenant de plusieurs sites. Les composants de noms similaires provenant de différents sites alternent visuellement.

Fichier de mappage de préfixes et de suffixes

L’ajout de préfixes de site commence par le fichier SiteMerging.yml qui contient le mappage de préfixes et de suffixes de site pour un ou plusieurs sites sur site. Vous pouvez gérer le fichier SiteMerging.yml manuellement ou en utilisant les cmdlets disponibles répertoriées dans la section Cmdlets de fusion de plusieurs sites sur site.

Exporter un site sur site

La fusion ne peut pas commencer tant que vous n’avez pas exporté un site sur site. Pour exporter un site sur site, consultez Exporter la configuration sur site.

Dossier cible d’exportation central

Les méthodes décrites dans cette section placent plusieurs exportations de sites dans un emplacement de partage de fichiers central. Le fichier SiteMerging.yml, le fichier CustomerInfo.yml et tous les fichiers d’exportation résident dans cet emplacement de partage de fichiers, ce qui vous permet d’effectuer l’importation à partir d’un seul emplacement, indépendamment des sites sur site.

Les opérations d’accès au cloud ne référencent jamais les sites sur site ou Active Directory, ce qui vous permet d’effectuer des opérations d’accès au cloud depuis n’importe où.

Partage de fichiers direct

Il existe deux méthodes pour ce faire :

Partage de fichiers direct : Pour importer, fusionner ou ajouter à partir du partage de fichiers direct, vous devez décider à partir de quelle machine vous souhaitez effectuer l’opération d’accès au cloud.
Référence de partage de fichiers à l’aide de SiteMerging.yml : Cette méthode utilise le membre SiteRootFolder de l’ensemble de préfixes du site et réduit les risques de cibler le mauvais dossier lors de l’exportation, de l’importation, de la fusion ou de l’ajout.

Si vous n’utilisez pas de méthode de partage de fichiers central, effectuez l’importation, la fusion ou l’ajout à partir des Delivery Controllers individuels. Créez et répliquez le fichier SiteMerging.yml sur chaque Delivery Controller migré vers le cloud. L’emplacement par défaut est %HOMEPATH%\Documents\Citrix\AutoConfig. Vous devez spécifier le paramètre –SiteName pour sélectionner les préfixes de site corrects.

Partage de fichiers direct

Les opérations d’exportation, d’importation, de fusion et de création/ajout fournissent un paramètre pour cibler ou sourcer un dossier autre que le dossier par défaut, %HOMEPATH%\Documents\Citrix\AutoConfig. Les exemples suivants utilisent un partage de fichiers central situé à \\share.central.net auquel l’administrateur a déjà accès, après avoir fourni les informations d’identification nécessaires.

Pour cibler l’exportation vers un dossier spécifique au site, utilisez le paramètre –TargetFolder :

À partir du Delivery Controller™ Est ::

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

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

À partir du Delivery Controller Ouest ::

[[CODE_BLOCK_2]]

[[CODE_BLOCK_3]]

Une fois les exportations terminées, créez les fichiers CustomerInfo.yml et SiteMerging.yml et placez-les dans \\share.central.net\AutoConfig.

Remarque :

N’utilisez pas le paramètre SiteRootFolder lors de la création du fichier SitePrefixes.yml lorsque vous utilisez cette méthode de référence de partage de fichiers direct.

Pour importer, fusionner ou ajouter à partir du partage de fichiers direct, vous devez décider à partir de quelle machine vous souhaitez effectuer l’opération d’accès au cloud. Les options incluent :

L’un des Delivery Controllers sur site où l’outil est déjà installé.
La machine hébergeant le partage de fichiers.
Une machine différente.

La configuration automatisée doit être installée sur la machine accédant au cloud. Ni le SDK PowerShell sur site, ni les Delivery Controllers, ni Active Directory ne sont utilisés, de sorte que les exigences d’exécution de l’accès au cloud sont plus simples que les exigences d’exportation.

Pour fusionner les Delivery Controllers Est vers le cloud :

[[CODE_BLOCK_4]]

Pour fusionner les Delivery Controllers Ouest vers le cloud :

[[CODE_BLOCK_5]]

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

Voici un exemple de fichier SitePrefixes.yml utilisé dans l’exemple précédent.

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

Référence de partage de fichiers à l’aide de SiteMerging.yml

Cette méthode utilise le membre SiteRootFolder de l’ensemble des préfixes du site. Bien que plus complexe que la méthode de partage de fichiers directe, cette méthode réduit les risques de cibler le mauvais dossier lors de l’exportation, de l’importation, de la fusion ou de l’ajout.

Tout d’abord, définissez le SiteRootFolder pour chaque site dans le fichier SiteMerging.yml. Vous devez effectuer cette opération sur l’emplacement partagé.

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

Dans cet exemple, East est une spécification de dossier entièrement qualifiée et West est une spécification de dossier relative.

Pour cibler l’exportation vers un dossier spécifique au site à l’aide du fichier SiteMerging.yml :

À partir du Delivery Controller East :

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

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

À partir du Delivery Controller West :

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

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

L’applet de commande d’exportation utilise l’emplacement du dossier CustomerInfo.yml pour localiser le fichier SiteMerging.yml. Dans le cas de East, le SiteRootFolder est entièrement qualifié. Il est utilisé tel quel. Dans le cas de West, le SiteRootFolder n’est pas entièrement qualifié. Il est combiné avec l’emplacement du dossier CustomerInfo.yml pour récupérer un emplacement de dossier entièrement qualifié pour West.

Pour fusionner le Delivery Controller East vers le cloud :

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

Pour fusionner le Delivery Controller West vers le cloud :

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

Voici un exemple de fichier SitePrefixes.yml utilisé dans l’exemple précédent.

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

Si une méthode de partage de fichiers centralisée n’est pas utilisée et que l’importation, la fusion ou l’ajout est effectué à partir des Delivery Controllers individuels, créez et répliquez le fichier SiteMerging.yml sur chaque Delivery Controller migré vers le cloud. L’emplacement par défaut est %HOMEPATH%\Documents\Citrix\AutoConfig. Vous devez spécifier le paramètre –SiteName pour sélectionner les préfixes de site corrects.

Fusionner les sites

Citrix® recommande d’effectuer les opérations cloud par étapes et de procéder à un examen complet de chaque résultat avant de passer à l’opération cloud suivante. Par exemple, si vous fusionnez trois sites en un seul site cloud :

Fusionnez le site initial avec le cloud en utilisant la valeur SiteName appropriée.
Examinez les résultats dans Studio.
Si les résultats sont incorrects, déterminez le problème et sa cause, corrigez-le, puis relancez la fusion. Si nécessaire, supprimez les composants cloud et recommencez à zéro en utilisant Remove-CvadAcFromSite pour le composant et les membres sélectionnés. Si les résultats sont corrects, continuez.
Si la fusion initiale est correcte, fusionnez le deuxième site avec le site cloud unique.
Répétez les étapes 2 et 3.
Si la deuxième fusion est correcte, fusionnez le troisième site avec le site cloud unique.
Répétez les étapes 2 et 3.
Examinez les ressources du point de vue de l’utilisateur et vérifiez que la vue est dans l’état souhaité.

Supprimer un composant à l’aide du préfixe de site

Vous pouvez supprimer sélectivement des composants de site individuels en utilisant le préfixe sur le paramètre –IncludeByName de l’applet de commande Remove-CvadAcFromSite. Dans l’exemple suivant, les groupes de mise à disposition du Delivery Controller West ne sont pas corrects. Pour supprimer les groupes de mise à disposition uniquement pour le site West :

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Pour supprimer tous les composants West, exécutez les applets de commande suivantes dans l’ordre.

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”
Remove-CvadAcFromSite –Applications –IncludeByName “Western *”
Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”
Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”
Remove-CvadAcFromSite –Tags –IncludeByName “Western *”

Pour supprimer les stratégies de groupe des composants East, utilisez le suffixe :

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Cela vous a-t-il été utile ?

Fusion de plusieurs sites en un seul site

April 8, 2026

Contributeur:

C C

April 8, 2026

Contributeur:

C C

Dans cet article

Règles d’ajout de préfixes et de suffixes
Exporter un site sur site
Partage de fichiers direct
Fusionner les sites
Supprimer un composant à l’aide du préfixe de site

Cela vous a-t-il été utile ?

Fusion de plusieurs sites en un seul site

Règles d’ajout de préfixes et de suffixes

Regrouper les composants par site

Regrouper les composants par nom

Fichier de mappage de préfixes et de suffixes

Exporter un site sur site

Dossier cible d’exportation central

Partage de fichiers direct

Partage de fichiers direct

Référence de partage de fichiers à l’aide de SiteMerging.yml

Fusionner les sites

Supprimer un composant à l’aide du préfixe de site

Dans cet article