Documentation produit
Citrix DaaS™
Voir PDF

Créer des catalogues à l’aide d’images préparées dans AWS EC2

September 3, 2026
Contributeur: 
C C

Créez des images préparées et utilisez-les pour créer un catalogue de machines MCS à l’aide de :

  • Studio
  • Commandes PowerShell

Les étapes clés pour créer un catalogue de machines MCS à l’aide de l’image préparée sont les suivantes :

  1. Créez la définition d’image et les versions initiales de l’image.
  2. Utilisez la version de l’image comme image préparée pour créer un catalogue

Créer une définition d’image et une version initiale de l’image

Utiliser Studio

Pour créer une définition d’image et la version initiale de l’image, procédez comme suit :

  1. Dans Studio, accédez au nœud Images et cliquez sur Créer une définition d’image. Cliquez sur Suivant sur la page Introduction.
  2. Sur la page Définition d’image, spécifiez le type de système d’exploitation et le type de session pour la définition d’image.

  3. Sur la page Image, sélectionnez les Ressources (seules les ressources applicables à la connexion définie sont répertoriées), une image principale à utiliser comme modèle pour la création de la version de l’image, et un profil de machine pour capturer les propriétés matérielles. Sélectionnez un profil de machine pour capturer les propriétés matérielles à partir d’une instance de VM ou d’une version de modèle de lancement.

    Remarque :

    • Avant de sélectionner une image, vérifiez que l’image principale a VDA 2311 ou une version ultérieure installée et que le pilote MCSIO est installé sur le VDA.
    • Le service de métadonnées d’instance (IMDS) V1 et V2 sont tous deux pris en charge.
  4. Sur la page Spécification de la machine, sélectionnez une taille de machine. La taille de machine du profil de machine (sélectionné sur la page Image) est sélectionnée par défaut.
  5. Sur la page Cartes réseau, sélectionnez ou ajoutez des cartes réseau pour l’image de préparation. Pour chaque carte réseau, sélectionnez un sous-réseau VPC associé.
  6. Sur la page Description de la version, saisissez une description pour la version initiale de l’image créée.
  7. Sur la page Résumé, vérifiez les détails de la définition d’image et de la version initiale de l’image créée. Saisissez un nom et une description pour la définition d’image. Cliquez sur Terminer.

Créer des versions d’image

Les versions d’image permettent la gestion de différentes itérations ou mises à jour d’une image particulière. Cette fonctionnalité vous permet de maintenir plusieurs versions d’une image à des fins différentes.

Pour créer des versions d’image à partir de la version initiale de l’image, procédez comme suit :

Remarque :

L’unité d’hébergement de toutes les versions d’image doit être la même.

  1. Accédez au nœud Images, sélectionnez une version d’image ou une définition d’image, puis cliquez sur Créer une version d’image.
  2. Sur la page Définition d’image, vous pouvez modifier l’unité d’hébergement et resélectionner l’image principale et le profil de machine pour cette version d’image.
  3. Si vous souhaitez que la configuration de la version d’image soit différente de la version d’image configurée initialement, configurez les paramètres sur les pages Spécification de la machine et Cartes réseau de la boîte de dialogue Créer une version d’image.
  4. Ajoutez une description pour la version d’image. Cliquez sur Terminer.

Remarque :

Si la création de la version d’image échoue pour une raison quelconque, l’onglet Dépannage en bas fournit une option Réessayer.

Utiliser PowerShell

Les commandes PowerShell détaillées pour créer une spécification de version d’image préparée sont les suivantes :

  1. Vérifiez les noms de définition d’image disponibles à l’aide de Test-ProvImageDefinitionNameAvailable command. Par exemple,

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

  2. Créez une définition d’image à l’aide de la commande New-ProvImageDefinition. Par exemple,

    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
<!--NeedCopy-->

  3. Créez une nouvelle configuration pour la définition d’image dans la connexion d’hébergement spécifiée à l’aide de la commande Add-ProvImageDefinitionConnection.

    Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn
<!--NeedCopy-->

  4. Créez une version d’image à l’aide de la commande New-ProvImageVersion. Par exemple,

    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
<!--NeedCopy-->

  5. Ajoutez une spécification de version d’image principale à la version d’image à l’aide de la commande Add-ProvImageVersionSpec. Par exemple,

    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName aws -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”"
