Citrix Virtual Apps and Desktops

Fusionar varios sitios en un único sitio

April 6, 2026

Contribución de:

C C

La compatibilidad multisitio para Configuración automatizada proporciona un método para fusionar varios sitios locales en un único sitio en la nube.

La compatibilidad multisitio agrega prefijos y sufijos únicos a los nombres de los componentes por cada sitio local, lo que garantiza la unicidad de los nombres después de fusionar varios sitios locales en un único sitio en la nube.
Se pueden asignar prefijos y sufijos a cada uno de los siguientes componentes por cada sitio local.
AdminScope
AdminRole
ApplicationAdmin
ApplicationFolder
ApplicationGroup
ApplicationUser
DeliveryGroup
GroupPolicy
HostConnection
MachineCatalog
StoreFront™
Tag

Las carpetas de aplicaciones admiten la adición de prefijos, sufijos y el cambio de raíz. El cambio de raíz agrega una carpeta de nivel superior adicional a la estructura de carpetas existente de una aplicación.

Reglas de prefijos y sufijos

Los prefijos y sufijos no pueden contener ninguno de los siguientes caracteres especiales: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
Los prefijos y sufijos pueden contener espacios finales, pero no espacios iniciales.
Los prefijos y sufijos deben ir entre comillas dobles para contener espacios finales.
Los prefijos y sufijos se aplican en el momento de la importación, la fusión y la adición. Los archivos .yml de origen nunca se modifican.
El proceso de prefijos y sufijos agrega automáticamente prefijos o sufijos a los nombres de los componentes dependientes cuando corresponde. Por ejemplo, si los nombres de los catálogos de máquinas tienen el prefijo “East”, los grupos de entrega que los referencian también tienen el prefijo “East”.
Si el nombre de un componente ya comienza con el prefijo o sufijo, no se agrega ningún prefijo ni sufijo. Los nombres de los componentes no pueden contener prefijos o sufijos dobles idénticos.
Los prefijos y sufijos se pueden usar individualmente o en combinación.
El uso de un prefijo o un sufijo en un componente es opcional.

Nota:

Studio muestra los componentes en orden alfabético.

Agrupar componentes por sitio

Use prefijos para agrupar visualmente los componentes de un único sitio. Cada sitio se enumera en su propio grupo, y la adición de prefijos controla alfabéticamente el orden de los diferentes grupos de sitios.

Agrupar componentes por nombre

Use sufijos para agrupar visualmente componentes con nombres similares de varios sitios. Los componentes con nombres similares de diferentes sitios se alternan visualmente.

Archivo de asignación de prefijos y sufijos

La adición de prefijos de sitio comienza con el archivo SiteMerging.yml, que contiene la asignación de prefijos y sufijos de sitio para uno o varios sitios locales. Puede administrar el archivo SiteMerging.yml manualmente o mediante los cmdlets disponibles que se enumeran en la sección Cmdlets para fusionar varios sitios locales.

Exportar sitio local

La fusión no puede comenzar hasta que haya exportado un sitio local. Para exportar un sitio local, consulte Exportar configuración local.

Carpeta de destino de exportación central

Los métodos descritos en esta sección colocan varias exportaciones de sitios en una ubicación de recurso compartido de archivos central. El archivo SiteMerging.yml, el archivo CustomerInfo.yml y todos los archivos de exportación residen en esa ubicación de recurso compartido de archivos, lo que le permite realizar la importación desde una ubicación independiente de los sitios locales.

Las operaciones de acceso a la nube nunca hacen referencia a los sitios locales ni a Active Directory, lo que le permite realizar operaciones de acceso a la nube desde cualquier lugar.

Recurso compartido de archivos directo

Hay dos métodos para hacerlo:

Recurso compartido de archivos directo: Para importar, fusionar o agregar desde el recurso compartido de archivos directo, debe decidir desde qué máquina desea realizar la operación de acceso a la nube.
Referencia de recurso compartido de archivos mediante SiteMerging.yml: Este método utiliza el miembro SiteRootFolder del conjunto de prefijos del sitio y reduce las probabilidades de seleccionar la carpeta incorrecta al exportar, importar, fusionar o agregar.

Si no utiliza un método de recurso compartido de archivos central, realice la importación, la fusión o la adición desde los Delivery Controllers individuales. Cree y replique el archivo SiteMerging.yml en cada Delivery Controller que se migre a la nube. La ubicación predeterminada es %HOMEPATH%\Documents\Citrix\AutoConfig. Debe especificar el parámetro –SiteName para seleccionar los prefijos de sitio correctos.

Recurso compartido de archivos directo

Las operaciones de exportación, importación, fusión y nueva adición proporcionan un parámetro para especificar una carpeta de destino o de origen diferente de la carpeta predeterminada, %HOMEPATH%\Documents\Citrix\AutoConfig. Los siguientes ejemplos utilizan un recurso compartido de archivos central ubicado en \\share.central.net al que el administrador ya tiene acceso, habiendo proporcionado las credenciales según sea necesario.

Para dirigir la exportación a una carpeta específica del sitio, use el parámetro –TargetFolder:

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

Desde el Delivery Controller™ de East:

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

[[CODE_BLOCK_2]]

Desde el Delivery Controller de West:

[[CODE_BLOCK_3]]

[[CODE_BLOCK_4]]

Una vez completadas las exportaciones, cree los archivos CustomerInfo.yml y SiteMerging.yml y colóquelos en \\share.central.net\AutoConfig.

Nota:

No use el parámetro SiteRootFolder al crear SitePrefixes.yml cuando utilice este método de referencia directa de recurso compartido de archivos.

Para importar, fusionar o agregar desde el recurso compartido de archivos directo, debe decidir desde qué máquina desea realizar la operación de acceso a la nube. Las opciones incluyen:

