Documentation produit
Citrix DaaS™
Voir PDF

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

May 4, 2026
Contributeur: 
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 d’image initiales.
  2. Utilisez la version d’image comme image préparée pour créer un catalogue.

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

Utiliser Studio

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

  1. Dans Studio, accédez au nœud Images, puis 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 d’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.
    • Les services 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ée 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, entrez une description pour la version d’image initiale créée.
  7. Sur la page Résumé, vérifiez les détails de la définition d’image et de la version d’image initiale créée. Entrez 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 de gérer 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 d’image initiale, 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 initialement configurée, 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 la commande Test-ProvImageDefinitionNameAvailable. 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

    ```

Exemple de l’ensemble complet de 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 charge 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 la même région 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 spécifique à une région : Vous ne pouvez partager des images préparées qu’entre les zones de disponibilité au sein de la même région AWS. Dans l’implémentation actuelle, vous ne pouvez pas les partager entre différentes régions AWS ou différents comptes AWS.

Considérations importantes

  • Ordre de suppression : Pour supprimer une spécification de version d’image préparée d’origine, vous devez d’abord supprimer toutes ses spécifications de version d’image partagées. Vous pouvez également supprimer les spécifications d’origine 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 d’origine (non partagée) peuvent rester intacts.
  • Rétrocompatibilité du catalogue : 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.

Conditions préalables

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é (qui 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 annuler 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 annuler le partage.
  1. Déterminez le HostingUnitName de la zone de disponibilité à partir de laquelle vous souhaitez supprimer l’image partagée.

  2. 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 annuler 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 d’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. Consultez 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. Remplissez 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 voir 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 s’affiche.
  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 vous souhaitez que les utilisateurs aient 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 VM ou version de modèle de lancement, cliquez sur le bouton de modification.

  7. Sur la page Machines virtuelles :

    1. Saisissez le nombre de VM 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 VM.
  9. Sur la page Identités de machine, configurez Active Directory sur site 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 VM à créer dans ce catalogue de machines. Les VM 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 VM. Cliquez sur Suivant.
  10. Sur la page Informations d’identification du 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 documentation produit.
  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 MCS non persistant à 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 MCS persistant à 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-->

Étapes suivantes

Plus d’informations

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