Citrix Virtual Apps and Desktops Service

Migration et gestion

Si vous disposez d’une configuration Citrix Virtual Apps and Desktops Service et que vous souhaitez la déplacer vers une autre région de déploiement de Citrix Virtual Apps and Desktops Service, que vous souhaitez sauvegarder et restaurer votre configuration ou que vous avez atteint vos limites de ressources, vous pouvez désormais migrer tout ou partie de votre configuration à l’aide de l’outil de configuration automatisée Citrix.

Configuration automatisée pour Citrix Virtual Apps and Desktops

L’outil de configuration automatisée pour Citrix Virtual Apps and Desktops vous permet d’automatiser le déplacement de votre configuration locale vers votre déploiement Citrix Virtual Apps and Desktops Service.

La configuration automatisée prend également en charge le déplacement de votre configuration entre les déploiements Citrix Virtual Apps and Desktops Service. Vous pouvez également utiliser la configuration automatisée pour gérer vos déploiements.

La configuration automatisée exporte les informations de votre configuration dans un ensemble de fichiers .yml qui peuvent ensuite être éventuellement modifiés (pour préparer votre migration) et importés dans votre déploiement Citrix Virtual Apps and Desktops Service.

Télécharger l’outil de configuration automatisée

Téléchargez l’outil de configuration automatisée à partir de Téléchargements de Citrix. Pour plus d’informations, consultez Preuve de concept : Outil de configuration automatisée.

Conditions préalables à la migration de votre configuration

Pour exporter votre configuration à partir de Citrix Virtual Apps and Desktops :

  • Citrix Virtual Apps and Desktops : version actuelle et précédente ou Citrix Virtual Apps and Desktops, XenApp et XenDesktop LTSR : toutes les versions
  • Un Delivery Controller sur site et au moins un VDA local unique
  • Une machine avec .NET Framework 4.7.2 ou version ultérieure
  • Une machine avec le kit de développement logiciel Citrix PowerShell. Ceci est automatiquement installé sur le Delivery Controller. (Pour s’exécuter sur une machine autre que le Delivery Controller local, la machine doit être jointe au domaine et Citrix Studio doit être installé, car Studio installe les composants logiciels enfichables PowerShell appropriés. Le programme d’installation de Studio se trouve sur le support d’installation de Citrix Virtual Apps and Desktops.)

Pour importer votre configuration dans Citrix Virtual Apps and Desktops Service :

  • Une machine avec accès à Citrix Cloud.
  • Citrix Virtual Apps and Desktops Service provisionné avec un emplacement de ressources actif, avec Connector installé et joint au même domaine que l’installation locale.
  • Les sites accédant à Citrix Cloud doivent être autorisés. Pour plus d’informations, consultez Configuration requise pour le système et la connectivité.

Objets pris en charge pour la migration

L’outil de configuration automatisée prend en charge les composants suivants, qui sont déplacés dans le cadre du processus automatisé.

  • Balises
  • Connexions hôte
    • Un pool de ressources unique
    • Étendues d’administration
  • Catalogues de machines
    • Étendues d’administration
    • Machines
    • Accès PC distant, physiques, groupées, provisionnées (sauf MCS), attribuées
  • Groupes de mise à disposition
    • Stratégie d’accès
    • Étendues d’administration
    • Stratégie d’accès aux applications
    • Stratégie d’attribution
    • Stratégie de droit/bureau
    • Programmations d’alimentation
    • Attente de session
    • Pré-démarrage de session
    • Programmes de redémarrage
    • Balises
  • Groupes d’applications
    • Étendues d’administration
  • Applications
    • Dossiers d’application
    • Icônes
    • Applications
    • FTA configurées par le broker
    • Balises
  • Stratégies de groupe

Limitations connues

Migration d’une configuration locale vers le cloud

La configuration automatisée vous permet d’automatiser le déplacement de votre configuration locale vers un site cloud.

Exportation de votre configuration locale Citrix Virtual Apps and Desktops

  1. Installez la configuration automatisée sur votre Delivery Controller.
  2. Ouvrez PowerShell en tant qu’administrateur.
  3. Exécutez la commande suivante pour effectuer une exportation de base.

    Export-CvadAcToFile –All $true

Remarque :

D’autres commandes disponibles sont décrites ici.

Après avoir exécuté une applet de commande pour la première fois, un dossier d’exportation contenant les journaux et les fichiers de configuration .yml est créé. Le dossier se trouve sous %HOMEPATH%\Documents\Citrix\AutoConfig.

Si vous rencontrez des erreurs ou des exceptions, consultez la section Fixups du fichier journal. Pour en savoir plus sur les journaux et les informations qu’ils contiennent, reportez-vous à la section Journalisation.

Importation de votre configuration vers Citrix Virtual Apps and Desktops Service

Important :

  • Vous devez inclure votre fichier CustomerInfo.yml avec vos ID client et les informations de clé secrète. Pour savoir comment récupérer vos ID client et de votre clé secrète, reportez-vous à la section Génération des ID client et de la clé secrète. Pour plus d’informations sur l’ajout de ces informations au fichier CustomerInfo.yml, reportez-vous à la section Remplissage du fichier d’informations client.
  • Le fichier ZoneMapping.yml doit inclure des informations qui mappent votre zone locale aux emplacements de ressources dans le cloud. Pour savoir comment mapper vos zones, reportez-vous à la section Remplissage du fichier de mappage de zones.
  • Si vous disposez de connexions hôte ou d’un catalogue Citrix Provisioning, vous devez entrer les informations correspondantes dans HostSecurity.yml et CvadAcSecurity.yml.

Exécution d’une importation de base

  1. Exécutez PowerShell en tant qu’administrateur.
  2. Exécutez la commande suivante pour effectuer une importation de base.

    Merge-CvadAcToSite -All $true

Remarque :

D’autres commandes disponibles sont décrites ici.

Comparez l’état attendu avec le nouvel état actuel. Lors d’une importation Merge, l’état attendu doit être un sous-ensemble du nouvel état actuel pour que l’importation réussisse.

Après l’exécution de l’applet de commande, un dossier d’exportation contenant les journaux et les fichiers de configuration .yml est créé. Le dossier se trouve sous %HOMEPATH%\Documents\Citrix\AutoConfig.

Si vous rencontrez des erreurs ou des exceptions, consultez la section Fixups du fichier journal. Pour en savoir plus sur les journaux et les informations qu’ils contiennent, reportez-vous à la section Journalisation.

Pour revenir à votre configuration d’origine de Citrix Virtual Apps and Desktops Service, reportez-vous à la section Sauvegarde de la configuration de votre service Citrix Virtual Apps and Desktops.

