Migrazione delle configurazioni Cloud in locale

Last published : Nov 13, 2026
Questo articolo descrive il backup e la migrazione delle configurazioni Cloud a siti in locale.
Related information
Eseguire il backup o la migrazione della configurazione

Prerequisiti per la migrazione della configurazione

  • Ambiente Citrix Virtual Apps and Desktops™ in locale con almeno un VDA registrato.
  • Ambiente Citrix Virtual Apps and Desktops in locale in esecuzione su una delle seguenti versioni:
    • La versione più recente di Long-Term Service Release (LTSR) - 2402.
    • Qualsiasi versione di Current Releases (CR) - 2308, 2311.
  • Eseguire i comandi di Automated Configuration tool (ACT) su una macchina aggiunta a un dominio con versione .Net 4.7.2 o superiore.
  • Una macchina con il Citrix PowerShell SDK. Il PowerShell SDK è disponibile all'interno del programma di installazione di Citrix Delivery Controller™.
Nota:
  • Se si esegue l'ACT su una macchina diversa, deve essere aggiunta a un dominio e Studio deve avere gli snap-in PowerShell corretti installati. Per ottenere il programma di installazione, andare al sito web dei download di Citrix Virtual Apps and Desktops.
  • Nel sito on-premises, si consiglia di installare ACT sul Delivery Controller. ACT può essere avviato tramite l'icona del desktop.
  • Se ACT deve essere utilizzato dalla finestra standard di PowerShell, allora deve essere eseguito il seguente comando: Import-Module Citrix.AutoConfig.Commands
ACT non fa parte del percorso di sistema di PowerShell, quindi deve essere importato esplicitamente

Passaggi chiave

Seguire le istruzioni per completare la migrazione delle configurazioni Cloud all'ambiente locale:
  1. Backup della configurazione Cloud
  2. Modificare i file YML
  3. Importare le configurazioni in locale

Backup della configurazione Cloud

  1. Installare la Configurazione automatizzata.
  2. Eseguire New-CvadAcCustomerInfoFile per creare un file CustomerInfo.yml. Per maggiori informazioni, vedere Popolare il file delle informazioni del cliente.
  3. Eseguire il comando Backup-CvadAcToFile per eseguire il backup delle configurazioni Cloud.
    Nota:
    • Dopo aver eseguito un cmdlet per la prima volta, viene creata una cartella di esportazione con i file di configurazione .yml e i log. La cartella si trova in %HOMEPATH%\Documents\Citrix\AutoConfig.
    • Se si verificano errori o eccezioni, consultare la sezione Correzioni nel file di log.
    • Backup-CvadToFile non supporta i parametri IncludeByName o ExcludeByName.
Importante:
Citrix consiglia di eseguire il backup di tutti i componenti insieme.

Modificare i file YML

Modificare i file .yml che si trovano in %HOMEPATH%\Documents\Citrix\AutoConfig per includere i dettagli on-premises come descritto nella seguente tabella:
File YML Parametro Descrizione Esempi
CustomerInfo.yml Ambiente Modificare Ambiente in OnPrem. Il valore del parametro ambiente fa distinzione tra maiuscole e minuscole.
ZoneMapping.yml DaaS:CVAD Mappare le posizioni delle risorse Cloud alle zone on-premises. Deve essere zone vecchie:nuove
CvadAcSecurity.yml Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ Aggiungere il nome utente e le password dell'hypervisor. Se l'hypervisor è XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

Importare le configurazioni in locale

  1. Eseguire uno dei seguenti comandi nel sito on-premises in base ai requisiti:
    1. Merge-CvadAcToSite - se è in esecuzione un sito on-premises e si desidera unirvi le configurazioni Cloud.
    2. Import-CvadAcToSite -Environment OnPrem - Se le configurazioni on-premises non sono disponibili e si stanno importando le configurazioni Cloud per crearne una.
Importante:
Citrix consiglia di importare un componente alla volta per evitare conflitti.