Citrix Virtual Apps and Desktops

Mesclando vários sites em um único site

May 31, 2026

Contribuição de:

O suporte a múltiplos sites para a Configuração Automatizada fornece um método para mesclar vários sites locais em um único site na nuvem.

O suporte a múltiplos sites adiciona prefixos e sufixos exclusivos aos nomes dos componentes por site local, garantindo a exclusividade dos nomes depois que vários sites locais são mesclados em um único site na nuvem.

Prefixos e sufixos podem ser atribuídos para cada um dos seguintes componentes, por site local.

AdminScope
AdminRole
ApplicationAdmin
ApplicationFolder
ApplicationGroup
ApplicationUser
DeliveryGroup
GroupPolicy
HostConnection
MachineCatalog
StoreFront™
Tag

Pastas de aplicativos suportam prefixação, sufixação e redefinição de raiz. A redefinição de raiz adiciona uma pasta de nível superior extra à estrutura de pastas existente de um aplicativo.

Regras de prefixação e sufixação

Prefixos e sufixos não podem conter nenhum dos seguintes caracteres especiais: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
Prefixos e sufixos podem conter espaços à direita, mas não espaços à esquerda.
Prefixos e sufixos devem ser colocados entre aspas duplas para conter espaços à direita.
Prefixos e sufixos são aplicados no momento da importação, mesclagem e adição. Os arquivos .yml de origem nunca são modificados.
O processo de prefixação e sufixação automaticamente prefixa ou sufixa nomes de componentes dependentes quando aplicável. Por exemplo, se os nomes dos catálogos de máquinas forem prefixados com “East”, os grupos de entrega que os referenciam também são prefixados com “East”.
Se um nome de componente já começar com o prefixo ou sufixo, nenhum prefixo ou sufixo é adicionado. Nomes de componentes não podem conter prefixos ou sufixos idênticos duplos.
Prefixos e sufixos podem ser usados individualmente ou em combinação.
O uso de um prefixo ou um sufixo em um componente é opcional.

Nota:

O Studio exibe os componentes em ordem alfabética.

Agrupar componentes por site

Use a prefixação para agrupar visualmente componentes de um único site. Cada site é listado em seu próprio grupo, com a prefixação controlando alfabeticamente a ordenação de diferentes grupos de sites.

Agrupar componentes por nome

Use sufixos para agrupar visualmente componentes com nomes semelhantes de vários sites. Componentes com nomes semelhantes de sites diferentes alternam visualmente.

Arquivo de mapeamento de prefixo e sufixo

A prefixação de site começa com o arquivo SiteMerging.yml que contém o mapeamento de prefixo e sufixo do site para um ou mais sites locais. Você pode gerenciar o arquivo SiteMerging.yml manualmente ou usando os cmdlets disponíveis listados na seção Cmdlets para mesclar vários sites locais.

Exportar site local

A mesclagem não pode começar até que você tenha exportado um site local. Para exportar um site local, consulte Exportar configuração local..

Pasta de destino de exportação central

Os métodos descritos nesta seção colocam várias exportações de site em um local de compartilhamento de arquivos central. O arquivo SiteMerging.yml, o arquivo CustomerInfo.yml e todos os arquivos de exportação residem nesse local de compartilhamento de arquivos, permitindo que você faça a importação de um local independente dos sites locais.

As operações de acesso à nuvem nunca fazem referência aos sites locais ou ao Active Directory, permitindo que você realize operações de acesso à nuvem de qualquer lugar.

Compartilhamento de arquivo direto

Existem dois métodos para fazer isso:

Compartilhamento de arquivo direto: Para importar, mesclar ou adicionar a partir do compartilhamento de arquivo direto, você deve decidir de qual máquina deseja realizar a operação de acesso à nuvem.
Referência de compartilhamento de arquivo usando SiteMerging.yml: Este método usa o membro SiteRootFolder do conjunto de prefixos do site e reduz as chances de direcionar a pasta errada ao exportar, importar, mesclar ou adicionar.

Se você não usar um método de compartilhamento de arquivo central, faça a importação, mesclagem ou adição a partir dos Delivery Controllers individuais. Crie e replique o arquivo SiteMerging.yml em cada Delivery Controller sendo migrado para a nuvem. O local padrão é %HOMEPATH%\Documents\Citrix\AutoConfig. Você deve especificar o parâmetro –SiteName para selecionar os prefixos de site corretos.

Compartilhamento de arquivo direto

As operações de exportação, importação, mesclagem e nova/adição fornecem um parâmetro para direcionar ou originar uma pasta diferente da pasta padrão, %HOMEPATH%\Documents\Citrix\AutoConfig. Os exemplos a seguir usam um compartilhamento de arquivo central localizado em \\share.central.net ao qual o administrador já tem acesso, tendo fornecido as credenciais conforme necessário.

Para direcionar a exportação para uma pasta específica do site, use o parâmetro –TargetFolder:

Do East Delivery Controller™::

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

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

Do West Delivery Controller::

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

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