<!--NeedCopy-->

    Remarque :

    Vous ne pouvez ajouter qu’une seule spécification de version d’image principale à une version d’image pour une unité d’hébergement.

  6. Créez une spécification de version d’image préparée à partir de la spécification de version d’image principale à l’aide de la commande New-ProvImageVersionSpec. Le paramètre SourceImageVersionSpecUid est dérivé de la commande Add-ProvImageVersionSpec. Par exemple,

    New-ProvImageVersionSpec
-SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
-MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously
<!--NeedCopy-->

Exemple de l’ensemble complet des commandes PowerShell pour créer une définition d’image, une version d’image et une spécification de version d’image préparée :

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession


Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName aws-CustomProperties $CustomProperties

$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"

$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”

New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName aws
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid
<!--NeedCopy-->

Remarque :

  • Toutes les spécifications de version d’image dans une définition d’image doivent appartenir à la même unité d’hébergement.
  • Une version d’image ne peut avoir qu’une seule spécification de version d’image principale et une seule spécification de version d’image préparée.
  • Toutes les spécifications de version d’image doivent avoir un profil de machine.

Partager des images préparées entre les zones de disponibilité et les régions

Vous pouvez désormais partager une seule image préparée entre différentes zones de disponibilité, liées à différentes unités d’hébergement, au sein de la même région AWS ou dans différentes régions pour vos environnements AWS EC2. Cela vous permet d’utiliser une image préparée pour créer et mettre à jour des catalogues de machines MCS dans diverses zones de disponibilité et régions. Lors du partage entre différentes zones de disponibilité dans différentes régions, la version de l’image préparée sera copiée de la région d’origine vers les régions de destination.

Vous pouvez maintenir une seule image préparée et l’utiliser pour créer et mettre à jour des catalogues de machines dans plusieurs zones de disponibilité et régions liées à différentes unités d’hébergement. Cela réduit considérablement la surcharge de gestion de vos images, assure la cohérence entre les déploiements et rationalise le processus de provisionnement. Vous pouvez également mettre à jour de manière transparente les catalogues de machines existants avec des images préparées provenant d’une zone de disponibilité ou d’une région différente.

Cas d’utilisation

  • Gestion centralisée des images : Vous créez une image préparée dans une zone de disponibilité (par exemple, us-east-1a). Vous pouvez ensuite partager cette image avec d’autres zones de disponibilité comme us-east-1b au sein de la même région AWS us-east-1 ou us-west-1a dans une région us-west-1 différente. Cela permet à une seule image de servir plusieurs unités d’hébergement et vous simplifie la maintenance.
  • Création et mises à jour efficaces des catalogues : Vous pouvez utiliser une image préparée créée dans AZ 1 (par exemple, us-east-1a) pour créer de nouveaux catalogues dans AZ 1. Après avoir partagé cette image avec AZ 2 (par exemple, us-east-1b), vous pouvez ensuite utiliser l’image partagée dans AZ 2 pour créer et mettre à jour des catalogues dans AZ 2.
  • Déploiements entre unités d’hébergement et connexions d’hébergement : Si votre environnement comporte plusieurs unités d’hébergement dans les mêmes régions AWS ou dans des régions différentes, vous pouvez partager efficacement les images préparées entre ces unités d’hébergement.

Limitations

Partage au sein du même compte AWS : Dans l’implémentation actuelle, vous ne pouvez partager qu’au sein du même compte AWS.

Considérations importantes

  • Ordre de suppression : Pour supprimer une spécification de version d’image préparée originale, vous devez d’abord supprimer toutes ses spécifications de version d’image partagées. Alternativement, vous devez supprimer les spécifications originales et partagées simultanément.
  • Dépendance de la version d’image : Lorsque vous supprimez une version d’image, vous devez d’abord supprimer toutes les configurations de partage qui dépendent de cette version d’image spécifique. Les catalogues que vous avez créés à partir de l’image originale (non partagée) peuvent rester intacts.
  • Rétrocompatibilité des catalogues : Vous pouvez mettre à jour les catalogues de machines existants que vous avez déployés avant l’introduction de cette fonctionnalité. Utilisez des images préparées que vous avez créées dans une zone de disponibilité ou une région différente de celle où vous avez initialement déployé le catalogue.
  • Suppression complète : Lorsque vous supprimez une image préparée, vous ne pouvez plus l’utiliser dans aucune zone de disponibilité où vous l’avez partagée ou créée à l’origine. De plus, une version d’image préparée ne peut pas être supprimée tant que tous les catalogues liés à cette version d’image préparée n’ont pas été supprimés au préalable.

