Sauvegarde et restauration à l’aide de l’outil de configuration automatisée
L’outil de configuration automatisée vous permet d’effectuer des sauvegardes à la demande et planifiées dans les environnements suivants :
- Citrix Applications et Bureaux Virtuels™
- DaaS
L’outil de configuration automatisée peut être utilisé pour les opérations suivantes :
- Sauvegarde et restauration (sauvegardes à la demande et planifiées)
- Migration (sauvegardes à la demande)
Outil de configuration automatisée pour la migration

Citrix Applications et Bureaux Virtuels
Conditions préalables à la sauvegarde de vos configurations
- Toutes les versions de Citrix Virtual Apps and Desktops.
-
Une machine pour exécuter Auto Config. Cet appareil peut être :
- Un Delivery Controller™
- Une machine jointe à un domaine avec .NET Framework 4.7.2 ou version ultérieure et le SDK Citrix PowerShell. Pour Citrix PowerShell, vous devez installer Web Studio.
Sauvegarde
- Installez Automated Configuration. Pour plus d’informations, consultez Télécharger Automated Configuration.
- Double-cliquez sur Auto-Config.
- Dans la fenêtre PowerShell, exécutez la commande
Backup-CvadAcToFilepour exporter tous les composants. L’exportation de votre configuration sur site ne la modifie pas.
Après avoir exécuté la commande pour la première fois, le processus crée un dossier avec les fichiers de configuration .yml à l’emplacement suivant :
%HOMEPATH%\Documents\Citrix\AutoConfig.
Le dossier contient les fichiers de sauvegarde de l’exportation récente, et chaque sauvegarde précédente est stockée dans un sous-dossier.
Restauration
- Double-cliquez sur Auto-Config.
-
Exécutez la commande suivante pour effectuer la restauration :
Restore-CvadAcToSite -Environment OnPrem -RestoreFolder <folder path of the backup files> <!--NeedCopy--> - Après avoir exécuté la commande, vérifiez l’état de l’exportation, et le dossier de journaux est disponible à l’adresse :
%HOMEPATH%\Documents\Citrix\AutoConfig. - S’il y a des erreurs ou des exceptions, consultez la section Correctifs dans le fichier journal.
DaaS
Conditions préalables à la sauvegarde de vos configurations
- Un environnement DaaS avec un emplacement de ressources actif et un connecteur installés.
- Connectivité aux sites accédant à Citrix Cloud. Pour plus d’informations, consultez Exigences système et de connectivité.
Remarque
Vous ne pouvez pas sauvegarder MCS depuis le cloud à l’aide de l’outil de configuration automatisée.
Sauvegarde
Sauvegarde les fichiers suivants :
- Le fichier
CustomerInfo.ymlcontenant vos informations d’ID client, d’ID d’application client et de clé secrète. Pour plus d’informations sur le processus de récupération de votre ID client, de votre ID d’application client et de votre clé secrète, consultez Génération de l’ID client, de l’ID d’application client et de la clé secrète. Pour plus d’informations sur la façon d’ajouter ces informations au fichierCustomerInfo.yml, consultez Remplir le fichier d’informations client. - Le fichier
ZoneMapping.ymlcontenant les informations qui mappent les emplacements de vos ressources dans le cloud. Pour plus d’informations sur la façon de mapper vos zones, consultez Remplir le fichier de mappage de zones. - Le fichier
CvadAcSecurity.ymlcontenant des informations sur les connexions d’hôte.
- Installez l’outil de configuration automatisée. Pour plus d’informations, consultez Installer l’outil de configuration automatisée.
Remarque
Pour les sauvegardes DaaS, installez l’outil de configuration automatisée sur une machine ayant accès à Internet et à laquelle l’administrateur a également un accès direct.
- Double-cliquez sur Auto Config.
- Dans la fenêtre PowerShell, exécutez la commande suivante pour effectuer une sauvegarde :
Export-CvadAcToFile
Après avoir exécuté la commande pour la première fois, le processus crée un dossier contenant les fichiers de configuration .yml à l’emplacement suivant :
%HOMEPATH%\Documents\Citrix\AutoConfig
Le dossier contient les fichiers de sauvegarde de l’exportation récente, et chaque sauvegarde précédente est stockée dans un sous-dossier.
Restauration
- Double-cliquez sur Auto Config.
-
Dans la fenêtre PowerShell, exécutez la commande suivante pour effectuer la restauration :
Restore-CvadAcToSite -RestoreFolder <folder path of the backup files> <!--NeedCopy--> -
Après avoir exécuté la commande, vérifiez l’état de l’exportation et vous pouvez localiser le dossier de journaux à l’adresse
%HOMEPATH%\Documents\Citrix\AutoConfig. - S’il y a des erreurs ou des exceptions, consultez la section Correctifs dans le fichier journal.
Migration granulaire
Remarque
Pour plus d’informations sur l’ordre de migration des composants, consultez Ordre de migration des composants.
Restaurer des composants entiers
Pour restaurer un composant, vous devez sélectionner un ou plusieurs paramètres.
Par exemple, pour restaurer l’intégralité des composants du groupe de mise à disposition et du catalogue de machines, exécutez la commande suivante :
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs
<!--NeedCopy-->
Restaurer les membres du composant
Pour restaurer un ou plusieurs membres de composant, utilisez la fonctionnalité IncludeByName. Vous devez appeler la cmdlet Restore avec le paramètre Restorefolder ainsi que le composant sélectionné et la liste d’inclusion.
Par exemple, pour restaurer deux stratégies de groupe à partir d’une sauvegarde :
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -GroupPolicies -IncludeByName Policy1,Policy2
<!--NeedCopy-->
Restaurer la configuration complète du site cloud
Pour restaurer tous les composants ou l’intégralité du site cloud, exécutez la commande suivante :
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
<!--NeedCopy-->
Outil de configuration automatisée pour la sauvegarde et la restauration
Les commandes de l’outil de configuration automatisée déclenchent les API de sauvegarde et de restauration utilisées par Web Studio.
Les cmdlets BckRstr se connectent à la console. Les dossiers contenant les informations de journalisation ne sont pas créés dans \Documents\Citrix\AutoConfig.
Remarque :
Les prérequis pour la sauvegarde de vos configurations dans Citrix Virtual Apps and Desktops et Citrix DaaS™ sont les mêmes que pour l’outil de configuration automatisée dans la session PowerShell.
Sauvegarde
Pour démarrer une nouvelle action de sauvegarde sur le Delivery Controller, exécutez New-BckRstrBackup dans la fenêtre PowerShell.
Restaurer
Pour restaurer des membres d’un seul composant à partir d’une sauvegarde existante, exécutez Restore-BckRstrBackups dans la fenêtre PowerShell.
Pour la liste complète des commandes, consultez Cmdlets de l’outil de configuration automatisée pour la sauvegarde et la restauration.