Documentation produit
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Voir PDF

Créer une image préparée pour les instances gérées Amazon WorkSpaces Core

April 8, 2026
Contributeur: 
C C

  • Créez des images préparées pour créer un catalogue de machines MCS. Vous pouvez créer des images préparées à l’aide des éléments suivants :

  • Web Studio
  • Commandes PowerShell

Étapes clés

  1. Créez la définition d’image et les versions d’image initiales.
  2. Créez des versions d’image à partir de la version d’image initiale.

Utiliser Web Studio

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

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

  1. Dans Web 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 machine virtuelle ou d’une version de modèle de lancement.

    Remarque :

    • Avant de sélectionner une image, vérifiez que l’image principale dispose de VDA 2311 ou version ultérieure et que le pilote MCSIO est installé sur le VDA.
    • Seul le service de métadonnées d’instance (IMDS) V2 est pris en charge, et non IMDS V1. Pour plus d’informations, consultez Fonctionnement de la version 2 du service de métadonnées d’instance.
  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 conserver 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 wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\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\wsc\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 wsc -CustomProperties $CustomProperties
 
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
 
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”
 
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName wsc
$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 maître 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 instances gérées Amazon WorkSpaces Core. Cela vous permet d’utiliser une seule 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 est 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 desservir 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 inter-unités d’hébergement et inter-connexions d’hébergement : Si votre environnement comporte plusieurs unités d’hébergement sous la même région AWS ou une région AWS différente et le même compte AWS, 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 : Vous ne pouvez pas partager entre différents comptes AWS dans l’implémentation actuelle.

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. Alternativement, vous devez 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é 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 en premier.

Prérequis

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

  • Votre environnement doit être un environnement d’instances gérées Amazon WorkSpaces Core.
  • 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 l’interface utilisateur de Web Studio

Vous pouvez partager des images préparées entre les zones de disponibilité liées à différentes unités d’hébergement à l’aide de l’interface utilisateur de Web Studio.

Pour partager une image préparée

  1. Accédez au nœud Images de Web Studio et sélectionnez la version d’image préparée que vous souhaitez partager avec d’autres zones de disponibilité.
  2. Sélectionnez Gérer le partage d’images dans la barre de navigation supérieure pour gérer le partage d’images pour la version d’image sélectionnée.
  3. Sur la page Gérer le partage d’images, sélectionnez une ou plusieurs ressources avec lesquelles vous souhaitez partager la version d’image. Les ressources peuvent se trouver dans des zones de disponibilité différentes de celles de la version d’image d’origine.
  4. Cliquez sur Enregistrer pour partager la version d’image dans les ressources entre les autres zones de disponibilité. La version d’image est mise à jour de manière à être partagée entre les différentes ressources que vous avez sélectionnées. Une fois l’opération terminée, utilisez la version d’image pour créer des catalogues dans les zones de disponibilité où la version d’image est partagée.

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

  1. Dans le nœud Images de Web Studio, sélectionnez la version d’image préparée dont vous souhaitez supprimer le partage.
  2. Sélectionnez Gérer le partage d’images dans la barre de navigation supérieure pour gérer le partage d’images pour la version d’image sélectionnée.

  3. Décochez les cases d’une ou plusieurs ressources (zones de disponibilité) avec lesquelles vous souhaitez arrêter de partager la version d’image.

    Remarque :

    Les ressources ne doivent plus avoir de catalogues associés et créés à partir de la version d’image partagée. Tous les catalogues créés à partir de la version d’image partagée à supprimer doivent être supprimés en premier.

  4. Cliquez sur Enregistrer pour supprimer le partage des ressources dans les zones de disponibilité effacées. La version d’image est mise à jour de manière à ne plus être partagée dans ces zones de disponibilité.

Configurer à l’aide de PowerShell

Alternativement, vous pouvez partager des images préparées entre les zones de disponibilité liées à différentes unités d’hébergement à l’aide de 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 Web 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-->

Où aller ensuite

Plus d’informations

Créer une image préparée pour les instances gérées Amazon WorkSpaces Core
April 8, 2026
Contributeur: 
C C
April 8, 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.