Ordre d’importation et dépendance des composants

Les composants suivants sont sélectionnables dans les commandes Export, Import, Merge, New, Sync et Restore. Ils sont répertoriés dans leur ordre d’importation. L’importation dans un autre ordre peut entraîner des échecs de dépendance et provoquer l’échec de l’opération d’importation.

  1. Balises
  2. Connexions hôte
  3. Catalogues de machines
  4. Groupes de mise à disposition
  5. Groupes d’applications
  6. Applications
  7. Stratégies de groupe

Les composants doivent être importés dans un ordre qui crée des dépendances dans l’ordre dans lequel elles sont nécessaires. L’outil de configuration automatisée place les composants dans l’ordre correct lors de l’importation, de la fusion ou de la restauration de plusieurs composants avec une seule exécution de l’applet de commande.

Lors de l’importation de composants uniques avec plusieurs commandes, il est nécessaire de placer les composants afin que les dépendances soient importées dans l’ordre requis.

Des importations individuelles peuvent être effectuées pour des mises à jour après l’importation réussie d’une configuration de site complète.

Détails sur les dépendances

Les composants et leurs dépendances sont répertoriés ici. Les dépendances d’un composant doivent être en place pour qu’il puisse être importé ou fusionné. Si une dépendance est manquante, cela peut entraîner l’échec de la commande d’importation ou de fusion. La section Fixups du fichier journal affiche les dépendances manquantes en cas d’échec d’une importation ou d’une fusion.

  1. Balises
    • Aucune pré-dépendance
  2. Connexions hôte
    • Informations de sécurité dans CvadAcSecurity.yml
  3. Catalogues de machines
    • Machines présentes dans Active Directory
    • Connexions hôte
    • Balises
  4. Groupes de mise à disposition
    • Machines présentes dans Active Directory
    • Utilisateurs présents dans Active Directory
    • Catalogues de machines
    • Balises
  5. Groupes d’applications
    • Groupes de mise à disposition
    • Balises
  6. Applications
    • Groupes de mise à disposition
    • Groupes d’applications
    • Balises
  7. Stratégies de groupe
    • Groupes de mise à disposition
    • Balises

Remplissage du fichier d’informations client

L’utilisation du fichier CustomerInfo.yml élimine le besoin d’ajouter des informations client en tant que paramètres d’applet de commande. Toutes les informations client peuvent être remplacées à l’aide des paramètres de l’applet de commande.

Le fichier CustomerInfo.yml peut être créé à l’aide de l’applet de commande New-CvadAcCustomerInfoFile. New-CvadAcCustomerInfoFile a les paramètres suivants.

  • CustomerId : ID client.
  • ClientId : ID client créé sur Citrix Cloud.
  • Secret : secret du client créé sur Citrix Cloud.

New-CvadAcCustomerInfoFile -CustomerId markhof123 -ClientId 6813EEA6-46CC-4F8A-BC71-539F2DAC5984 -Secret TwBLaaaaaaaaaaaaaaaaaw==

Vous pouvez mettre à jour le fichier CustomerInfo.yml à l’aide de l’applet de commande Set-CvadAcCustomerInfoFile.

Remarque :

L’applet de commande modifie uniquement les ID client ou la clé secrète.

Set-CvadAcCustomerInfoFile -ClientId C80487EE-7113-49F8-85DD-2CFE30CC398E

Voici un exemple de fichier CustomerInfo.yml.

---
#  Created/Updated on 2020/01/29 16:46:47
CustomerId: "markhof123"
CustomerId: "markhof123"
ClientId: "6713FEA6-46CC-4F8A-BC71-539F2DDK5384"
Secret: "TwBLaaabbbaaaaaaaaaaw=="
LogFileName: "CitrixLog"
Environment: Production
AltRootUrl: ""
StopOnError: False
AlternateFolder: ""
Locale: "en-us"
Editor: “C:\Program Files\Notepad++\notepad++.exe”
Confirm: True
DisplayLog: True

Génération des ID client et de la clé secrète

Les étapes suivantes vous permettent de créer l’ID client et la clé secrète nécessaires pour importer votre configuration dans Citrix Cloud.

  1. Connectez-vous à votre compte Citrix Cloud et sélectionnez le client.

    ID client image 1

  2. Cliquez sur le menu hamburger, puis sélectionnez Gestion des identités et des accès dans le menu déroulant.

    ID client image 2

  3. Sur la page Gestion des identités et des accès, cliquez sur l’onglet Accès aux API.

    ID client image 3

  4. Entrez un nom dans la zone. Ce nom est utilisé pour différencier plusieurs ID client et clés secrètes. Cliquez sur Créer un client pour créer l’ID client et la clé secrète.

    ID client image 4

  5. La boîte de dialogue suivante s’affiche lorsque vous avez réussi à créer l’ID client et la clé secrète. Veillez à copier les deux valeurs dans un emplacement sécurisé ou téléchargez le fichier .csv contenant ces informations.

    ID client image 5

  6. L’ID client et la clé secrète sont créés avec succès.

    ID client image 6

Placez ces valeurs dans un emplacement sécurisé et ne les partagez qu’avec les membres de l’entreprise de confiance qui ont besoin d’accéder à l’outil ou aux API Rest cloud. 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.

Remarque :

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 clé secrète doivent être créés.

Remplissage du fichier de mappage de zones

La zone locale est l’équivalent de l’emplacement des ressources cloud. Contrairement aux autres composants du site, vous ne pouvez pas importer automatiquement la zone locale vers un emplacement de ressources cloud. Elle doit être mappée à l’aide du fichier ZoneMapping.yml. Des échecs d’importation peuvent se produire si le nom de la zone ne correspond pas à un nom d’emplacement de ressources existant.

Le fichier ZoneMapping.yml est créé manuellement après l’exportation de votre configuration locale, mais avant l’importation dans le cloud et doit résider dans %HOMEPATH%\Documents\Citrix\ AutoConfig. Le contenu du fichier .yml est un dictionnaire avec le nom de la zone comme clé et le nom de l’emplacement de ressources comme valeur.

Voici un exemple :

---

Primary: "My Primary Resource Location"
Zone2: "Second Resource Location"

Remarque :

Les deux-points et le nom de l’emplacement de ressources doivent être séparés par un espace.

Si le fichier ZoneMapping.yml est introuvable ou si le mappage correct n’est pas présent et que le site cloud n’a qu’une seule zone, cette zone est automatiquement utilisée pour mapper toutes les zones locales.

Migration d’une configuration cloud vers le cloud

La configuration automatisée vous permet d’automatiser le déplacement de votre configuration cloud vers un autre site cloud ou de restaurer votre propre site cloud.

