Backup e ripristino tramite lo strumento di configurazione automatica

Last published : Nov 03, 2026
Lo strumento di configurazione automatica consente di eseguire backup su richiesta e pianificati nei seguenti ambienti:
  • Citrix Applicazioni Virtuali e Desktop™
  • DaaS
Lo strumento di configurazione automatica può essere utilizzato per quanto segue:
  • Backup e ripristino (backup su richiesta e pianificati)
  • Migrazione (backup su richiesta)
Related information
Configurazione di backup e ripristino

Strumento di configurazione automatica per la migrazione

Backup e ripristino della configurazione automatica

Citrix Applicazioni Virtuali e Desktop

Prerequisiti per il backup delle configurazioni

  • Tutte le versioni di Citrix Virtual Apps and Desktops.
  • Una macchina per eseguire Auto Config. Questo dispositivo può essere:
    • Un delivery controller™
    • Una macchina aggiunta a un dominio con .NET Framework 4.7.2 o versioni successive e l'SDK Citrix PowerShell. Per Citrix PowerShell, è necessario installare Citrix Studio.

Backup

  1. Installare la configurazione automatica. Per maggiori informazioni, vedere Scaricare la configurazione automatica.
  2. Fare doppio clic su Auto-Config.
  3. Nella finestra di PowerShell, eseguire il comando Backup-CvadAcToFile per esportare tutti i componenti. L'esportazione della configurazione locale non la modifica.
Dopo aver eseguito il comando per la prima volta, il processo crea una cartella con i file di configurazione .yml nella seguente posizione: %HOMEPATH%\Documents\Citrix\AutoConfig.
La cartella contiene i file di backup dell'esportazione più recente e ogni backup precedente è archiviato in una sottocartella.

Ripristino

  1. Fare doppio clic su Auto-Config.
  2. Eseguire il comando seguente per eseguire il ripristino:
    Restore-CvadAcToSite -Environment OnPrem -RestoreFolder <folder path of the backup files>
  3. Dopo aver eseguito il comando, verificare lo stato dell'esportazione e che la cartella dei log sia disponibile all'indirizzo: %HOMEPATH%\Documents\Citrix\AutoConfig.
  4. In caso di errori o eccezioni, consultare la sezione Correzioni nel file di log.

DaaS

Prerequisiti per il backup delle configurazioni

  • Un ambiente DaaS con una posizione delle risorse attiva e un connettore installato.
  • Connettività ai siti che accedono a Citrix Cloud. Per maggiori informazioni, vedere Requisiti di sistema e connettività.
Nota
Non è possibile eseguire il backup di MCS dal cloud utilizzando la configurazione automatica.

Backup

Esegue il backup dei seguenti file:
  1. Installare la configurazione automatica. Per maggiori informazioni, vedere Installare la configurazione automatica.
Nota
Per i backup DaaS, installare la configurazione automatica su una macchina con accesso a Internet e a cui l'amministratore abbia anche accesso diretto.
  1. Fare doppio clic su Auto Config.
  2. Nella finestra di PowerShell, eseguire il seguente comando per eseguire un backup: Export-CvadAcToFile
Dopo aver eseguito il comando per la prima volta, il processo crea una cartella con i file di configurazione .yml nella seguente posizione: %HOMEPATH%\Documents\Citrix\AutoConfig
La cartella contiene i file di backup dall'esportazione recente, e ogni backup precedente è archiviato in una sottocartella.

Ripristino

  1. Fare doppio clic su Auto Config.
  2. Nella finestra di PowerShell, eseguire il seguente comando per eseguire il ripristino:
    Restore-CvadAcToSite -RestoreFolder <folder path of the backup files>
  3. Dopo aver eseguito il comando, verificare lo stato dell'esportazione e la cartella dei log si trova in %HOMEPATH%\Documents\Citrix\AutoConfig.
  4. In caso di errori o eccezioni, consultare la sezione Fixups nel file di log.

Migrazione granulare

Nota
Per maggiori informazioni sull'ordine di migrazione dei componenti, vedere Ordine di migrazione dei componenti.

Ripristinare interi componenti

Per ripristinare un componente, è necessario selezionare uno o più parametri.
Ad esempio, per ripristinare l'intero gruppo di consegna e i componenti del catalogo macchine, eseguire il seguente comando:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs

Ripristinare i membri del componente

Per ripristinare uno o più membri del componente, utilizzare la funzionalità IncludeByName. È necessario richiamare il cmdlet Restore con il parametro Restorefolder insieme al componente selezionato e all'elenco di inclusione.
Ad esempio, per ripristinare due criteri di gruppo da un backup:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -GroupPolicies -IncludeByName Policy1,Policy2

Ripristinare la configurazione completa del sito cloud

Per ripristinare tutti i componenti o l'intero sito cloud, eseguire il seguente comando:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Strumento di configurazione automatizzata per backup e ripristino

I comandi dello strumento di configurazione automatizzata attivano le API di backup e ripristino utilizzate da Studio.
I cmdlet BckRstr registrano sulla console. Le cartelle con le informazioni di registrazione non vengono create in \Documents\Citrix\AutoConfig.
Nota:
I prerequisiti per il backup delle configurazioni in Citrix Virtual Apps and Desktops e Citrix DaaS™ sono gli stessi dello strumento di configurazione automatizzata nella sessione PowerShell.

Backup

Per avviare una nuova azione di backup sul Delivery Controller, eseguire New-BckRstrBackup nella finestra di PowerShell.

Ripristino

Per ripristinare i membri da un singolo componente da un backup esistente, eseguire Restore-BckRstrBackups nella finestra di PowerShell.
Per l'elenco completo dei comandi, vedere Cmdlet dello strumento di configurazione automatizzata per backup e ripristino.