Prérequis

Avant de configurer ou d’utiliser cette fonctionnalité, assurez-vous de remplir les conditions suivantes :

  • Votre environnement doit être un environnement AWS EC2.
  • Vous devez configurer plusieurs unités d’hébergement (chacune pouvant être liée à différentes zones de disponibilité) et connexions d’hôte (chacune pouvant être liée à une région différente) sous le même compte AWS.

Configurer à l’aide de PowerShell

Vous pouvez actuellement partager des images préparées entre des zones de disponibilité liées à différentes unités d’hébergement en utilisant uniquement des commandes PowerShell.

Pour partager une image préparée

  1. Assurez-vous de disposer de l’ImageVersionSpecUid de l’image préparée que vous souhaitez partager. Vous pouvez la récupérer à l’aide de Get-ProvImageVersionSpec ou de commandes Get- similaires dans PowerShell.
  2. Déterminez le HostingUnitName de la zone de disponibilité (peut être la même région ou une région différente) où vous souhaitez rendre l’image préparée disponible. Il s’agit du nom de l’unité d’hébergement que vous avez configurée pour cette zone de disponibilité spécifique.

  3. Exécutez la commande Add-ProvImageVersionSpecHostingUnit : Utilisez la commande PowerShell suivante. Remplacez <ImageVersionSpecUid> par l’Uid de votre image et <targetHostingUnitName> par le nom de l’unité d’hébergement dans la zone de disponibilité cible avec laquelle vous souhaitez partager la spécification de version d’image :

    Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->
  4. Après une exécution réussie, vous pouvez voir le statut de l’image dans l’interface utilisateur de Studio, indiquant que vous l’avez partagée avec l’unité d’hébergement spécifiée.

Pour supprimer le partage d’une image préparée

  1. Assurez-vous de disposer de l’ImageVersionSpecUid de l’image préparée dont vous souhaitez supprimer le partage.
  2. Déterminez le HostingUnitName de la zone de disponibilité à partir de laquelle vous souhaitez supprimer l’image partagée.

  3. Exécutez la commande Remove-ProvImageVersionSpecHostingUnit : Utilisez la commande PowerShell suivante. Remplacez <ImageVersionSpecUid> par l’Uid de votre image et <targetHostingUnitName> par le nom de l’unité d’hébergement dans la zone de disponibilité cible à partir de laquelle vous souhaitez supprimer le partage de la spécification de version d’image :

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->

Créer un catalogue de machines

Utiliser Studio

Créer un catalogue de machines à partir du nœud Images

Utilisez l’option Créer un catalogue dans le nœud Images pour créer un catalogue à l’aide de la version de l’image.

Vous pouvez également sélectionner la version lors de la création d’un catalogue dans le nœud Catalogues de machines, en la liant à l’option d’image préparée dans le flux de travail de création de catalogue. Voir Créer un catalogue de machines à partir du nœud Catalogues de machines.

Pour créer un catalogue de machines MCS à partir du nœud Images, procédez comme suit :

  1. Sélectionnez une version d’image et cliquez sur Créer un catalogue. Cliquez sur Suivant sur la page Introduction.
  2. Sur les pages Gestion des machines et Image, les paramètres sont présélectionnés en fonction de la version d’image sélectionnée. Sur la page Image, saisissez une note pour l’image préparée sélectionnée.
  3. Renseignez les paramètres sur les pages suivantes.
  4. Sur la page Résumé, vérifiez les détails du catalogue de machines. Saisissez un nom et une description pour le catalogue de machines. Cliquez sur Terminer.
  5. Accédez au nœud Catalogues de machines pour afficher le catalogue de machines créé.

Créer un catalogue de machines à partir du nœud Catalogues de machines