Le déplacement de votre configuration Citrix Virtual Apps and Desktops Service peut être bénéfique pour de nombreuses raisons :

  • Migration d’une région à une autre
  • Synchronisation de votre site de la phase de test ou de pré-production à la production
  • Récupération d’urgence
  • Atteindre les limites de ressources

Sauvegarde de la configuration de votre service Citrix Virtual Apps and Desktops

Remarque :

Avant de commencer, suivez les étapes d’importation dans Conditions préalables à la migration de votre configuration pour migrer votre configuration d’un cloud à un autre.

Important :

  • Vous devez inclure votre fichier CustomerInfo.yml avec vos ID client et les informations de clé secrète. Pour savoir comment récupérer vos ID client et de votre clé secrète, reportez-vous à la section Génération des ID client et de la clé secrète. Pour plus d’informations sur l’ajout de ces informations au fichier CustomerInfo.yml, reportez-vous à la section Remplissage du fichier d’informations client.
  • Le fichier ZoneMapping.yml doit inclure des informations qui mappent votre zone locale aux emplacements de ressources dans le cloud. Pour savoir comment mapper vos zones, reportez-vous à la section Remplissage du fichier de mappage de zones.
  • Si vous disposez de connexions hôte ou d’un catalogue Citrix Provisioning, vous devez entrer les informations correspondantes dans HostSecurity.yml et CvadAcSecurity.yml.
  1. Installez la configuration automatisée.
  2. Exécutez PowerShell en tant qu’administrateur.
  3. Exécutez la commande suivante pour effectuer une sauvegarde de base.

    Backup-CvadAcToFile –All $true

Remarque :

D’autres commandes disponibles sont décrites ici.

Après avoir exécuté une applet de commande pour la première fois, un dossier d’exportation contenant les journaux et les fichiers de configuration .yml est créé. Le dossier se trouve sous %HOMEPATH%\Documents\Citrix\AutoConfig.

Si vous rencontrez des erreurs ou des exceptions, consultez la section Fixups du fichier journal. Pour en savoir plus sur les journaux et les informations qu’ils contiennent, reportez-vous à la section Journalisation.

Restauration de votre configuration dans Citrix Virtual Apps and Desktops Service

Remarque :

Remarque : Cette section suit la procédure Sauvegarde de la configuration de votre service Citrix Virtual Apps and Desktops et les étapes qui y sont documentées. Suivez ces étapes avant de commencer la restauration.

Exécution d’une restauration de base

  1. Exécutez PowerShell en tant qu’administrateur.
  2. Exécutez la commande suivante pour effectuer une restauration de base.

    Restore-CvadAcToSite -All $true -RestoreFolder <folder path of the backup files>

Remarque :

D’autres commandes disponibles sont décrites ici.

Comparez l’état attendu avec le nouvel état actuel.

Après l’exécution de l’applet de commande, un dossier d’exportation contenant les journaux et les fichiers de configuration .yml est créé. Le dossier se trouve sous %HOMEPATH%\Documents\Citrix\AutoConfig.

Si vous rencontrez des erreurs ou des exceptions, consultez la section Fixups du fichier journal. Pour en savoir plus sur les journaux et les informations qu’ils contiennent, reportez-vous à la section Journalisation.

Récupération d’urgence

Le processus de récupération d’urgence vous protège contre les modifications ou la corruption involontaires de la configuration du site cloud. Alors que la configuration automatisée effectue des sauvegardes à chaque fois qu’une modification est apportée, cette sauvegarde reflète l’état de la configuration du site cloud avant les modifications. Pour vous protéger, vous devez sauvegarder périodiquement la configuration de votre site cloud et l’enregistrer dans un endroit sûr. Si une modification ou une corruption indésirable a lieu, la sauvegarde peut être utilisée pour corriger la modification ou la corruption à un niveau granulaire ou complet de configuration du site.

Sauvegarde

Pour sauvegarder, exécutez l’applet de commande de sauvegarde Backup-CvadAcToFile

Bien que des composants individuels puissent être sélectionnés lors de la sauvegarde, Citrix suggère de sauvegarder tous les composants pour la récupération d’urgence. Les sauvegardes sont placées dans un dossier nommé de manière unique sous le dossier racine : %CHEMINDEBASE%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Restaurer

La restauration peut être effectuée à partir de n’importe quelle sauvegarde pour restaurer un ou plusieurs membres de composant, un ou plusieurs composants ou la configuration complète du site cloud.

Restauration des membres d’un composant

La restauration d’un ou de plusieurs membres de composant utilise la fonction IncludeByName. L’applet de commande Restore est appelée avec le paramètre RestoreFrom ainsi que le composant unique sélectionné et la liste d’inclusion.

Pour restaurer deux stratégies de groupe à partir d’une sauvegarde, suivez l’exemple suivant :

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

-GroupPolicies $true -IncludeByName Policy1,Policy2

Restauration de composants entiers

La restauration d’un composant implique la sélection d’un ou de plusieurs paramètres de composant.

Pour restaurer l’ensemble des composants Groupe de mise à disposition et Catalogue de machines, suivez cet exemple :

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

-DeliveryGroups $true -MachineCatalogs $true

Restauration de l’intégralité de la configuration du site cloud

Restaurer la configuration complète du site cloud signifie que vous sélectionnez tous les composants pour la restauration.

Pour restaurer l’intégralité de la configuration du site cloud, suivez l’exemple suivant :

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Applets de commande de l’outil de configuration automatisée

