Documentação de produtos
Citrix Virtual Apps and Desktops
Serviço Versão Atual 2607 LTSR 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Migrar configurações da nuvem para o local

May 31, 2026
Contribuição de: 
C

Este artigo descreve o backup e a migração de suas configurações da nuvem para sites locais.

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 em 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 SDK do Citrix PowerShell. O SDK do PowerShell está disponível no instalador do Citrix Delivery Controller™.

Nota:

  • 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 Citrix Virtual Apps and Desktops.
  • No site local, recomendamos que o ACT seja instalado no Delivery Controller. O ACT pode ser iniciado através do ícone da área de trabalho.
  • Se o ACT for usado a partir da janela padrão do Powershell, o seguinte comando deve ser executado: 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 das 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. Execute New-CvadAcCustomerInfoFile para criar um arquivo CustomerInfo.yml. Para obter mais informações, consulte Preencher arquivo de informações do cliente..
  3. Execute o comando Backup-CvadAcToFile para fazer um backup das suas configurações da Nuvem.

    Nota:

    • Após executar qualquer cmdlet pela primeira vez, uma pasta de exportação 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 da Nuvem para as suas zonas locais. Deve ser old:new zones
CvadAcSecurity.yml Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ Adicione o nome de usuário e as senhas do hypervisor. Se o hipervisor for XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

Importar configurações para o local

  1. Execute um dos seguintes comandos no seu site local com base nos 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 um.

Importante:

A Citrix recomenda importar um componente por vez para evitar conflitos.

Migrar configurações da nuvem para o local
May 31, 2026
Contribuição de: 
C
May 31, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.