Documentation produit
Citrix DaaS™
Voir PDF

Migrer la configuration vers Citrix Cloud™

April 6, 2026
Contributeur: 
C C

L’outil de configuration automatisée (ACT) permet la migration de la configuration de Citrix Virtual Apps and Desktops™ (stratégies, applications, catalogues, rôles d’administrateur, étendues et autres) d’un ou plusieurs sites sur site vers Citrix DaaS hébergé sur Citrix Cloud. Il peut également être utilisé pour migrer des informations entre différentes régions ou locataires Cloud.

Cet outil découvre et exporte un ou plusieurs sites sur site sous forme de collection de fichiers de configuration, que vous pouvez éventuellement modifier. La configuration de ces fichiers peut ensuite être importée dans Citrix DaaS. La migration s’effectue par étapes en exécutant l’outil plusieurs fois, ce qui vous permet d’atteindre facilement l’état de configuration souhaité.

ACT n’est pas seulement un outil de migration unique. Vous pouvez l’utiliser pour gérer vos opérations cloud quotidiennes, telles que :

  • L’automatisation du transfert des comptes cloud de test ou de préproduction vers les comptes cloud de production
  • La sauvegarde et la restauration de votre configuration
  • La division d’un environnement cloud en plusieurs clouds

La vidéo suivante de 2 minutes offre un aperçu rapide de la configuration automatisée.

Pour plus d’informations sur la configuration automatisée, consultez Preuve de concept : Outil de configuration automatisée sur Tech Zone.

Pour un examen plus approfondi du déplacement de votre déploiement et de la préparation de votre configuration sur site pour la migration, consultez Guide de déploiement : Migration de Citrix Virtual Apps and Desktops du site sur site vers Citrix Cloud sur Tech Zone.

Limitations connues

Conditions préalables à la migration de votre configuration

Pour exporter votre configuration depuis Citrix Virtual Apps and Desktops, vous avez besoin de :

  • Citrix Virtual Apps and Desktops : version actuelle et son prédécesseur immédiat ou Citrix Virtual Apps and Desktops, XenApp et XenDesktop® LTSR : toutes les versions
  • Une machine jointe à un domaine avec .NET Framework 4.7.2 ou version ultérieure et le SDK Citrix PowerShell. Celui-ci est automatiquement installé sur le Delivery Controller. (Pour exécuter sur une machine autre que le Delivery Controller sur site, Citrix Studio doit être installé, car Studio installe les bons compléments PowerShell. L’installateur de Studio se trouve sur le support d’installation de Citrix Virtual Apps and Desktops.)

Pour importer votre configuration dans Citrix DaaS, vous avez besoin de :

  • Une machine ayant accès à Citrix Cloud. Il ne s’agit pas nécessairement d’un Delivery Controller™ ou d’une machine jointe à un domaine.
  • Citrix DaaS provisionné.
  • Un emplacement de ressources actif avec le connecteur installé et joint au même domaine que la configuration sur site.
  • La connectivité aux sites accédant à Citrix Cloud doit être autorisée et disponible. Pour plus d’informations, consultez Exigences système et de connectivité.

Remarque :

La configuration automatisée ne peut pas être installée sur un système Cloud Connector.

Étapes clés

  1. Téléchargez l’outil de configuration automatisée et examinez la configuration système requise. Consultez Télécharger la configuration automatisée.
  2. Renseignez le fichier CustomerInfo.yml avec vos valeurs CustomerName, CustomerID et SecretKey générées à partir du portail Citrix Cloud. Consultez Générer l’ID client, l’ID client et la clé secrète et Renseigner le fichier d’informations client.
  3. Si le site sur site contient plusieurs zones, mettez à jour le fichier ZoneMapping.yml pour mapper les zones aux emplacements de ressources Citrix DaaS. Consultez Renseigner le fichier de mappage de zones.
  4. Si le site contient plusieurs connexions d’hébergement, mettez à jour le fichier CvadAcSecurity.yml avec les informations de connexion pour chaque type d’hôte migrant vers Citrix DaaS. S’il n’y a qu’une seule connexion d’hôte, mettez à jour le fichier CvadACSecurity.yml avec les informations de connexion pour la connexion d’hôte. Consultez Mettre à jour le fichier de sécurité pour les connexions d’hôte.
  5. Ouvrez ACT et exportez votre site sur site à l’aide de la commande Export-CvadAcToFile. Consultez Objets de migration pris en charge pour la liste des composants pris en charge pour la migration. Pour plus d’informations sur les étapes d’exportation, consultez Exporter la configuration sur site.
  6. Importez les composants par étapes à l’aide de la commande Merge-CvadAcToSite. Vous pouvez également migrer l’intégralité du site en une seule fois. Assurez-vous de migrer les composants dans l’ordre indiqué dans Ordre de migration des composants. Pour plus d’informations sur les étapes d’importation, consultez Exécuter une importation.
  7. Activez le site cloud. Consultez Activer les sites.