Applets de commande de la gestion de site

  • Export-CvadAcToFile - Exporte la configuration à partir de votre configuration locale. Il s’agit de l’opération d’exportation par défaut pour l’outil de configuration automatisée. Aucune modification n’est apportée à la configuration du site local. Les fichiers exportés sont placés dans le répertoire %CHEMINDEBASE%\Documents\Citrix\AutoConfig dans un sous-dossier Export à nom unique.
  • Import-CvadAcToSite - Importe tous les fichiers locaux dans le cloud. Cette commande garantit que l’état final du cloud est identique à l’état local. Cette option supprime toutes les modifications qui existent dans le cloud. Les fichiers de configuration de site importés proviennent de %CHEMINDEBASE%\Documents\Citrix\AutoConfig. Utilisez cette commande avec prudence.
  • Merge-CvadAcToSite - Fusionne les fichiers locaux dans le cloud, mais ne supprime aucun composant dans le cloud. Cela préserve les modifications déjà apportées dans le cloud. Si un composant portant le même nom existe dans Citrix Cloud, cette commande peut modifier ce composant. Il s’agit de l’opération d’importation par défaut pour l’outil de configuration automatisée. Les fichiers de configuration de site fusionnés proviennent de %CHEMINDEBASE%\Documents\Citrix\AutoConfig.
  • Restore-CvadAcToSite - Restaure la configuration précédente du site cloud. Les fichiers importés proviennent du dossier spécifié dans le paramètre -RestoreFolder. Cette commande peut être utilisée pour revenir à votre configuration précédente ou pour la reprise après sinistre de votre site cloud.
  • New-CvadAcToSite - Importe la configuration de site locale dans le cloud, mais ajoute uniquement les nouveaux composants. Les composants de site cloud existants ne sont ni mis à jour ni supprimés. Utilisez cette commande si les composants de site cloud existants doivent rester inchangés.
  • Sync-CvadAcToSite - Sync effectue à la fois une exportation et une importation en une seule étape.
  • Backup-CvadAcToFile - Exporte votre configuration cloud vers des fichiers .yml. Cette sauvegarde peut être utilisée pour revenir à une configuration précédente ou pour la reprise après sinistre.
  • Compare-CvadAcToSite - compare les fichiers .yml locaux avec la configuration cloud, produisant un rapport sur les modifications apportées par une applet de commande Import, Merge ou Restore.
  • Remove-CvadAcFromSite - Permet de réinitialiser l’intégralité du site ou de supprimer des éléments d’un composant (par exemple, supprimer un catalogue de machines de la liste des catalogues). Cette commande peut être utilisée lorsqu’elle est couplée avec le paramètre IncludeByName pour supprimer sélectivement des membres spécifiques.

Paramètres d’applet de commande de migration granulaire

Toutes les applets de commande se terminant par ToSite, ToFile et FromSite permettent la sélection d’un ou plusieurs composants sur lesquels l’action portera. Ces paramètres vous donnent une granularité supplémentaire pour migrer uniquement des composants sélectionnés. Effectuez une sélection en utilisant une ou plusieurs des options vrai/faux suivantes.

Remarque :

Si All est sélectionné, les autres paramètres sont ignorés. L’option All est automatiquement sélectionnée lorsqu’aucun composant n’est sélectionné.

  • All
  • Tags
  • MachineCatalogs
  • DeliveryGroups
  • ApplicationGroups
  • Applications
  • GroupPolicies
  • IncludeByName et ExcludeByName - Reportez-vous à la section suivante pour plus d’informations sur ces paramètres.

Filtrage par noms d’objets

Inclure et exclure

Les paramètres IncludeByName et ExcludeByName permettent d’inclure et d’exclure des membres de composants dans les applets de commande par nom. Il n’est possible de choisir qu’un seul composant (par exemple, les groupes de mise à disposition) à la fois dans les applets de commande prises en charge. Si un membre de composant se trouve dans les deux zones, l’exclusion a priorité sur tout autre paramètre et une entrée est ajoutée à la liste de correction du journal, identifiant le nom du membre (et du composant) qui a été exclu.

L’inclusion et l’exclusion sont possibles avec les applets de commande suivantes :

  • Export-CvadAcToFile
  • Import-CvadAcToSite
  • Merge-CvadAcToSite
  • New-CvadAcToSite
  • Restore-CvadAcToSite
  • Sync-CvadAcSiteToSite
  • Compare-CvadAcToSite
  • Remove-CvadAcFromSite

IncludeByName et ExcludeByName acceptent une liste des noms de membres de composants. Les noms peuvent contenir un ou plusieurs caractères génériques. Deux types de caractères génériques sont pris en charge.

  • Correspond à n’importe quel nombre de caractères
  • Correspond à un seul caractère

Exemple de fusion de tous les groupes de mise à disposition dont les noms commencent par DgSite1 et contiennent Home2 :

Merge-CvadAcToSite –DeliveryGroups $true –IncludeByName DgSite1*,*Home2*

IncludeByName et ExcludeByName peuvent également accepter un fichier contenant une liste de membres où chaque membre peut être explicite ou contenir des caractères génériques. Chaque ligne du fichier peut contenir un membre. Les espaces de début et de fin sont retirés du nom du membre. Le nom de fichier doit être précédé du signe @ et être entouré de guillemets simples (une exigence PowerShell pour que le @ ne soit pas réinterprété). Plusieurs fichiers peuvent être répertoriés en plus d’être mélangés avec des noms de membres.

Par nom du groupe de mise à disposition

ByDeliveryGroupName filtre par nom du groupe de mise à disposition pour les applications et les groupes d’applications. Ce paramètre est toujours une liste d’inclusion identifiant les membres à inclure en fonction de leur association de groupe de mise à disposition. Applets de commande prises en charge ByDeliveryGroupName :

  • Export-CvadAcToFile
  • Import-CvadAcToSite
  • Merge-CvadAcToSite
  • New-CvadAcToSite
  • Restore-CvadAcToSite
  • Sync-CvadAcSiteToSite
  • Compare-CvadAcToSite

ByDeliveryGroupName accepte une liste des noms de groupe de mise à disposition. Les noms peuvent contenir un ou plusieurs caractères génériques. Deux types de caractères génériques sont pris en charge.

  • Correspond à n’importe quel nombre de caractères
  • Correspond à un seul caractère

L’exemple suivant fusionne toutes les applications qui font référence à tous les noms de groupe de mise à disposition commençant par EastDg.

Merge-CvadAcToSite –Applications $true –ByDeliveryGroupName EastDg*

Exclude Disabled

ExcludeDisabled filtre des opérations d’importation toutes les applications et les groupes d’applications qui sont désactivés. ExcludeDisabled est false par défaut, ce qui signifie que toutes les applications et tous les groupes d’applications sont importés quel que soit leur état activé.

Paramètres des modes de migration

