Backup e ripristino utilizzando lo strumento di configurazione automatica
Lo strumento di configurazione automatica consente di eseguire backup su richiesta e pianificati nei seguenti ambienti:
- Citrix App 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)
Strumento di configurazione automatica per la migrazione

Citrix App 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 Web Studio.
Backup
- Installare la configurazione automatica. Per maggiori informazioni, vedere Scaricare la configurazione automatica.
- 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 recente e ogni backup precedente è archiviato in una sottocartella.
Ripristino
- Fare doppio clic su Auto-Config.
-
Eseguire il comando seguente 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 che la cartella dei log sia 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 automatica.
Backup
Esegue il backup dei seguenti file:
- Il file
CustomerInfo.ymlcon l’ID cliente, l’ID client e le informazioni sulla chiave segreta. Per ulteriori informazioni sul processo per recuperare l’ID cliente, l’ID client e la chiave segreta, vedere Generazione dell’ID cliente, dell’ID client e della chiave segreta. Per informazioni su come aggiungere queste informazioni al fileCustomerInfo.yml, vedere Popolamento del file delle informazioni sul cliente. - Il file
ZoneMapping.ymlcon le informazioni che mappano le posizioni delle risorse nel cloud. Per ulteriori informazioni su come mappare le zone, vedere Popolamento del file di mappatura delle zone. - Il file
CvadAcSecurity.ymlcon le informazioni sulle connessioni host.
- Installare la configurazione automatica. Per ulteriori 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.
- Fare doppio clic su Auto Config.
- 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 dell’esportazione recente e ogni backup precedente è archiviato in una sottocartella.
Ripristina
- Fare doppio clic su Auto Config.
-
Nella finestra di PowerShell, eseguire il comando seguente 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 Fixups nel file di log.
Migrazione granulare
Nota
Per ulteriori 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 comando seguente:
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 comando seguente:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
<!--NeedCopy-->
Strumento di configurazione automatizzata per backup e ripristino
I comandi dello strumento di configurazione automatizzata 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 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.