Télécharger la configuration automatisée

Téléchargez et installez l’outil de configuration automatisée depuis Téléchargements Citrix.

Mettre à niveau la configuration automatisée

Pour éviter les erreurs de fonctionnalité, utilisez toujours la dernière version disponible d’ACT.

Pour connaître la version de votre outil, procédez comme suit :

  1. Double-cliquez sur l’icône Auto Config. Une fenêtre PowerShell apparaît.
  2. Exécutez la commande suivante pour vérifier votre numéro de version.

Générer l’ID client, l’ID client et la clé secrète

Pour migrer le site sur site vers Citrix DaaS, renseignez le fichier CustomerInfo.yml avec l’ID client, l’ID client et la clé secrète du portail Citrix Cloud.

Pour récupérer l’ID client :

  1. Connectez-vous à votre compte Citrix Cloud et sélectionnez le client.
  2. Cliquez sur l’icône de la grille et sélectionnez Gestion des identités et des accès.
  3. Accédez à Accès API > Clients sécurisés. L’ID client s’affiche sur la page.

Pour récupérer l’ID client et la clé secrète :

  1. Sur la page Clients sécurisés, saisissez un nom dans la zone. Ce nom est utilisé pour différencier plusieurs ID client et clés secrètes.
  2. Cliquez sur Créer un client pour créer l’ID client et la clé secrète.
  3. Copiez l’ID client et la clé secrète dans un emplacement sécurisé et téléchargez le fichier .csv contenant ces informations. Utilisez le fichier .csv pour renseigner le fichier CustomerInfo.yml.

Remarque :

  • L’ID client et la clé secrète n’expirent pas. S’ils sont compromis, supprimez-les immédiatement à l’aide de l’icône Corbeille et créez-en de nouveaux.
  • La clé secrète ne peut pas être récupérée si elle est perdue ou oubliée ; un nouvel ID client et une nouvelle clé secrète doivent être créés.

Renseigner le fichier d’informations client

Le fichier CustomerInfo.yml élimine la nécessité de fournir des paramètres d’informations client à chaque exécution de l’applet de commande. Toute information client peut être remplacée à l’aide des paramètres de l’applet de commande.

Utilisez l’applet de commande New-CvadAcCustomerInfoFile pour créer le fichier CustomerInfo.yml.

Important :

Ne modifiez pas manuellement le fichier CustomerInfo.yml. Cela pourrait entraîner des erreurs de formatage involontaires.

L’applet de commande New-CvadAcCustomerInfoFile possède les paramètres requis suivants.

  • CustomerId – ID du client.
  • ClientId – ID client du client créé sur Citrix Cloud.
  • Secret – clé secrète du client créée sur Citrix Cloud.

Exemple :

Remarque :

Ajoutez un espace entre le signe deux-points et le nom de l’emplacement de la ressource. Si des espaces sont utilisés dans le nom de la zone ou de l’emplacement de la ressource, mettez le nom entre guillemets.

Mettre à jour le fichier de sécurité pour les connexions d’hôte

Les connexions d’hôte et leurs hyperviseurs associés peuvent être exportés et importés à l’aide d’ACT.