Após a conclusão das exportações, crie os arquivos CustomerInfo.yml e SiteMerging.yml e coloque-os em \\share.central.net\AutoConfig.

Nota:

Não use o parâmetro SiteRootFolder ao criar o SitePrefixes.yml ao usar este método de referência de compartilhamento de arquivo direto.

Para importar, mesclar ou adicionar a partir do compartilhamento de arquivo direto, você deve decidir de qual máquina deseja realizar a operação de acesso à nuvem. As opções incluem:

Um dos Delivery Controllers locais onde a ferramenta já está instalada.
A máquina que hospeda o compartilhamento de arquivo.
Uma máquina diferente.

A Configuração Automatizada deve ser instalada na máquina que acessa a nuvem. Nem o SDK do PowerShell local, os Delivery Controllers, nem o Active Directory são usados, então os requisitos de execução de acesso à nuvem são mais simples do que os requisitos de exportação.

Para mesclar os Delivery Controllers Leste na nuvem:

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

Para mesclar os Delivery Controllers Oeste na nuvem:

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

O seguinte é um arquivo SitePrefixes.yml de exemplo usado no exemplo 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-->

Referência de compartilhamento de arquivo usando SiteMerging.yml

Este método usa o membro SiteRootFolder do conjunto de prefixos do site. Embora mais complexo do que o método de compartilhamento de arquivo direto, este método reduz as chances de direcionar a pasta errada ao exportar, importar, mesclar ou adicionar.

Primeiro, defina o SiteRootFolder para cada site no arquivo SiteMerging.yml. Você deve fazer isso no local compartilhado.

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

Neste exemplo, Leste é uma especificação de pasta totalmente qualificada e Oeste é uma especificação de pasta relativa.

Para direcionar a exportação para uma pasta específica do site usando o arquivo SiteMerging.yml:

Do Delivery Controller Leste:

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

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

Do Delivery Controller Oeste:

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

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

O cmdlet de exportação usa o local da pasta CustomerInfo.yml para localizar o arquivo SiteMerging.yml. No caso do Leste, o SiteRootFolder é totalmente qualificado. Ele é usado como está. No caso do Oeste, o SiteRootFolder não é totalmente qualificado. Ele é combinado com o local da pasta CustomerInfo.yml para recuperar um local de pasta totalmente qualificado para o Oeste.

Para mesclar o Delivery Controller Leste com a nuvem:

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

Para mesclar o Delivery Controller Oeste com a nuvem:

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

A seguir, um arquivo SitePrefixes.yml de exemplo usado no exemplo 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-->

Se um método de compartilhamento de arquivo central não for usado e a importação, mesclagem ou adição for feita a partir dos Delivery Controllers individuais, crie e replique o arquivo SiteMerging.yml em cada Delivery Controller sendo migrado para a nuvem. O local padrão é %HOMEPATH%\Documents\Citrix\AutoConfig. Você deve especificar o parâmetro –SiteName para selecionar os prefixos de site corretos.

Mesclar os sites

A Citrix® recomenda realizar as operações na nuvem em etapas e fazer uma revisão completa de cada resultado antes de realizar a próxima operação na nuvem. Por exemplo, se estiver mesclando três sites em um único site na nuvem:

Mescle o site inicial com a nuvem usando o valor SiteName apropriado.
Revise os resultados no Studio.
Se os resultados estiverem incorretos, determine o problema e sua causa, corrija-o e, em seguida, execute a mesclagem novamente. Se necessário, remova os componentes da nuvem e comece do zero usando Remove-CvadAcFromSite para o componente e membros selecionados. Se os resultados estiverem corretos, continue.
Se a mesclagem inicial estiver correta, mescle o segundo site ao site de nuvem único.
Repita os passos 2 e 3.
Se a segunda mesclagem estiver correta, mescle o terceiro site ao site de nuvem único.
Repita os passos 2 e 3.
Revise os recursos da perspectiva do usuário e verifique se a visualização está no estado desejado.

Remover um componente usando o prefixo do site

Você pode remover seletivamente componentes de site único usando o prefixo no parâmetro –IncludeByName do cmdlet Remove-CvadAcFromSite. No exemplo a seguir, os grupos de entrega do West Delivery Controller não estão corretos. Para remover os grupos de entrega apenas para o site West:

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Para remover todos os componentes West, execute os seguintes cmdlets em ordem.

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 remover políticas de grupo dos componentes Leste, use o sufixo:

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”

A versão oficial desta documentação do produto está em inglês. Qualquer versão em outro idioma é fornecida apenas para sua conveniência e pode incluir conteúdo traduzido automaticamente. Para obter mais informações, consulte o Aviso Legal sobre Tradução Automática em Cloud Software Group home.

Isso foi útil?

Mesclando vários sites em um único site

May 31, 2026

Contribuição de:

May 31, 2026

Contribuição de:

Neste artigo

Regras de prefixação e sufixação
Exportar site local
Compartilhamento de arquivo direto
Mesclar os sites
Remover um componente usando o prefixo do site

Isso foi útil?