Les applets de commande modifiant la configuration du site cloud (Import, Restore, Merge, New et Sync) prennent en charge les paramètres supplémentaires suivants pour offrir une plus grande flexibilité.

  • CheckMode - Effectue l’opération d’importation mais n’apporte aucune modification. Toutes les modifications attendues sont signalées avant la fin de l’importation. Vous pouvez utiliser cette commande pour tester votre importation avant de l’effectuer.
  • Merge - Fusionne les données de fichier dans le cloud, mais ne supprime aucun composant. Cette option est activée par défaut dans l’applet de commande Merge, mais elle est facultative dans Import et Sync.
  • AddOnly - Ajoute uniquement des composants, ne met pas à jour ni ne supprime les composants existants. L’option AddOnly est facultative sur toutes les applets de commande sauf New, où elle est activée par défaut.
  • BackupFirst - Sauvegarde le contenu du cloud dans des fichiers .yml avant de modifier la configuration du cloud. Cette option est activée par défaut.
  • Confirm - Lorsque la valeur est true, invite les utilisateurs à confirmer qu’ils souhaitent apporter des modifications à la configuration du site cloud. L’applet de commande Remove affiche une invite en raison de sa nature destructrice. Définissez la valeur false si aucune invite n’est souhaitée, comme pour l’exécution dans des scripts automatisés. Confirm est true par défaut.
  • AdminAddress - Prise en charge des applets de commande d’exportation, permettant de cibler n’importe quel Delivery Controller depuis lequel exporter. Les SDK PowerShell Citrix appropriés doivent être installés sur la machine exécutant l’outil de configuration automatisée, comme expliqué à la section Conditions préalables à la migration de votre configuration. Les connexions hôte ne peuvent pas être exportées lorsque l’outil est exécuté sur une machine non Delivery Controller.
  • CheckAllMachines - Vérifie que toutes les machines des catalogues de machines sont présentes dans Active Directory. Si une machine n’est pas présente, elle est supprimée du catalogue de machines et une note sur la suppression est ajoutée à la liste Fixups dans le fichier journal. Cela permet d’éviter les échecs d’ajout de catalogue de machines dus à des machines non présentes. CheckAllMachines est true par défaut.

Paramètres d’accès au cloud

Toutes les applets de commande accédant au cloud, qui sont des applets de commande se terminant par ToSite ou FromSite et Get-CvadAcStatus, prennent en charge les paramètres supplémentaires suivants.

Remarque :

Ces paramètres ne sont pas nécessaires s’ils sont ajoutés au fichier CustomerInfo.yml.

  • CustomerId - ID client utilisé dans les API REST, requis pour accéder à toutes les API REST. Votre ID client se trouve dans Citrix Cloud.
  • ClientId - ID client créé sur le site Web Gestion des identités et des accès de Citrix Cloud. Ceci est nécessaire pour obtenir le jeton de porteur requis pour l’authentification de toutes les API Rest.
  • Secret - clé secrète créée sur le site Web Gestion des identités et des accès de Citrix Cloud. Ceci est nécessaire pour obtenir le jeton de porteur requis pour l’authentification de toutes les API Rest.
  • CustomerInfoFileSpec - spécification de fichier pointant vers un fichier d’informations client pour remplacer l’emplacement et le nom par défaut.
  • SiteActive — détermine si le site cloud est passif ou actif. Le site cloud est passif lorsqu’il est défini sur False et actif lorsqu’il est défini sur True. SiteActive est False par défaut, définissant le site cloud sur passif.

Applets de commande d’assistance et de dépannage

  • New-CvadAcCustomerInfoFile - Crée un fichier CustomerInfo.yml qui inclut les paramètres CustomerID, ClientID et Secret.
  • Set-CvadAcCustomerInfoFile - Permet de modifier les paramètres CustomerID, ClientID et Secret dans un fichier CustomerInfo.yml.
  • New-CvadAcTemplateToFile - Crée un fichier modèle pour les composants sélectionnés, ce qui vous permet de créer manuellement un fichier d’importation.
  • Test-CvadAcConnectionWithSite - Testez la connexion avec le site cloud pour vérifier que la connexion de communication fonctionne. Cette applet de commande utilise les paramètres d’accès au cloud ou le fichier CustomerInfo.yml pour spécifier les informations de connexion du client.
  • Find-CvadAcConnector - Localise les connecteurs existants et détermine leur état d’exécution. Cette applet de commande utilise les informations du fichier CustomerInfo.yml ou du paramètre CustomerID pour localiser les connecteurs du client.
  • Get-CvadAcCustomerSites - Renvoie la liste de tous les sites clients. Cette applet de commande utilise les paramètres d’accès au cloud ou le fichier CustomerInfo.yml pour spécifier les informations de connexion du client.
  • Get-CvadAcStatus - Get Status renvoie des informations sur l’outil et l’environnement dans lequel il s’exécute, y compris la version de l’outil, si l’utilisateur dispose des privilèges d’administrateur du site pour l’exportation, si les informations client (ID client et Secret) sont présentées, s’il est possible de communiquer avec le site, et si un ou plusieurs connecteurs sont présents.

Paramètres d’affichage du journal

Les applets de commande Export, Import, Sync, Restore, Backup, Compare et Remove affichent le fichier du journal lorsque l’opération se termine. Vous pouvez supprimer l’affichage en définissant le paramètre -DisplayLog sur $false. Notepad.exe est utilisé par défaut pour afficher le fichier journal. Vous pouvez spécifier un éditeur différent dans le fichier CustomerInfo.yml.

Editor: C:\Program Files\Notepad++\notepad++.exe

Résultats de l’état dérivé par commande

L’état dérivé peut entraîner l’une de ces trois combinaisons d’actions sur le site cloud :

  • Ajouter, mettre à jour et supprimer
  • Ajouter et mettre à jour uniquement
  • Ajouter uniquement

Le tableau suivant montre l’état dérivé de chaque applet de commande et les paramètres facultatifs qui peuvent modifier le comportement de l’état dérivé de l’applet de commande.

Commande Ajouter, mettre à jour, supprimer Ajouter, mettre à jour Ajouter
Importer -Merge $false Valeur par défaut -AddOnly $true
Merge S.O. Valeur par défaut -AddOnly $true
New S.O. S.O. Valeur par défaut
Synchroniser -Merge $false Valeur par défaut -AddOnly $true
Restaurer -Merge $false Valeur par défaut -AddOnly $true

Valeurs de retour de l’applet de commande

ActionResult

Toutes les applets de commande renvoient la valeur suivante.

public class ActionResult
{
    public bool                         Overall_Success;
    public Dictionary<string, string>   Individual_Success;
    public object                       CustomResult;
}

Overall_Success renvoie un seul booléen indiquant le succès global de l’applet de commande sur tous les composants sélectionnés : true signifie succès et false signifie échec.

Individual_Success renvoie une ou trois valeurs pour chaque composant principal. Le résultat d’un composant peut être Success, Failure ou Skipped. Skipped indique que le composant n’a pas été sélectionné pour l’exécution par l’applet de commande.

CustomResult est spécifique à l’applet de commande.

CustomResult

Import, Merge, Restore, Sync, Compare, Compare File et Remove renvoient les informations de résultat personnalisées suivantes à une seule instance de EvaluationResultData.

Remarque :