L’ajout d’un hyperviseur à une connexion d’hôte nécessite des informations de sécurité spécifiques au type d’hyperviseur. Ces informations ne peuvent pas être exportées depuis le site local pour des raisons de sécurité. Vous devez fournir manuellement les informations afin que la configuration automatisée puisse importer avec succès les connexions d’hôte et les hyperviseurs vers le site cloud.

Le processus d’exportation crée le fichier CvadAcSecurity.yml dans %HOMEPATH%\Documents\Citrix\AutoConfig contenant des espaces réservés pour chaque élément de sécurité nécessaire au type d’hyperviseur spécifique. Vous devez mettre à jour le fichier CvadAcSecurity.yml avant de l’importer dans le site cloud. Les mises à jour de l’administrateur sont conservées lors de plusieurs exportations, avec de nouveaux espaces réservés de sécurité ajoutés si nécessaire. Les éléments de sécurité ne sont jamais supprimés. Pour plus d’informations, consultez Mettre à jour manuellement le fichier CvadAcSecurity.yml

            HostConn1:
            ConnectionType: XenServer®
            UserName: root
            PasswordKey: rootPassword
            HostCon2:
            ConnectionType: AWS
            ApiKey: 78AB6083-EF60-4D26-B2L5-BZ35X00DA5CH
            SecretKey: TwBLaaaaaaaaaaaaaaaaaw==
            Region: East

Informations de sécurité par hyperviseur

La liste suivante répertorie les informations de sécurité requises pour chaque type d’hyperviseur.

  • XenServer, Hyper-V, VMware
    • Nom d’utilisateur
    • Mot de passe en clair
  • Microsoft Azure
    • ID d’abonnement
    • ID d’application
    • Secret d’application
  • AWS
    • ID de compte de service
    • Secret d’application
    • Région

Considérations spéciales en matière de sécurité

Toutes les informations de sécurité sont saisies en texte clair. Si le texte clair n’est pas recommandé, les connexions d’hôte et les hyperviseurs associés peuvent être créés manuellement à l’aide de Studio. Les noms des connexions d’hôte et des hyperviseurs doivent correspondre exactement à leurs homologues locaux afin que les catalogues de machines qui utilisent les connexions d’hôte puissent être importés avec succès.

Exporter votre configuration locale Citrix Virtual Apps and Desktops

À l’aide d’une commande PowerShell export, vous pouvez exporter votre configuration locale existante et obtenir les fichiers .yml nécessaires. Ces fichiers sont utilisés pour importer la configuration souhaitée dans Citrix Cloud.

Objets de migration pris en charge

La configuration automatisée prend en charge le déplacement de la configuration des composants suivants :

  • Balises
  • Administration déléguée
    • Portées
    • Rôles
  • Connexions d’hôte
    • Un seul pool de ressources
    • Portées d’administration
  • Catalogues de machines
    • Portées d’administration
    • Machines
    • Accès PC distant, physique, en pool, provisionné, MCS, attribué
  • StoreFront™
  • Groupes de mise à disposition
    • Stratégie d’accès
    • Association de portée d’administration
    • Stratégie d’accès aux applications
    • Stratégie d’attribution
    • Stratégie d’autorisation/de bureau
    • Planifications d’alimentation
    • Persistance de session
    • Pré-lancement de session
    • Planifications de redémarrage
    • Balises
  • Groupes d’applications
    • Association de portée d’administration
    • Groupes de mise à disposition
    • Utilisateurs et groupes
  • Applications
    • Dossiers d’applications
    • Icônes
    • Applications
    • FTA configurés par le Broker
    • Balises
  • Stratégies de groupe
  • Préférences de zone utilisateur

Exporter la configuration locale

  1. Double-cliquez sur l’icône Auto Config. Une fenêtre PowerShell apparaît.
  2. Exécutez la commande suivante pour exporter tous les composants. L’exportation de votre configuration locale ne la modifie en aucun cas.

Configuration automatisée : Opérations d’importation et activation de site

Comprendre la migration des catalogues provisionnés par Machine Creation Services

Remarque :

Cette fonctionnalité est disponible uniquement à partir de la version 3.0. Vérifiez votre version à l’aide de Get-CvadAcStatus dans Automated Configuration.

