Fusionar varios sitios en un único sitio

May 31, 2026

Contribución de:

La compatibilidad multisitio para la 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 que varios sitios locales se fusionen en un único sitio en la nube.

Se pueden asignar prefijos y sufijos para 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 prefijos, sufijos y reubicación. La reubicación añade 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 añade 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 tendrán el prefijo “East”.
Si el nombre de un componente ya comienza con el prefijo o el sufijo, no se añade ningún prefijo ni sufijo. Los nombres de los componentes no pueden contener prefijos o sufijos idénticos dobles.
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

Utilice prefijos para agrupar visualmente los componentes de un único sitio. Cada sitio se muestra en su propio grupo, y los prefijos controlan alfabéticamente el orden de los diferentes grupos de sitios.

Agrupar componentes por nombre

Utilice 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 asignació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 central de recursos compartidos de archivos. El archivo SiteMerging.yml, el archivo CustomerInfo.yml y todos los archivos de exportación residen en esa ubicación de recursos compartidos 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 o a Active Directory, lo que le permite realizar operaciones de acceso a la nube desde cualquier lugar.

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, fusión o 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 como destino u origen una carpeta distinta 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, utilice el parámetro –TargetFolder:

Desde el Delivery Controller™ Este:

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

Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast

Desde el Delivery Controller Oeste:

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

Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest

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

Nota:

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

Para importar, fusionar o añadir 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.

Automated Configuration debe estar instalado en la máquina que accede a la nube. No se utilizan el SDK de PowerShell local, el Delivery Controller ni Active Directory, por lo que los requisitos de ejecución del acceso a la nube son más sencillos que los requisitos de exportación.

Para fusionar el Delivery Controller Este con la nube:

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

Para fusionar el Delivery Controller Oeste con la nube:

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

El siguiente es 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, establezca el SiteRootFolder para cada sitio en el archivo SiteMerging.yml. Debe 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, Este es una especificación de carpeta completa y Oeste es una especificación de carpeta relativa.

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

Desde el Delivery Controller Este:

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

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

Desde el Delivery Controller Oeste:

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 Este, el SiteRootFolder está completamente cualificado. Se utiliza tal cual. En el caso de Oeste, el SiteRootFolder no está completamente cualificado. Se combina con la ubicación de la carpeta CustomerInfo.yml para recuperar una ubicación de carpeta completamente cualificada para Oeste.

Para fusionar el Delivery Controller Este con la nube:

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

Para fusionar el Delivery Controller Oeste con la nube:

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

El siguiente es 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, 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.

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 se fusionan tres sitios en un único sitio en la nube:

Fusionar el sitio inicial con la nube utilizando el valor SiteName adecuado.
Revise los resultados en Studio.
Si los resultados son incorrectos, determine el problema y su causa, corríjalo y, a continuación, vuelva a ejecutar la fusión. Si es necesario, elimine los componentes de la nube y empiece de cero utilizando Remove-CvadAcFromSite para el componente y los miembros seleccionados. Si los resultados son correctos, continúe.
Si la fusión inicial es correcta, fusione el segundo sitio con el sitio único en la nube.
Repita los pasos 2 y 3.
Si la segunda fusión es correcta, fusione el tercer sitio con el sitio único en la nube.
Repita los pasos 2 y 3.
Revise los recursos desde la perspectiva del usuario y verifique que la vista esté en el estado deseado.

Eliminar un componente mediante el prefijo del sitio

Puede eliminar 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 de West Delivery Controller no son correctos. Para eliminar los grupos de entrega solo para el sitio West:

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Para eliminar todos los componentes de West, ejecute 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 eliminar las directivas de grupo de los componentes de East, utilice el sufijo:

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

La documentación oficial de este producto está en inglés. Las versiones en otros idiomas se ofrecen solo como referencia y pueden incluir contenido traducido de forma automática. Para obtener más información, consulte la cláusula de exención de responsabilidad sobre traducción automática en Cloud Software Group home.

¿Le ha resultado útil?

Fusionar varios sitios en un único sitio

May 31, 2026

Contribución de:

May 31, 2026

Contribución de:

En este artículo

Reglas de prefijos y sufijos
Exportar sitio local
Fusionar los sitios
Eliminar un componente mediante el prefijo del sitio

¿Le ha resultado útil?