Les applets de commande Export et Template ne renvoient pas de résultat personnalisé.

    public class EvaluationResultData
    {
        public Dictionary<string, Dictionary<string, ActionResultValues >> EvaluationResults;
        public int                  Added;
        public int                  Updated;
        public int                  Deleted;
        public int                  NoChange;
        public int                  TotalChanged;
        public EvaluationResults     OverallResult;
        public string               CloudBackupFolder;
        public string               SourceBackupFolder;
    }
    Where:
    public enum ActionResultValues
    {
        Add,
        Update,
        Delete,
        Identical,
        DoNothing
    }
    public enum EvaluationResults
    {
        Success,
        Failure,
        Skipped
    }

EvaluationResults affiche une liste avec une entrée par composant sélectionné. La clé est le nom du composant et la valeur est une liste de chaque membre de composant et de l’action effectuée sur ce membre. Les actions peuvent être l’une des valeurs ActionResultValues.

Added, Updated, Deleted et NoChange indiquent le nombre total de membres de composants ajoutés, mis à jour, supprimés ou sur lesquels aucune action n’a été effectuée, dans cet ordre.

TotalChanged est la somme de Added, Updated et Deleted.

OverallResult est un booléen unique indiquant le résultat de l’applet de commande. True indique le succès total de tous les composants et false indique l’échec du traitement d’un ou de plusieurs composants.

CloudBackupFolder est la spécification de fichier complète de la sauvegarde de la configuration du site cloud avant que l’applet de commande effectue des actions de modification du cloud.

SourceBackupFolder est la spécification de fichier complète de la sauvegarde du fichier source effectuée après la fin de l’applet de commande. Par défaut, ces fichiers se trouvent sous %HOMEPATH%\Documents\Citrix\AutoConfig.

Aide

L’aide de PowerShell est disponible pour chaque applet de commande. Tous les paramètres sont documentés avec chaque applet de commande et une brève explication de l’applet de commande est également proposée. Pour accéder à l’aide d’une applet de commande, tapez Get-Help devant l’applet de commande.

Get-Help Import-CvadAcToSite

Dossiers, sauvegardes et journalisation

L’outil de configuration automatisée initialise, met à jour et sauvegarde la configuration d’un site cloud. Au fil du temps, de nombreuses configurations différentes peuvent changer sur le site cloud. Pour faciliter l’utilisation à long terme et préserver l’historique des changements, l’outil de configuration automatisée utilise un schéma de conservation pour sauvegarder cet historique et fournir une méthode pour restaurer les états antérieurs.

Dossiers

Emplacement racine du dossier par défaut

Toutes les opérations de l’outil de configuration automatisée s’effectuent dans le dossier racine ou dans les sous-dossiers qu’il contient. Le dossier racine se trouve sous %HOMEPATH%\Documents\Citrix\AutoConfig.

Exporter

Tous les fichiers exportés sont placés dans deux emplacements de dossier, ce qui offre une facilité d’utilisation et un historique des exportations. Les exportations sont toujours placées dans le dossier racine. Les copies sont placées dans un sous-dossier nommé Export avec la date et l’heure de l’exportation.

Le dossier racine contient toujours la configuration de site locale exportée la plus récente. Chaque sous-dossier Export contient l’exportation effectuée à la date et à l’heure indiquées, ce qui permet de conserver un historique des exportations. Vous pouvez utiliser n’importe quel sous-dossier Export pour configurer le site cloud. L’outil de configuration automatisée ne supprime pas et ne modifie pas les sous-dossiers d’exportation existants.

Import/Merge/Sync/Compare

Les opérations Import, Merge et Compare proviennent toujours de fichiers situés dans le dossier racine. Chaque opération entraîne la création d’un sous-dossier dans lequel les fichiers du dossier racine sont copiés, fournissant ainsi un historique des modifications des fichiers source du site cloud.

N’importe quel sous-dossier peut être utilisé pour configurer le site cloud. L’outil de configuration automatisée ne supprime pas et ne modifie pas les sous-dossiers d’exportation existants.

Restaurer

L’opération Restore utilise un sous-dossier existant pour configurer le site cloud. Le dossier source est spécifié sur le paramètre -RestoreFolder requis. Contrairement aux autres commandes, aucun nouveau sous-dossier n’est créé car l’opération Restoreutilise un sous-dossier existant. Le dossier de restauration peut être le dossier racine mais doit toujours être spécifié sur le paramètre -RestoreFolder.

Sauvegarde

Les sauvegardes de configuration de site cloud sont toujours effectuées dans un sous-dossier nommé Backup avec les données et l’heure de la sauvegarde. L’outil de configuration automatisée ne supprime pas et ne modifie pas les sous-dossiers d’exportation existants.

Vous pouvez utiliser les sauvegardes pour restaurer des composants spécifiques ou l’intégralité de votre configuration. Pour restaurer l’ensemble des composants Groupe de mise à disposition et Catalogue de machines, utilisez l’applet de commande :

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups $true -MachineCatalogs $true

Remarque :

Les informations du fichier de sauvegarde de l’applet de commande précédente sont basées sur vos propres sauvegardes.

Pour restaurer l’intégralité de la configuration du site cloud, utilisez l’applet de commande :

Restore-CvadAcToSite -RestoreFrom %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

Remarque :

Les informations du fichier de sauvegarde de l’applet de commande précédente sont basées sur vos propres sauvegardes.

Modification du dossier racine par défaut

Les opérations Export, Import, Merge, Sync et Compare peuvent modifier le dossier racine par défaut à l’aide du paramètre –AlternateFolder. La création et la gestion des sous-dossiers par opération restent les mêmes que celles décrites précédemment.

Fichiers copiés dans des sous-dossiers

Tous les fichiers ayant une extension « .yml » sont copiés dans les sous-dossiers d’opération, à l’exception des éléments suivants :

  • CustomerInfo.yml
  • ZoneMapping.yml
  • HostSecurity.yml

Sauvegardes automatisées de site cloud en mode sans échec

Une sauvegarde de la configuration actuelle du site cloud est effectuée avant d’exécuter les opérations qui modifient la configuration. Cela inclut les paramètres Import, Merge, Sync et Restore. La sauvegarde se trouve toujours dans un sous-dossier situé sous le sous-dossier opérationnel.

Dans le cas de Restore, le dossier de sauvegarde est un sous-dossier du dossier spécifié sur le paramètre -RestoreFrom.

Journalisation

L’exécution d’une applet de commande entraîne la création d’un fichier journal et d’une entrée dans le fichier journal de l’historique principal. Tous les fichiers journaux d’opérations sont placés dans un dossier de sauvegarde. Tous les noms de fichiers journaux commencent par CitrixLog, puis affichent l’opération de configuration automatique ainsi que l’horodatage de l’exécution de l’applet de commande. Les journaux ne sont pas supprimés automatiquement.

