Backup e ripristino tramite lo strumento di configurazione automatica
Lo strumento di configurazione automatica consente di eseguire backup su richiesta e pianificati nei seguenti ambienti:
- Citrix Virtual Apps e Desktops™
- DaaS
Lo strumento di configurazione automatica può essere utilizzato per quanto segue:
- Backup e ripristino (backup su richiesta e pianificati)
- Migrazione (backup su richiesta)
Strumento di configurazione automatica per la migrazione

Citrix Virtual Apps™ e Desktops
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 Web Studio.
Backup
- Installare Automated Configuration. Per maggiori informazioni, vedere Scaricare Automated Configuration.
- Fare doppio clic su Auto-Config.
- Nella finestra di PowerShell, eseguire il comando
Backup-CvadAcToFileper 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
- Fare doppio clic su Auto-Config.
-
Eseguire il seguente comando per eseguire il ripristino:
Restore-CvadAcToSite -Environment OnPrem -RestoreFolder <folder path of the backup files> <!--NeedCopy--> - Dopo aver eseguito il comando, verificare lo stato dell’esportazione e la cartella dei log è disponibile all’indirizzo:
%HOMEPATH%\Documents\Citrix\AutoConfig. - 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 automatizzata.
Backup
Esegue il backup dei seguenti file:
- Il file
CustomerInfo.ymlcon le informazioni sull’ID cliente, l’ID client e la chiave segreta. Per maggiori informazioni sul processo per recuperare l’ID cliente, l’ID client e la chiave segreta, consulta Generazione dell’ID cliente, dell’ID client e della chiave segreta. Per informazioni su come aggiungere queste informazioni al fileCustomerInfo.yml, consulta Popolamento del file delle informazioni del cliente. - Il file
ZoneMapping.ymlcon le informazioni che mappano le posizioni delle risorse nel cloud. Per maggiori informazioni su come mappare le zone, consulta il Popolamento del file di mappatura delle zone. - Il file
CvadAcSecurity.ymlcon le informazioni sulle connessioni host.
- Installa la configurazione automatizzata. Per maggiori informazioni, Installa la configurazione automatizzata.
Nota
Per i backup DaaS, installa la configurazione automatizzata su una macchina con accesso a Internet e a cui l’amministratore abbia accesso diretto.
- Fai doppio clic su Auto Config.
- Nella finestra di PowerShell, esegui 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 dell’esportazione più recente e ogni backup precedente è archiviato in una sottocartella.
Ripristino
- Fare doppio clic su Auto Config.
-
Nella finestra di PowerShell, eseguire il seguente comando per eseguire il ripristino:
Restore-CvadAcToSite -RestoreFolder <folder path of the backup files> <!--NeedCopy--> -
Dopo aver eseguito il comando, verificare lo stato dell’esportazione e individuare la cartella dei log in
%HOMEPATH%\Documents\Citrix\AutoConfig. - In caso di errori o eccezioni, consultare la sezione Correzioni nel file di log.
Migrazione granulare
Nota
Per maggiori informazioni sull’ordine di migrazione dei componenti, consultare 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
<!--NeedCopy-->
Ripristinare i membri del componente
Per ripristinare uno o più membri del componente, utilizzare la funzione 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
<!--NeedCopy-->
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
<!--NeedCopy-->
Strumento di configurazione automatica per il backup e il ripristino
I comandi dello strumento di configurazione automatica attivano le API di backup e ripristino utilizzate da Web Studio.
I cmdlet BckRstr registrano nella 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 automatica 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 automatica per il backup e il ripristino.