Pour créer un catalogue de machines MCS à partir du nœud Catalogues de machines, procédez comme suit :

  1. Cliquez sur Catalogues de machines dans le volet de navigation de gauche.
  2. Cliquez sur Créer un catalogue de machines. La page Configuration du catalogue de machines apparaît.
  3. Sur la page Type de machine, sélectionnez un type de machine pour le catalogue, par exemple, SE multi-session.

  4. Sur la page Gestion des machines, sélectionnez les paramètres suivants :

    1. Sélectionnez Machines gérées par l’alimentation (par exemple, machines virtuelles ou PC lames).
    2. Sélectionnez Technologie de provisioning Citrix. Ensuite, sélectionnez Citrix Machine Creation Services™.
    3. Dans le champ Ressources, sélectionnez les ressources (zone de disponibilité) que vous avez configurées lors de la création de la connexion d’hôte, puis cliquez sur Suivant.
  5. Sur la page Expérience de bureau, sélectionnez un bureau aléatoire ou statique que les utilisateurs doivent avoir lorsqu’ils se connectent. Si un bureau statique est sélectionné, spécifiez si vous souhaitez enregistrer les modifications apportées par l’utilisateur sur le disque local (persistant ou non persistant).

  6. Sur la page Image, cliquez sur Sélectionner une image pour sélectionner une image préparée pour le catalogue de machines. Sélectionnez la version préparée que vous avez créée. Cliquez sur le nom de la version de l’image. Pour afficher plus de détails sur la version d’image sélectionnée, cliquez sur le numéro de version, qui est souligné. Cliquez sur Terminé.

    Le profil de machine associé à l’image préparée apparaît et ses propriétés matérielles (par exemple, type d’instance, type de location, mappages réseau, groupes de sécurité, propriétés de volume) sont utilisées pour créer des machines dans les catalogues. Pour modifier la source du profil de machine vers une autre machine virtuelle ou version de modèle de lancement, cliquez sur le bouton de modification.

  7. Sur la page Machines virtuelles :

    1. Saisissez le nombre de machines virtuelles pour le catalogue.
    2. La spécification de machine par défaut est affichée, basée sur le profil de machine. Pour la modifier, sélectionnez l’icône de modification et sélectionnez une spécification de machine.
  8. Sur la page Cartes réseau, sélectionnez les cartes réseau (ou ENI) pour les machines virtuelles.
  9. Sur la page Identités de machine, configurez Active Directory local ou Microsoft Entra joint de manière hybride pour les machines du catalogue en sélectionnant le domaine et en créant de nouveaux comptes AD pour les machines virtuelles à créer dans ce catalogue de machines. Les machines virtuelles provisionnées sont jointes au domaine sélectionné. Spécifiez le schéma de nommage des comptes pour les nouveaux comptes AD à créer pour les machines virtuelles. Cliquez sur Suivant.
  10. Sur la page Informations d’identification de domaine, cliquez sur Saisir les informations d’identification pour fournir les informations d’identification du domaine sélectionné. Saisissez le nom d’utilisateur et le mot de passe de niveau administrateur lorsque vous y êtes invité. Vous pouvez également utiliser un compte de service si vous avez déjà enregistré des informations d’identification de domaine en suivant notre (/fr-fr/citrix-daas/install-configure/on-premises-ad-service-accounts).
  11. Parcourez les pages restantes jusqu’à la page Résumé. Saisissez un nom pour le catalogue de machines et sélectionnez Terminer pour créer le catalogue de machines.

Utiliser PowerShell

Créer un catalogue à l’aide d’une spécification de version d’image préparée et d’un profil de machine

  • Créez un catalogue de machines non persistantes MCS à partir de la spécification de version d’image préparée à l’aide de la commande New-ProvScheme. Par exemple,

     New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
 <!--NeedCopy-->

  • Créez un catalogue de machines persistantes MCS à partir de la spécification de version d’image préparée à l’aide de la commande New-ProvScheme. Par exemple,

     New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
 <!--NeedCopy-->

Exemple de l’ensemble complet de commandes PowerShell pour créer un catalogue :

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "awscatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "domainname" -IdentityPoolName "awscatalog" -IdentityType "ActiveDirectory"  -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

$Task = New-ProvScheme -ProvisioningSchemeName awscatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName aws -IdentityPoolName awscatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously

Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName awscatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Où aller ensuite

Plus d’informations

Créer des catalogues à l’aide d’images préparées dans AWS EC2
September 3, 2026
Contributeur: 
C C
September 3, 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.