Le journal de l’historique principal se trouve sous %HOMEPATH%\Documents\Citrix\AutoConfig, dans le fichier History.Log. Chaque exécution de l’applet de commande entraîne une entrée de journal principal contenant la date, l’opération, le résultat, la sauvegarde et les emplacements du fichier journal de l’exécution.

Détails de la journalisation

Chaque fichier journal comprend les éléments suivants :

  • Nom de l’opération et si le mode de vérification est activé
  • Date et heure de début et de fin
  • Entrées multiples pour les actions et les notifications de réussite/échec de chaque composant
  • Résumé des actions effectuées, y compris les différents dénombrements d’objets créés
  • Corrections suggérées, le cas échéant
  • Emplacement du dossier de sauvegarde, le cas échéant
  • Emplacement du journal principal
  • Durée

Fichiers de diagnostic

Les fichiers de diagnostic vous aident à déterminer et à résoudre les problèmes. Les fichiers suivants sont créés lors de l’exécution de leur opération. Ils se trouvent dans le sous-dossier spécifique à l’action sous %HOMEPATH%\Documents\Citrix\AutoConfig. Incluez ces fichiers lorsque vous fournissez des informations à l’équipe d’assistance pour la résolution de problèmes.

Exporter

PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1

Ce fichier énumère tous les appels SDK PowerShell de Broker effectués pour exporter la configuration du site vers des fichiers.

Import, Merge, Restore, Sync, Backup, Compare

Transaction_yyyy_mm_dd_hh_mm_ss.txt

Ce fichier documente chaque appel d’API Rest et les informations connexes.

RestApiContent_yyyy_mm_dd_hh_mm_ss.txt

Ce fichier contient tout le contenu de l’API Rest Add, Update et Delete.

Informations supplémentaires

Importation d’autres objets lorsque vous disposez de catalogues de machines Machine Creation Services

Actuellement, l’outil de configuration automatisée ne prend pas en charge l’importation automatisée de catalogues de machines MCS ou de leurs groupes de mise à disposition correspondants. Toutefois, vous pouvez toujours importer d’autres options de configuration telles que des applications et des stratégies à l’aide de l’outil de configuration automatisée. Vous devez créer le catalogue de machines et le groupe de mise à disposition en utilisant le même nom que la configuration locale. Suivez les étapes de préparation de votre environnement avant de procéder à l’importation des paramètres de l’application :

  1. Dans votre portail Citrix Cloud, cliquez sur le menu hamburger et accédez à Mes services > Virtual Apps and Desktops Service > Gérer. Créez votre catalogue de machines MCS comme vous le feriez normalement. Veillez à nommer votre catalogue exactement de la même manière que votre catalogue local existant.

  2. Créez le groupe de mise à disposition correspondant pour le nouveau catalogue. Assurez-vous de le nommer exactement comme le groupe de mise à disposition local correspondant.

  3. Dans l’interface Citrix Studio de votre environnement local, dans le nœud Applications, vérifiez que les applications appartiennent aux groupes de mise à disposition correspondants en sélectionnant l’application, en cliquant avec le bouton droit de la souris sur l’application et en accédant à Propriétés.

  4. Cliquez sur Groupes pour confirmer les groupes auxquels appartient l’application :

    ID client image 8

  5. Dans PowerShell, exécutez la commande Merge et utilisez l’indicateur byDeliveryGroupName, qui filtre les applications par nom de groupe de mise à disposition.

    Merge-CvadAcToSite –Applications $true –ByDeliveryGroupName <DG_name>

    ID client image 9

  6. Tapez Oui pour continuer.

    ID client image 10

  7. Sur votre console Studio dans Citrix Cloud, accédez à Applications et actualisez pour vous assurer que les applications sont répertoriées comme prévu. Sélectionnez les applications et accédez à Propriétés de l’application > Groupes pour vérifier.

Importation de stratégies liées à MCS

Si vous devez importer des stratégies associées à vos catalogues ou groupes MCS, suivez les instructions suivantes :

  1. Exécutez la commande Merge-CvadAcToSite -GroupPolicies $true dans PowerShell et tapez yes pour continuer.

    ID client image 13

    L’exécution réussie affiche une sortie similaire à la capture d’écran précédente (Added values, Valeurs ajoutées). La capture d’écran suivante montre le résultat d’une ligne pour laquelle il n’y a pas eu de modifications (No Change, Pas de changement).

    ID client image 14

  2. Actualisez la fenêtre Studio dans Citrix Cloud et cliquez sur Policies à gauche.

  3. Vérifiez l’onglet Assigned to dans Policies et comparez-le avec votre affectation de stratégie locale.

Migration vers Citrix Cloud Government

L’environnement Citrix Cloud Government utilise différents points d’accès pour authentifier et allouer des jetons d’accès. Cette exigence unique s’applique à tout outil de configuration automatisée accédant au cloud. Effectuez la procédure suivante pour utiliser la configuration automatisée dans les environnements Citrix Cloud Government.

  1. Dans le dossier %CHEMINDEBASE%\Documents\Citrix\AutoConfig, modifiez CustomerInfo.yml.
  2. Ajoutez la ligne suivante à CustomerInfo.yml (ou modifiez-la, si elle est déjà présente)

    Environment: "ProductionGov"

La configuration automatisée peut désormais être utilisée sur les environnements Citrix Cloud Government.

Étendues d’administrateur

Les processus d’exportation et d’importation prennent en charge les étendues d’administrateur. Toutefois, le processus d’importation ne peut qu’associer l’étendue, et non la créer. Procédez comme suit pour exporter et importer des étendues d’administrateur vers le site cloud.

  1. Exportez le site local.
  2. Dans Citrix Studio local, accédez à l’onglet Configuration > Administrateurs > Étendues et prenez note de toutes les étendues présentes. Il n’est pas nécessaire de noter leurs associations car elles sont créées lors de l’importation des composants.
  3. Dans la console Citrix Cloud, accédez à l’onglet Configuration > Administrateurs > Étendues et créez manuellement chaque étendue enregistrée à l’étape précédente.
  4. Vous pouvez appliquer les opérations Import, Merge, Restore, New ou Sync à l’exportation à partir de l’étape 1.
  5. Les étendues créées manuellement sont associées aux composants corrects.

Si les étendues d’administrateur ne sont pas créées manuellement en premier lieu, l’opération d’importation supprime les étendues des composants. Une fois les étendues créées manuellement, la réexécution de l’opération d’importation associe les étendues aux composants.

Connexions hôte

Les connexions hôtes et les hyperviseurs associés peuvent être exportés et importés à l’aide de la configuration automatisée.

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