Les catalogues Machine Creation Services (MCS) créent deux types de catalogues différents :

  • Lorsque les modifications apportées à une machine sont perdues ou annulées (généralement un système d’exploitation serveur, où les applications sont publiées) – il s’agit d’un cas d’utilisation VDI en pool / multi-session.
  • Lorsque les modifications apportées à une machine sont conservées après un redémarrage (généralement un système d’exploitation client avec un utilisateur dédié) – il s’agit d’un cas d’utilisation VDI statique.

Le type de catalogue peut être confirmé dans le nœud de catalogue de Citrix Studio en examinant la valeur « Données utilisateur : » du catalogue.

Remarque :

MCS ne peut pas être sauvegardé depuis le cloud à l’aide d’Automated Configuration.

Catalogues VDI en pool / multi-session

Les catalogues avec « Données utilisateur : Ignorer » sont des catalogues VDI en pool et ne peuvent migrer que l’image principale et la configuration. Aucune machine virtuelle de ces catalogues n’est migrée. Cela s’explique par le fait que le cycle de vie de la machine virtuelle est géré par le site à partir duquel vous importez, ce qui signifie qu’à chaque démarrage des machines, leur état peut changer. Cela rend l’importation impossible car les données d’importation des machines virtuelles se désynchronisent rapidement.

Lorsque vous migrez ces catalogues à l’aide de l’outil, il crée les métadonnées du catalogue et initie la création de l’image principale, mais aucune machine n’est importée.

Étant donné que ce processus peut prendre un certain temps en fonction de la taille de l’image principale, la commande d’importation de l’outil ne fait que démarrer la création du catalogue MCS et n’attend pas qu’elle se termine. Une fois l’importation terminée, surveillez la progression de la création du catalogue à l’aide de Studio dans le déploiement cloud.

Une fois l’image principale créée, vous pouvez provisionner des machines. Tenez compte des considérations de capacité, car la capacité serait consommée à partir de votre utilisation sur site.

Tous les autres objets (groupes de mise à disposition, applications, stratégies, etc.) qui utilisent ce catalogue peuvent être importés et n’ont pas besoin d’attendre la création de l’image principale. Une fois la création du catalogue terminée, des machines peuvent être ajoutées au catalogue importé, puis les utilisateurs peuvent lancer leurs ressources.

Remarque :

Utilisez les mêmes commandes disponibles dans l’outil pour migrer les catalogues et tous les autres objets.

Catalogues VDI statiques

Remarque :

Étant donné que cette opération importe des détails de bas niveau stockés dans la base de données, ce processus doit être exécuté à partir d’une machine ayant accès à la base de données.

Les catalogues VDI statiques migrent l’image principale, les configurations et toutes les machines virtuelles. Contrairement au cas d’utilisation VDI en pool, aucune image n’a besoin d’être créée.

Les VDA doivent être dirigés vers le connecteur pour qu’ils s’enregistrent auprès du cloud.

Reportez-vous à la section Activation des sites pour activer le site cloud, afin que la planification des redémarrages, la gestion de l’alimentation et d’autres éléments soient contrôlés par le cloud.

Une fois la migration terminée, si vous souhaitez supprimer ce catalogue de votre site sur site, vous devez sélectionner conserver la VM et le compte AD. Sinon, ils sont supprimés et le site cloud pointerait vers la VM supprimée.

Mettre à jour les balises MCS pour détecter les ressources orphelines après la migration

Après avoir migré une configuration sur site vers un site cloud, ou une configuration cloud vers un autre site cloud, vous devez mettre à jour les balises d’ID de site MCS dans le cas de VM persistantes afin que les ressources orphelines puissent être détectées correctement. Pour ce faire, utilisez la commande PowerShell Set-ProvResourceTags. Actuellement, cette fonctionnalité est applicable à Azure.

Les étapes détaillées sont les suivantes :

  1. Mettez à jour les balises d’ID de site MCS à partir du nouveau site Citrix à l’aide de la commande PowerShell Set-ProvResourceTags. Par exemple :
Migrer la configuration vers Citrix Cloud™
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.