Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

Sauvegarde et restauration à l’aide de l’outil de configuration automatisée

April 8, 2026
Contributeur: 
C C

  • L’outil de configuration automatisée vous permet d’effectuer des sauvegardes à la demande et planifiées dans les environnements suivants :

  • Citrix Virtual Apps and Desktops™
  • 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

    • Sauvegarde et restauration de la configuration automatique

Citrix Virtual Apps™ et Desktops

Prérequis pour 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 PowerShell Citrix. Pour Citrix PowerShell, vous devez installer Web Studio.

Sauvegarde

  1. Installez l’outil de configuration automatisée. Pour plus d’informations, consultez Télécharger l’outil de configuration automatisée.
  2. Double-cliquez sur Auto-Config.
  3. Dans la fenêtre PowerShell, exécutez la commande Backup-CvadAcToFile pour 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 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

    1. Double-cliquez sur Auto-Config.
    1. Exécutez la commande suivante pour effectuer la restauration :
     Restore-CvadAcToSite -Environment OnPrem -RestoreFolder <folder path of the backup files>
 <!--NeedCopy-->
  1. Après avoir exécuté la commande, vérifiez l’état de l’exportation, et le dossier de journaux est disponible à l’emplacement : %HOMEPATH%\Documents\Citrix\AutoConfig.
  2. S’il y a des erreurs ou des exceptions, consultez la section Correctifs dans le fichier journal.

DaaS

Prérequis pour la sauvegarde de vos configurations

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.yml contenant votre ID client, votre ID client et les informations de votre clé secrète. Pour plus d’informations sur le processus de récupération de votre ID client, de votre ID client et de votre clé secrète, consultez Génération de l’ID client, de l’ID client et de la clé secrète. Pour plus d’informations sur l’ajout de ces informations au fichier CustomerInfo.yml, consultez Remplir le fichier d’informations client.
  • Le fichier ZoneMapping.yml contenant les informations qui mappent vos emplacements de ressources dans le cloud. Pour plus d’informations sur la façon de mapper vos zones, consultez le Remplir le fichier de mappage de zones.
  • Le fichier CvadAcSecurity.yml contenant des informations sur les connexions hôtes.
  1. Installez l’outil de configuration automatisée. Pour plus d’informations, Installez 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.

  1. Double-cliquez sur Auto Config.
  2. 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

  1. Double-cliquez sur Auto Config.

  2. Dans la fenêtre PowerShell, exécutez la commande suivante pour effectuer la restauration :

    Restore-CvadAcToSite -RestoreFolder <folder path of the backup files>
<!--NeedCopy-->

  3. Après avoir exécuté la commande, vérifiez l’état de l’exportation, et vous pouvez localiser le dossier de journaux à l’emplacement %HOMEPATH%\Documents\Citrix\AutoConfig.

  4. 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é du groupe de mise à disposition et des composants 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 le 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 enregistrent des journaux dans la console. Les dossiers contenant les informations de journalisation ne sont pas créés dans \Documents\Citrix\AutoConfig.

Remarque

Les conditions préalables à la sauvegarde de vos configurations dans Citrix Virtual Apps and Desktops et Citrix DaaS™ sont les mêmes que celles de 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.

Restauration

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.

Sauvegarde et restauration à l’aide de l’outil de configuration automatisée
April 8, 2026
Contributeur: 
C C
April 8, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.