Migrar configurações da Nuvem para ambientes locais

Last published : Nov 03, 2026
Este artigo descreve o backup e a migração de suas configurações da Nuvem para sites locais.
Related information
Migrar configuração para Citrix Cloud™

Pré-requisitos para migrar sua configuração

  • Ambiente local do Citrix Virtual Apps and Desktops™ com pelo menos um VDA registrado.
  • Ambiente local do Citrix Virtual Apps and Desktops executando uma das seguintes versões:
    • A versão mais recente do Long-Term Service Release (LTSR) - 2402.
    • Qualquer uma das versões do Current Releases (CR) - 2308, 2311.
  • Execute os comandos da ferramenta de Configuração Automatizada (ACT) em uma máquina ingressada no domínio com a versão .Net 4.7.2 ou superior.
  • Uma máquina com o Citrix PowerShell SDK. O PowerShell SDK está disponível no instalável do Citrix Delivery Controller™.
Observação:
  • Se você estiver executando o ACT em uma máquina diferente, ela deve estar ingressada no domínio e o Studio deve ter os snap-ins corretos do PowerShell instalados. Para obter o instalador, acesse o site de downloads do Citrix Virtual Apps and Desktops.
  • No site local, recomendamos que o ACT seja instalado no DDC. O ACT pode ser iniciado através do ícone da área de trabalho.
  • Se o ACT for destinado a ser usado a partir da janela padrão do Powershell, então execute o seguinte comando: Import-Module Citrix.AutoConfig.Commands
O ACT não faz parte do caminho do PowerShell do sistema, portanto, deve ser importado explicitamente.

Etapas principais

Siga as instruções para concluir a migração de suas configurações da nuvem para o local:
  1. Fazer backup da configuração da nuvem.
  2. Modificar arquivos YML.
  3. Importar configurações para o local.

Fazer backup da configuração da nuvem

  1. Instale o Automated Configuration.
  2. Clique duas vezes no ícone Auto Config. Uma janela do PowerShell é exibida.
  3. Execute New-CvadAcCustomerInfoFile para criar um arquivo CustomerInfo.yml. Para obter mais informações, consulte Preencher arquivo de informações do cliente.
  4. Execute o comando Backup-CvadAcToFile para fazer um backup de suas configurações da nuvem.
    Nota:
    • Depois de executar qualquer cmdlet pela primeira vez, uma pasta de backup com os arquivos de configuração .yml e logs é criada. A pasta está em %HOMEPATH%\Documents\Citrix\AutoConfig.
    • Se você encontrar erros ou exceções, consulte a seção Fixups no arquivo de log.
    • Backup-CvadToFile não oferece suporte aos parâmetros IncludeByName ou ExcludeByName.
Importante:
A Citrix recomenda fazer backup de todos os componentes juntos.

Modificar arquivos YML

Modifique os arquivos .yml localizados em %HOMEPATH%\Documents\Citrix\AutoConfig para incluir os detalhes locais, conforme descrito na tabela a seguir:
Arquivo YML Parâmetro Descrição Exemplos
CustomerInfo.yml Ambiente Altere o Ambiente para OnPrem. O valor do parâmetro de ambiente diferencia maiúsculas de minúsculas.
ZoneMapping.yml DaaS:CVAD Mapeie os locais dos seus recursos na nuvem para as suas zonas locais. Deve ser zonas antigas:novas
CvadAcSecurity.yml Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ Adicione o nome de usuário e as senhas do hipervisor. Se o hipervisor for XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

Importar configurações para o local

  1. Execute um dos seguintes comandos em seu site local com base em seus requisitos:
    1. Merge-CvadAcToSite - se houver um site local em execução e você quiser mesclar as configurações da Nuvem a ele.
    2. Import-CvadAcToSite -Environment OnPrem - Se as configurações locais não estiverem disponíveis e você estiver importando as configurações da Nuvem para criar uma.
Importante:
A Citrix recomenda importar um componente por vez para evitar conflitos.