Le processus d’exportation crée le fichier HostSecurity.yml sous %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 HostSecurity.yml avant l’importation dans le site cloud. Les mises à jour de l’administrateur sont conservées pour plusieurs exportations avec de nouveaux espaces réservés de sécurité ajoutés au besoin. Les éléments de sécurité ne sont jamais supprimés.

---

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 texte clair
  • Microsoft Azure
    • ID d’abonnement
    • ID de l’application
    • Secret d’application
  • Amazon Web Services
    • ID du compte de service
    • Secret d’application
    • Région

Considérations de sécurité particulières

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

Automatisation

Les applets de commande de l’outil configuration automatisée peuvent être exécutées dans des scripts d’automatisation sans intervention de l’administrateur en supprimant les invites et l’affichage des résultats du journal à la fin de l’applet de commande. Vous pouvez également définir des paramètres pour faire de même à l’aide du fichier CustomerInfo.yml.

Ajoutez le paramètre suivant aux applets de commande de modification du cloud pour supprimer l’affichage des invites.

-Confirm $false

Ajoutez le paramètre suivant aux applets de commande pour supprimer l’affichage du journal à la fin de l’applet de commande.

-DisplayLog $false

Une autre méthode consiste à placer les paramètres suivants dans le fichier CustomerInfo.yml.

Confirm: False

DisplayLog: False

Exportation à partir d’ordinateurs autres que le Delivery Controller

L’outil de configuration automatisée utilise plusieurs SDK PowerShell Citrix pour exporter la configuration de site local vers des fichiers. Ces SDK sont automatiquement installés sur le Delivery Controller, ce qui permet à l’outil de s’exécuter sur le Delivery Controller sans actions supplémentaires. Lors de l’exécution sur des machines non Delivery Controller, il est nécessaire d’installer l’ensemble de SDK PowerShell Citrix requis par l’outil. Cet ensemble de SDK fait partie de Citrix Studio qui peut être installé à partir du support d’installation Citrix Virtual Apps and Desktop.

Remarque :

Les connexions hôtes ne peuvent pas être exportées depuis une machine non Delivery Controller.

L’outil de configuration automatisée ne peut pas être exécuté sur le Cloud Connector.

Collecte de données Citrix Cloud

Pour en savoir plus sur les informations collectées par Citrix Cloud, reportez-vous à la section Gestion du contenu client et des journaux de Citrix Cloud Services.

Dépannage et recommandations

Pour obtenir des informations de dépannage et d’assistance plus détaillées et à jour, consultez l’article du Centre de connaissances CTX277730.

Pour un dépannage rapide, consultez le fichier journal, en particulier la section Fixups.

Problèmes résultant des dépendances

Les importations et les fusions peuvent échouer en raison de dépendances manquantes. Voici quelques problèmes courants :

  1. Des filtres de groupe de mise à disposition manquent dans les stratégies de groupe. C’est en général parce que des groupes de mise à disposition n’ont pas été importés.
  2. Échec de l’importation ou de la fusion des applications. C’est en général parce que des groupes de mise à disposition manquent ou des groupes d’applications n’ont pas été importés.
  3. Il manque un RestrictToTag dans les groupes d’applications. C’est en général parce que des balises n’ont pas été importées.
  4. Les connexions d’hôte échouent. C’est en général parce que des informations de sécurité manquent dans le fichier CvadAcSecurity.yml.
  5. Les catalogues de machines échouent. C’est en général parce que des connexions d’hôte n’ont pas été importées.
  6. Machines manquantes dans des catalogues de machines et des groupes de mise à disposition. C’est en général parce que des machines n’ont pas été trouvées dans Active Directory.
  7. Utilisateurs manquants dans des groupes de mise à disposition. C’est en général parce que des utilisateurs sont introuvables dans Active Directory.

Problèmes courants

Le site cloud est vide

Un site vide indique qu’une opération d’importation/fusion/restauration réussie n’est pas terminée. Si une opération a été tentée, vérifiez les journaux de l’opération.

Le site cloud contient plus d’éléments que prévu

Cela peut se produire si des améliorations ont été apportées à la configuration du site cloud et qu’une opération Merge a été exécutée. Cela peut également se produire si la configuration du site cloud comportait d’anciennes valeurs et qu’une opération d’importation/fusion/restauration a rencontré des problèmes. Essayez de relancer l’opération.

Le site cloud contient moins d’éléments que prévu

Cela peut se produire si des améliorations ont été apportées à la configuration du site cloud et avec une opération Import avec le paramètre Merge défini sur $false, entraînant un état dérivé identique. L’état d’origine est sauvegardé dans le dossier Automated Fail-Safe Site Backup associé à l’opération d’importation. Pour corriger ce problème :

  1. Restaurez les sauvegardes automatisées de site cloud en mode sans échec à l’aide de l’opération Restore en définissant le paramètre RestoreFolder sur le dossier Automated Fail-Safe Site Backup.

  2. Utilisez l’opération Merge au lieu de l’opération Import.

Modifications de site cloud après la perte d’une importation

Cela peut se produire si une opération Import a été effectuée avec le paramètre –Merge défini sur $false, ce qui entraîne une importation d’état dérivé identique. L’état d’origine est sauvegardé dans le dossier Automated Fail-Safe Site Backup associé à l’opération d’importation. Pour corriger ce problème :

  1. Restaurez les sauvegardes automatisées de site cloud en mode sans échec à l’aide de l’opération Restore en définissant le paramètre RestoreFolder sur le dossier Automated Fail-Safe Site Backup.

  2. Utilisez l’opération Merge au lieu de l’opération Import.

Le site cloud ne correspond pas au site local actuel

Cela peut se produire lorsqu’une opération Merge a été effectuée, entraînant un état dérivé fusionné au lieu d’une opération Import avec le paramètre Merge défini sur $false entraînant un état dérivé identique. Répétez l’opération Import avec le paramètre Merge défini sur $false.

Recommandations

  • N’exécutez pas plus d’une instance de l’outil de configuration automatisée à la fois. L’exécution de plusieurs instances simultanées produit des résultats imprévisibles sur le site cloud. Si cela se produit, réexécutez une instance de l’outil de configuration automatisée pour amener le site à l’état attendu.
  • Ne fonctionne pas dans Web Studio ou Configuration complète lors de l’exécution de l’outil de configuration automatisée. Les modifications apportées à Web Studio ou à Configuration complète lors de l’exécution de l’outil de configuration automatisée peuvent produire des résultats imprévisibles sur le site cloud. Si cela se produit, réexécutez une instance de l’outil de configuration automatisée pour amener le site à l’état attendu.
  • Vérifiez toujours visuellement les résultats de fusion/importation/restauration dans Web Studio ou Configuration complète pour vous assurer que le site cloud répond aux attentes.

Plus d’informations