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 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)
Strumento di configurazione automatica per la migrazione

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 Web Studio.
Backup
- Installa Configurazione automatizzata. Per maggiori informazioni, consulta Scaricare Configurazione automatizzata.
- Fai doppio clic su Auto-Config.
- Nella finestra di PowerShell, esegui 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
- Fai doppio clic su Auto-Config.
-
Esegui il seguente comando per eseguire il ripristino:
Restore-CvadAcToSite -Environment OnPrem -RestoreFolder <folder path of the backup files> <!--NeedCopy--> - Dopo aver eseguito il comando, verifica lo stato dell’esportazione e la cartella dei log è disponibile all’indirizzo:
%HOMEPATH%\Documents\Citrix\AutoConfig. - In caso di errori o eccezioni, consulta la sezione Correzioni nel file di log.
DaaS
Prerequisiti per il backup delle configurazioni
- Un ambiente DaaS con una posizione delle risorse attiva e Connector installato.
- Connettività ai siti che accedono a Citrix Cloud. Per maggiori informazioni, consulta 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 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, 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 cliente. - Il file
ZoneMapping.ymlcon le informazioni che mappano le posizioni delle risorse nel cloud. Per maggiori 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 maggiori informazioni, vedere Installare la configurazione automatica.
Nota
Per i backup DaaS, installare la configurazione automatica su una macchina con accesso a Internet e alla quale 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 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 la cartella dei log si trova in
%HOMEPATH%\Documents\Citrix\AutoConfig. - 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
<!--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 backup e 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 backup e ripristino.