Documentation produit
Citrix DaaS™
Voir PDF

Migrer les configurations Cloud vers des environnements sur site

April 6, 2026
Contributeur: 
C C

Cet article décrit la sauvegarde et la migration de vos configurations Cloud vers des sites sur site.

Prérequis pour la migration de votre configuration

  • Un environnement Citrix Virtual Apps and Desktops™ sur site avec au moins un VDA enregistré.
  • Un environnement Citrix Virtual Apps and Desktops sur site exécutant l’une des versions suivantes :
    • La version la plus récente de Long-Term Service Release (LTSR) - 2402.
    • L’une des versions Current Releases (CR) - 2308, 2311.
  • Exécutez les commandes de l’outil de configuration automatisée (ACT) sur une machine jointe à un domaine avec la version .Net 4.7.2 ou supérieure.
  • Une machine avec le SDK PowerShell de Citrix. Le SDK PowerShell est disponible dans le programme d’installation de Citrix Delivery Controller™.

Remarque :

  • Si vous exécutez l’ACT sur une machine différente, celle-ci doit être jointe à un domaine et Studio doit disposer des composants logiciels enfichables PowerShell corrects. Pour obtenir le programme d’installation, accédez au site web de téléchargement de Citrix Virtual Apps and Desktops.
  • Sur le site sur site, nous recommandons d’installer l’ACT sur le DDC. L’ACT peut être démarré via l’icône du bureau.
  • Si l’ACT est destiné à être utilisé à partir de la fenêtre PowerShell standard, exécutez la commande suivante : Import-Module Citrix.AutoConfig.Commands

L’ACT ne fait pas partie du chemin PowerShell du système et doit donc être importé explicitement.

Étapes clés

Suivez les instructions pour terminer la migration de vos configurations Cloud vers des environnements sur site :

  1. Sauvegarder la configuration Cloud.
  2. Modifier les fichiers YML.
  3. Importer les configurations vers des environnements sur site.

Sauvegarder la configuration Cloud

  1. Installez la configuration automatisée.
  2. Double-cliquez sur l’icône Auto Config. Une fenêtre PowerShell apparaît.
  3. Exécutez New-CvadAcCustomerInfoFile pour créer un fichier CustomerInfo.yml. Pour plus d’informations, consultez Remplir le fichier d’informations client.
  4. Exécutez la commande Backup-CvadAcToFile pour sauvegarder vos configurations Cloud.

    Remarque :

    • Après avoir exécuté une cmdlet pour la première fois, un dossier de sauvegarde contenant les fichiers de configuration .yml et les journaux est créé. Le dossier se trouve à l’emplacement %HOMEPATH%\Documents\Citrix\AutoConfig.
    • Si vous rencontrez des erreurs ou des exceptions, consultez la section Correctifs dans le fichier journal.
    • Backup-CvadToFile ne prend pas en charge les paramètres IncludeByName ou ExcludeByName.

Important :

Citrix recommande de sauvegarder tous les composants ensemble.

Modifier les fichiers YML

Modifiez les fichiers .yml situés à l’emplacement %HOMEPATH%\Documents\Citrix\AutoConfig pour inclure les détails sur site, comme décrit dans le tableau suivant :

| Fichier YML | Paramètre | Description | Exemples | |————|————|—|—| | CustomerInfo.yml | Environment | Remplacez Environment par OnPrem. La valeur du paramètre d’environnement est sensible à la casse. | | | ZoneMapping.yml | DaaS:CVAD | Mappez les emplacements de vos ressources Cloud à vos zones sur site. | Il doit s’agir d’anciennes : nouvelles zones | | CvadAcSecurity.yml | Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ | Ajoutez le nom d’utilisateur et les mots de passe de l’hyperviseur. | Si l’hyperviseur est XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘ |

Importer les configurations vers des environnements sur site

  1. Exécutez l’une des commandes suivantes sur votre site sur site, en fonction de vos besoins :
    1. Merge-CvadAcToSite - s’il existe un site sur site en cours d’exécution et que vous souhaitez y fusionner les configurations Cloud.
    2. Import-CvadAcToSite -Environment OnPrem - si les configurations sur site ne sont pas disponibles et que vous importez les configurations Cloud pour en créer une.

Important :

Citrix recommande d’importer un composant à la fois pour éviter les conflits.

Migrer les configurations Cloud vers des environnements sur site
April 6, 2026
Contributeur: 
C C
April 6, 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.