Uno de los Delivery Controllers locales donde la herramienta ya está instalada.
La máquina que aloja el recurso compartido de archivos.
Una máquina diferente.

Configuración automatizada debe instalarse en la máquina que accede a la nube. No se utilizan el SDK de PowerShell local, los Delivery Controllers ni Active Directory, por lo que los requisitos de ejecución de acceso a la nube son más sencillos que los requisitos de exportación.

Para fusionar los Delivery Controllers de East en la nube:

[[CODE_BLOCK_5]]

Para fusionar los Delivery Controllers de West en la nube:

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

A continuación se muestra un archivo SitePrefixes.yml de ejemplo utilizado en el ejemplo anterior.

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

Referencia de recurso compartido de archivos mediante SiteMerging.yml

Este método utiliza el miembro SiteRootFolder del conjunto de prefijos del sitio. Aunque es más complejo que el método directo de recurso compartido de archivos, este método reduce las probabilidades de seleccionar la carpeta incorrecta al exportar, importar, fusionar o agregar.

Primero, establece SiteRootFolder para cada sitio en el archivo SiteMerging.yml. Debes hacerlo en la ubicación compartida.

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

En este ejemplo, East es una especificación de carpeta completa y West es una especificación de carpeta relativa.

Para dirigir la exportación a una carpeta específica del sitio utilizando el archivo SiteMerging.yml:

Desde el Delivery Controller de East:

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

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

Desde el Delivery Controller de West:

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

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

El cmdlet de exportación utiliza la ubicación de la carpeta CustomerInfo.yml para localizar el archivo SiteMerging.yml. En el caso de East, SiteRootFolder está completamente calificado. Se utiliza tal cual. En el caso de West, SiteRootFolder no está completamente calificado. Se combina con la ubicación de la carpeta CustomerInfo.yml para recuperar una ubicación de carpeta completamente calificada para West.

Para fusionar el Delivery Controller de East con la nube:

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

Para fusionar el Delivery Controller de West con la nube:

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

A continuación se muestra un archivo SitePrefixes.yml de ejemplo utilizado en el ejemplo anterior.

          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 no se utiliza un método de recurso compartido de archivos central y la importación, fusión o adición se realiza desde los Delivery Controllers individuales, entonces crea y replica el archivo SiteMerging.yml en cada Delivery Controller que se migre a la nube. La ubicación predeterminada es %HOMEPATH%\Documents\Citrix\AutoConfig. Debes especificar el parámetro –SiteName para seleccionar los prefijos de sitio correctos.

Fusionar los sitios

Citrix® recomienda realizar las operaciones en la nube por pasos y hacer una revisión completa de cada resultado antes de realizar la siguiente operación en la nube. Por ejemplo, si fusionas tres sitios en un único sitio en la nube:

Fusiona el sitio inicial con la nube utilizando el valor SiteName apropiado.
Revisa los resultados en Studio.
Si los resultados son incorrectos, determina el problema y su causa, corrígelo y luego vuelve a ejecutar la fusión. Si es necesario, quita los componentes de la nube y empieza de cero utilizando Remove-CvadAcFromSite para el componente y los miembros seleccionados. Si los resultados son correctos, continúa.
Si la fusión inicial es correcta, fusiona el segundo sitio con el único sitio en la nube.
Repite los pasos 2 y 3.
Si la segunda fusión es correcta, fusiona el tercer sitio con el único sitio en la nube.
Repite los pasos 2 y 3.
Revisa los recursos desde la perspectiva del usuario y verifica que la vista esté en el estado deseado.

Quitar un componente utilizando el prefijo del sitio

Puedes quitar selectivamente componentes de un solo sitio utilizando el prefijo en el parámetro –IncludeByName del cmdlet Remove-CvadAcFromSite. En el siguiente ejemplo, los grupos de entrega del Delivery Controller de West no son correctos. Para quitar los grupos de entrega solo para el sitio de West:

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Para quitar todos los componentes de West, ejecuta los siguientes cmdlets en orden.

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

Para quitar las directivas de grupo de los componentes de East, utiliza el sufijo:

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Cloud Software Group solo tiene traducción automática. Cloud Software Group no puede controlar el contenido con traducción automática, que puede contener errores, imprecisiones o un lenguaje inadecuado. No se ofrece ninguna garantía, ni implícita ni explícita, en cuanto a la exactitud, la fiabilidad, la idoneidad o la precisión de las traducciones realizadas del original en inglés a cualquier otro idioma, o que su producto o servicio de Cloud Software Group se ajusten a cualquier contenido con traducción automática, y cualquier garantía provista bajo el contrato de licencia del usuario final o las condiciones de servicio, o cualquier otro contrato con Cloud Software Group, de que el producto o el servicio se ajusten a la documentación no se aplicará en cuanto dicha documentación se ha traducido automáticamente. Cloud Software Group no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

¿Le ha resultado útil?

Fusionar varios sitios en un único sitio

April 6, 2026

Contribución de:

C C

April 6, 2026

Contribución de:

C C

En este artículo

Reglas de prefijos y sufijos
Exportar sitio local
Recurso compartido de archivos directo
Fusionar los sitios
Quitar un componente utilizando el prefijo del sitio

¿Le ha resultado útil?

Fusionar varios sitios en un único sitio

Reglas de prefijos y sufijos

Agrupar componentes por sitio

Agrupar componentes por nombre

Archivo de asignación de prefijos y sufijos

Exportar sitio local

Carpeta de destino de exportación central

Recurso compartido de archivos directo

Recurso compartido de archivos directo

Referencia de recurso compartido de archivos mediante SiteMerging.yml

Fusionar los sitios

Quitar un componente utilizando el prefijo del sitio

En este artículo