

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Administrez les images de vos WorkSpaces applications Amazon
Administrer vos images

Les images disponibles sont répertoriées dans le **registre des images** de la console WorkSpaces Applications et classées par visibilité comme suit : 
+ **Public** — Images de base détenues et mises à disposition par AWS. Les images de base incluent le dernier système d'exploitation Windows et le logiciel de l'agent d' WorkSpaces applications. Vous pouvez utiliser ces images de base pour créer des images incluant vos propres applications. Pour plus d'informations sur les images de base publiées par AWS, voir[WorkSpaces Notes de mise à jour de l'image de base et de l'image gérée des applications](base-image-version-history.md). 
+ **Privé** : images que vous créez et possédez, et que vous n'avez pas partagées avec d'autres AWS comptes. 
+ **Partagées avec d'autres personnes** : images que vous créez et possédez, et que vous avez partagées avec un ou plusieurs AWS comptes dans la même AWS région. Lorsque vous partagez une image avec un autre AWS compte, vous pouvez spécifier si l'image peut être utilisée pour un générateur d'images (pour créer une nouvelle image), pour un parc ou les deux.
+ **Partagé avec moi** : images créées et détenues par un autre AWS compte dans la même AWS région, et partagées avec votre AWS compte. Selon les autorisations concédées par le propriétaire lors du partage de l’image avec votre compte, vous pouvez utiliser cette image pour des Image Builders, des flottes, ou les deux.

**Topics**
+ [

# Supprimer une image privée dans Amazon WorkSpaces Applications
](delete-private-image.md)
+ [

# Copiez une image que vous possédez dans une autre AWS région dans Amazon WorkSpaces Applications
](copy-image-different-region.md)
+ [

# Partagez une image que vous possédez avec un autre AWS compte dans Amazon WorkSpaces Applications
](share-image-with-another-account.md)
+ [

# Arrêtez de partager une image que vous possédez dans les WorkSpaces applications Amazon
](stop-sharing-image-with-all-accounts.md)
+ [

# Conservez l'image de vos WorkSpaces applications Amazon Up-to-Date
](keep-image-updated.md)
+ [

# Logiciel Windows Update et antivirus sur Amazon WorkSpaces Applications
](windows-update-antivirus-software.md)
+ [

# Création d'une nouvelle image par programmation dans les applications Amazon WorkSpaces
](create-image-programmatically.md)
+ [

# Gérez les applications incluses sous licence sur votre image dans Amazon WorkSpaces Applications
](license-included-applications.md)
+ [

# Importer une image
](import-image.md)
+ [

# Exporter l'image
](export-image.md)

# Supprimer une image privée dans Amazon WorkSpaces Applications
Supprimer une image privée

Lorsque vous n'avez plus besoin d'images privées, vous pouvez les supprimer. Vous ne pouvez pas supprimer une image utilisée par des flottes ou partagée avec d'autres AWS comptes. Pour supprimer une image utilisée par des flottes ou partagée, vous devez d’abord supprimer l’image de toutes les flottes et supprimer toutes les autorisations de partage de l’image. Une fois une image supprimée, il est impossible de la récupérer.

**Pour supprimer une image privée**

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.

1. Dans la liste d'images, sélectionnez l'image privée à supprimer.

1. Choisissez **Actions**, **Supprimer**, puis de nouveau **Supprimer**.

   L'image est supprimée du registre d'images et effacée.

# Copiez une image que vous possédez dans une autre AWS région dans Amazon WorkSpaces Applications
Copier une image qui vous appartient dans une autre région

**Important**  
Pour les régions AWS Asie-Pacifique (Malaisie), Europe (Milan), Europe (Espagne) et Israël (Tel Aviv) : la copie d'images entre régions n'est prise en charge que pour les images WorkSpaces dont les versions de l'agent Applications ont été on/after publiées le 2 octobre 2025 ou pour les images utilisant des mises à jour gérées on/after publiées le 5 septembre 2025. Les anciennes versions ne peuvent pas être copiées entre les régions. Mettez à jour vos images pour qu'elles répondent à ces exigences de version minimales afin d'activer la fonctionnalité de copie entre régions.

Vous pouvez copier les images que vous possédez AWS dans une autre région. L'utilisation de la même image dans différentes AWS régions peut contribuer à simplifier les déploiements mondiaux de vos applications sur WorkSpaces Applications. En déployant vos applications dans les AWS régions les plus proches géographiquement de vos utilisateurs, vous pouvez contribuer à leur offrir une expérience plus réactive.

**Pour copier une image que vous possédez AWS dans une autre région**

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.

1. Dans la liste des images, sélectionnez l'image que vous souhaitez copier AWS dans une autre région.

1. Choisissez **Actions**, puis **Copier**. 

1. Dans la boîte de dialogue **Copier l'image**, dans **Région de destination**, sélectionnez la AWS région dans laquelle vous souhaitez copier l'image.

1. Tapez un nom unique et éventuellement une description pour l'image dans **Région de destination**. 

1. Choisissez **Copier l'image**.

# Partagez une image que vous possédez avec un autre AWS compte dans Amazon WorkSpaces Applications
Partager une image qui vous appartient avec un autre compte

WorkSpaces Les images des applications étant une ressource régionale, vous pouvez partager une image que vous possédez avec d'autres AWS comptes de la même AWS région. Cela peut s'avérer utile dans différents scénarios. Par exemple, si vous séparez vos ressources de développement et de production en utilisant AWS des comptes différents, vous pouvez créer une image à l'aide de votre compte de développement. Ensuite, vous pouvez partager l'image avec votre compte de production. Si votre organisation est un fournisseur indépendant de logiciel (FIL), vous pouvez partager des images optimisées avec vos clients. Les images optimisées qui comprennent les applications requises déjà installées et configurées permettent à vos clients de commencer à utiliser vos applications rapidement, sans devoir les installer ou les configurer eux-mêmes.

Lorsque vous partagez une image avec un autre AWS compte, vous indiquez si le compte de destination peut utiliser l'image dans un parc ou créer de nouvelles images en créant un générateur d'images. Vous restez propriétaire des images que vous partagez. De cette manière, vous pouvez ajouter, modifier ou supprimer des autorisations en fonction des besoins pour vos images partagées.

Si vous partagez une image avec un compte et accordez les autorisations de flotte, l’image partagée peut être utilisée pour créer ou mettre à jour des flottes de ce compte. Si vous supprimez ensuite ces autorisations, le compte ne peut plus utiliser l'image. Pour les flottes du compte partagé qui utilisent l’image, la capacité souhaitée est définie sur 0, ce qui empêche la création de nouvelles instances de flotte. Les sessions existantes continuent jusqu'à ce que la session de streaming se termine. Pour que de nouvelles instances de flotte soient créées, la flotte de ce compte doit être mise à jour avec une image valide.

Si vous partagez une image avec un compte et accordez les autorisations d'Image Builder, l'image partagée peut être utilisée pour créer des Image Builders dans ce compte. Si vous supprimez ensuite ces autorisations, les Image Builders et les images créées à partir de l'image ne sont pas affectés. 

**Important**  
Une fois que vous partagez une image avec un compte, vous ne pouvez pas contrôler les Image Builders ni les images du compte qui sont créés à partir de votre image. Pour cette raison, n'accordez des autorisations Image Builder à un compte que si vous souhaitez autoriser le compte à effectuer une copie de votre image et conserver un accès à la copie une fois que vous arrêtez de partager votre image.

**Pour partager une image que vous possédez avec un autre AWS compte**

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.

1. Dans la liste d'images, sélectionnez l'image à partager.

1. Choisissez **Actions**, **Partager**.

1. Dans la boîte de dialogue **Créer l'image**, choisissez **Ajouter un nouveau volume**.

1. Tapez l'identifiant de AWS compte à 12 chiffres du compte avec lequel vous souhaitez partager l'image, puis indiquez si le compte peut effectuer l'une des opérations suivantes ou les deux :
   + Utiliser l’image pour lancer un Image Builder, si vous souhaitez créer une nouvelle image.
   + Utiliser l’image avec une flotte.

   Pour supprimer un compte de la liste des comptes avec lesquels l’image est partagée, dans la ligne du compte à supprimer, choisissez l’icône X à droite de l’option **Utiliser pour une flotte**.

1. Pour partager l'image avec d'autres AWS comptes, répétez l'étape 6 pour chaque compte avec lequel vous souhaitez partager l'image. 

1. Choisissez **Partager l'image**.

**Pour ajouter ou mettre à jour les autorisations de partage d'une image qui vous appartient**

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.

1. Dans la liste d’images, sélectionnez l’image dont vous souhaiter modifier les autorisations.

1. Sous la liste d’image, choisissez l’onglet **Autorisations** de l’image sélectionnée, puis choisissez **Modifier**.

1. Dans la boîte de dialogue **Modifier les autorisations relatives aux images**, sélectionnez ou désactivez l'une des options de partage d'images suivantes, ou les deux, selon les besoins d'un ou de plusieurs AWS comptes. Si vous désactivez les deux options pour un compte, l'image n'est plus partagée avec lui. 
   + Utiliser l’image pour lancer un Image Builder, si vous souhaitez créer une nouvelle image.
   + Utiliser l’image avec une flotte.

   Pour supprimer un compte de la liste des comptes avec lesquels l’image est partagée, dans la ligne du compte à supprimer, choisissez l’icône X à droite de l’option **Utiliser pour une flotte**.

1. Pour modifier les autorisations de partage d'images pour d'autres AWS comptes, répétez l'étape 5 pour chaque compte pour lequel vous souhaitez mettre à jour les autorisations. 

1. Choisissez **Mettre à jour les autorisations de partage d’images**.

# Arrêtez de partager une image que vous possédez dans les WorkSpaces applications Amazon
Arrêter de partager une image qui vous appartient

Suivez ces étapes pour arrêter de partager une image dont vous êtes propriétaire avec un autre AWS compte.

**Pour arrêter de partager une image que vous possédez avec un autre AWS compte**

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.

1. Dans la liste d’images, sélectionnez l’image dont vous souhaiter modifier les autorisations.

1. Sous la liste d’image, choisissez l’onglet **Autorisations** de l’image sélectionnée, puis choisissez **Modifier**.

1. Dans la boîte de dialogue **Modifier les autorisations relatives aux images**, dans la ligne correspondant à tous les AWS comptes avec lesquels l'image est partagée, choisissez l'icône X à droite de l'option **Utiliser pour le parc**.

1. Choisissez **Mettre à jour les autorisations de partage d’images**.

# Conservez l'image de vos WorkSpaces applications Amazon Up-to-Date
Conservez votre image Up-to-Date

Vous pouvez conserver l'image de vos WorkSpaces applications up-to-date en effectuant l'une des opérations suivantes :
+ [Mettre à jour une image à l'aide des mises à jour WorkSpaces d'image des applications gérées](keep-image-updated-managed-image-updates.md)— Cette méthode de mise à jour fournit les dernières mises à jour du système d'exploitation et des pilotes, ainsi que les derniers logiciels de l'agent d' WorkSpaces applications.
+ [Mettre à jour le logiciel de l'agent d' WorkSpaces applications à l'aide des versions de l'agent d' WorkSpaces applications gérées](keep-image-updated-manage-image-versions.md)— Cette méthode de mise à jour fournit le dernier logiciel WorkSpaces d'agent d'applications.

# Mettre à jour une image à l'aide des mises à jour WorkSpaces d'image des applications gérées


WorkSpaces Applications fournit un moyen automatique de mettre à jour votre image avec les dernières mises à jour du système d'exploitation, les mises à jour des applications incluses dans la licence, les mises à jour des pilotes et le logiciel de l'agent d' WorkSpaces applications. Avec les mises à jour d'image des WorkSpaces applications gérées, vous sélectionnez l'image que vous souhaitez mettre à jour. WorkSpaces Les applications créent un générateur d'images dans le même AWS compte et dans la même région pour installer les mises à jour et créer la nouvelle image. Une fois la nouvelle image créée, vous pouvez la tester sur un parc de pré-production avant de mettre à jour vos flottes de production ou de partager l'image avec d'autres AWS comptes. 

**Note**  
Les mises à jour WorkSpaces des images des applications gérées sont disponibles pour les systèmes d'exploitation Microsoft Windows Server, Red Hat Enterprise Linux et Rocky Linux.

**Note**  
Une fois votre nouvelle image créée, vous êtes responsable de la maintenance des mises à jour du système d'exploitation. Pour ce faire, vous pouvez continuer à utiliser les mises à jour WorkSpaces des images des applications gérées.  
Vous êtes responsable de la maintenance des mises à jour du pilote Amazon EC2 Windows Paravirtual (PV), du pilote ENA et du pilote. AWS NVMe Pour plus d'informations sur la mise à jour des pilotes, voir [Gérer les pilotes de périphériques pour votre instance EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html).  
Vous êtes également responsable de la maintenance de vos applications et de leurs dépendances. Pour ajouter d’autres applications, mettre à jour des applications existantes ou modifier les paramètres de l’image, vous devez lancer et vous reconnecter à l’instance Image Builder que vous avez utilisée pour créer l’image. Sinon, si vous avez supprimé l’instance Image Builder, lancez une nouvelle instance Image Builder basée sur votre image. Ensuite, apportez vos modifications et créez une nouvelle image.

## Conditions préalables


Vous trouverez ci-dessous les conditions requises et les points à prendre en compte pour utiliser les mises à jour d’image gérées.
+ Assurez-vous que les quotas de votre compte WorkSpaces Applications (également appelés limites) sont suffisants pour prendre en charge la création d'un nouveau générateur d'images et d'une nouvelle image. Pour demander une augmentation de quota, vous pouvez utiliser la console Service Quotas à l'adresse [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/). Pour plus d'informations sur WorkSpaces les quotas d'applications par défaut, consultez[Quotas du Service Amazon WorkSpaces Applications](limits.md). 
+ Vous devez être propriétaire de l’image que vous mettez à jour. Vous ne pouvez pas mettre à jour une image qui est partagée avec vous.
+ Lorsqu' WorkSpaces Applications crée un générateur d'images pour installer les dernières mises à jour du système d'exploitation, les mises à jour de pilotes et le logiciel de l'agent d' WorkSpaces applications, et crée la nouvelle image, l'instance du générateur d'images vous est facturée pendant sa mise à jour.
+ Les images prises en charge doivent être créées à partir d’une image de base publiée à la date 2017-07-24T00:00:00Z ou ultérieurement.
+ L’anglais et le japonais sont les langues d’affichage prises en charge. Pour plus d’informations, consultez [Spécification d’une langue d’affichage par défaut](configure-default-display-language.md).
+ Utilisez la dernière version de l’agent SSM. Pour plus d'informations sur la version, consultez [WorkSpaces Notes de mise à jour de l'image de base et de l'image gérée des applications](base-image-version-history.md). Pour plus d’informations, consultez [Installation manuelle de SSM Agent sur les instances EC2 pour Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html). 

## Comment mettre à jour une image à l'aide des mises à jour d'image WorkSpaces des applications gérées


Pour mettre à jour une image d' WorkSpaces applications avec les derniers correctifs, mises à jour de pilotes et logiciels d'agent d' WorkSpaces applications, effectuez les opérations suivantes.

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**. 

1. Dans la liste d’images, sélectionnez l’image à mettre à jour. Vérifiez que le statut de l’image est **Disponible**.

1. Choisissez **Actions**, **Mettre à jour**.

1. Dans la boîte de dialogue **Mettre à jour l’image**, procédez comme suit :
   + Dans le **champ Nouveau nom d'image**, entrez un nom d'image unique au sein du AWS compte et de la région. Le nom de l'image ne peut pas commencer par « Amazon », «AWS, » ou « »AppStream. 
   + Pour **Nouveau nom d’affichage de l’image**, vous pouvez éventuellement saisir le nom à afficher pour l’image.
   + Pour **Description de la nouvelle image**, vous pouvez éventuellement fournir une description de l’image.
   + Pour **Balises**, vous pouvez choisir **Ajouter une balise**, puis saisir la clé et la valeur de la balise. Répétez cette étape pour ajouter d’autres balises. Pour plus d’informations, consultez [Marquer les ressources de vos WorkSpaces applications Amazon](tagging-basic.md).

1. Choisissez **Mettre à jour l’image**.

   Si votre image actuelle est déjà à jour, un message vous en informe.

1. Dans le volet de navigation, choisissez **Images**, puis **Image Builder**. 

1. Dans la liste des Image Builders, vérifiez qu’un nouvel Image Builder apparaît avec le statut **Mise à jour en cours**. Le nom de l’Image Builder inclut un suffixe aléatoire à 10 chiffres.

   L’Image Builder a la plus petite taille de la famille d’instances que vous avez choisie pour la nouvelle image à l’étape 5. Aucun sous-réseau n’est spécifié, car l’Image Builder n’est pas attaché à votre cloud privé virtuel (VPC).

1. Choisissez **Registre d’images** et vérifiez que votre nouvelle image apparaît dans la liste.

   Pendant la création de votre image, le statut de l’image dans le registre d’images de la console est **Création en cours**.

1. Une fois votre image créée, WorkSpaces Applications exécute un processus de qualification pour vérifier que l'image fonctionne comme prévu. 

   Pendant ce temps, l’Image Builder, qui est également utilisé pour ce processus, apparaît dans la liste **Image Builder** avec le statut **En attente de qualification**. 

1. Une fois le processus de qualification terminé avec succès, le message **Opération réussie** s’affiche en haut de la console et le statut de l’image dans le registre d’images est **Disponible**.

   En outre, le générateur d'images créé par WorkSpaces Applications est automatiquement supprimé.
**Note**  
Selon le volume de mises à jour du système d'exploitation, la mise à jour d'une image peut prendre plusieurs heures. Si un problème empêche la mise à jour de l’image, une icône rouge avec un point d’exclamation apparaît à côté du nom de l’image, et le statut de l’image dans le registre d’images est **Échec**. Dans ce cas, sélectionnez l’image, choisissez l’onglet **Notifications** et passez en revue les éventuelles notifications d’erreur. Pour plus d’informations, consultez les informations contenues dans la section [Service interne d’images](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image) de la documentation concernant la résolution des codes de notification.  
Si le processus de qualification échoue, le générateur d'images créé par WorkSpaces Applications est toujours supprimé automatiquement.

1. Une fois qu' WorkSpaces Applications a créé la nouvelle image, testez-la sur un parc de pré-production. Après avoir vérifié que vos applications fonctionnent normalement, mettez à jour votre flotte de production avec la nouvelle image.

# Mettre à jour le logiciel de l'agent d' WorkSpaces applications à l'aide des versions de l'agent d' WorkSpaces applications gérées


WorkSpaces Applications fournit un moyen automatique de mettre à jour votre générateur d'images avec le nouveau logiciel WorkSpaces d'agent d'applications. De cette manière, vous pouvez créer une nouvelle image dès qu'une nouvelle version de l'agent est disponible. Vous pouvez ensuite tester l'image avant de mettre à jour vos flottes de production. Pour plus d'informations sur la façon de gérer le logiciel de l'agent d' WorkSpaces applications, consultez[Gérer les versions WorkSpaces des agents d'applications](base-images-agent.md). 

**Note**  
Vous êtes responsable de l’installation et de la gestion des mises à jour du système d’exploitation Windows, de vos applications et de leurs dépendances.

Pour maintenir l'image de vos WorkSpaces applications à jour avec les dernières mises à jour du système d'exploitation Windows, effectuez l'une des opérations suivantes :
+ Installez vos applications sur la dernière image de base chaque fois qu'une nouvelle image est disponible.
+ Installez les mises à jour pour le système d'exploitation Windows, vos applications et leurs dépendances sur un Image Builder existant.
+ Installez les mises à jour pour le système d'exploitation Windows, vos applications et leurs dépendances sur une nouvelle instance Image Builder à partir d'une image existante.

Après avoir créé une nouvelle image avec le dernier système d'exploitation Windows, les applications et leurs dépendances, ainsi que le logiciel de l'agent d' WorkSpaces applications, testez l'image sur un parc de développement. Après avoir vérifié que vos applications fonctionnent normalement, mettez à jour votre flotte de production avec la nouvelle image.

# Logiciel Windows Update et antivirus sur Amazon WorkSpaces Applications
Windows Update et logiciel antivirus

WorkSpaces Les instances de streaming d'applications ne sont pas persistantes. À la fin d'une session de streaming utilisateur, WorkSpaces Applications met fin à l'instance utilisée par la session et, en fonction de vos politiques de dimensionnement, provisionne une nouvelle instance pour la remplacer dans votre parc. Toutes les instances de flotte sont mises en service à partir de la même image. Les images ne pouvant pas être modifiées une fois créées, toutes les instances de flotte utilisées dans des sessions de streaming utilisateur disposent uniquement des mises à jour Windows et d'application qui ont été installées sur l'image sous-jacente lors de la création de l'image. En outre, comme une instance de flotte utilisée pour une session de streaming est résiliée à la fin de la session, toutes les mises à jour apportées à Windows ou aux applications sur l’instance au cours de la session de streaming ne seront pas conservées dans les sessions futures par le même utilisateur ou d’autres utilisateurs.

**Note**  
Si vous avez activé la persistance des paramètres d'application pour votre stack, WorkSpaces les applications conservent Windows et les modifications de configuration des applications effectuées par un utilisateur lors de futures sessions pour le même utilisateur si ces modifications de configuration sont stockées dans le profil Windows de l'utilisateur. Toutefois, la fonction de persistance des paramètres d'application conserve uniquement les paramètres de configuration Windows et d'application. Il ne conserve pas les mises à jour logicielles pour Windows ou les applications sur l'instance de streaming.

Pour ces raisons, WorkSpaces Applications adopte l'approche suivante en ce qui concerne Windows Update et les logiciels antivirus sur WorkSpaces les instances d'Applications.

## Windows Update


Windows Update n'est pas activé par défaut sur les images de base des WorkSpaces applications. Si vous activez Windows Update sur un Image Builder, puis essayez de créer une image, Image Assistant affiche un avertissement et désactive Windows Update pendant le processus de création de l'image. Pour vous assurer que les dernières mises à jour Windows sont installées sur vos instances de flotte, nous vous recommandons d'installer les mises à jour Windows sur votre Image Builder, de créer une nouvelle image et de mettre à jour votre flotte avec la nouvelle image régulièrement.

## Logiciel antivirus


Si vous choisissez d'installer un logiciel antivirus sur votre image, nous vous recommandons de ne pas activer les mises à jour automatiques pour le logiciel antivirus. Sinon, le logiciel antivirus peut tenter de se mettre à jour avec les fichiers de définition les plus récents ou d'autres mises à jour au cours des sessions utilisateur. Cela peut affecter les performances. En outre, aucune mise à jour apportée au logiciel antivirus n’est conservée au-delà de la session utilisateur actuelle. Pour vous assurer que vos instances de flotte disposent toujours des dernières mises à jour d’antivirus, nous vous recommandons d’effectuer l’une des actions suivantes :
+ Mettez à jour votre Image Builder et créez une nouvelle image régulièrement (par exemple, à l'aide des [opérations d'interface de ligne de commande Image Assistant](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html)).
+ Utilisez une application antivirus qui délègue l'analyse ou d'autres opérations à un serveur always-up-to-date externe.

**Note**  
Même si vous n'activez pas les mises à jour automatiques pour votre logiciel antivirus, celui-ci peut effectuer des analyses de disque dur ou d'autres opérations susceptibles d'avoir un impact sur les performances de vos instances de flotte au cours des sessions utilisateur.

Sur WorkSpaces les images de base d'Applications Windows Server 2025/2022/2019/2016 publiées le 10 septembre 2019 ou après cette date, Windows Defender n'est pas activé par défaut. Sur WorkSpaces les images de base des applications Windows Server 2016 et Windows Server 2019 publiées le 24 juin 2019, Windows Defender est activé par défaut.

**Pour activer Windows Defender manuellement**

Si Windows Defender n'est pas activé sur votre image de base, vous pouvez l'activer manuellement. Pour ce faire, exécutez les étapes suivantes.

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation de gauche, choisissez **Images**, **Image Builder**. 

1. Choisissez l'instance Image Builder sur laquelle activer Windows Defender, vérifiez que celui-ci est à l'état **Running (En cours d'exécution)**, puis sélectionnez **Connect (Se connecter)**. 

1. Connectez-vous à l’instance Image Builder avec le compte **Administrateur** local ou un compte du domaine qui dispose des autorisations d’administrateur local.

1. Ouvrez l'éditeur de registre.

1. Accédez à l'emplacement suivant dans le registre : **HKLM \$1 SOFTWARE \$1 Policies \$1 Microsoft \$1 Windows Defender \$1**. DisableAntiSpyware 

1. Pour modifier cette clé de registre, double-cliquez dessus ou cliquez avec le bouton droit sur la clé de registre, puis choisissez **Modify (Modifier)**.

1. Dans la boîte de dialogue **Edit DWORD (32-bit) Value (Modifier la valeur DWORD (32 bits))** dans **Value data (Données de la valeur)**, remplacez **1** par **0**.

1. Choisissez **OK**.

1. Fermez l'éditeur de Registre.

1. Ouvrez le composant logiciel enfichable **Services** de Microsoft Management Console (MMC) (`services.msc`).

1. Dans la liste des services, effectuez l'une des opérations suivantes.

   Si vous utilisez Microsoft Windows Server 2022/2025, effectuez l'une des opérations suivantes :
   + Cliquez avec le bouton droit sur **Microsoft Defender Antivirus Service**, puis sélectionnez **Démarrer**.
   + Double-cliquez sur **Microsoft Defender Antivirus Service**, sélectionnez **Démarrer** dans la boîte de dialogue des propriétés, puis cliquez **sur OK**.

   Si vous utilisez Microsoft Windows Server 2019 ou 2016, effectuez l'une des opérations suivantes :
   + Cliquez avec le bouton droit sur **Windows Defender Antivirus Service (Service antivirus Windows Defender)**, puis choisissez **Start (Démarrer)**.
   + Double-cliquez sur **Windows Defender Antivirus Service (Service antivirus Windows Defender)**, choisissez **Start (Démarrer)** dans la boîte de dialogue des propriétés, puis sélectionnez **OK**.

1. Fermez le composant logiciel enfichable **Services**.

# Création d'une nouvelle image par programmation dans les applications Amazon WorkSpaces
Créer une nouvelle image par programmation

Vous pouvez créer des images d' WorkSpaces applications par programmation en vous connectant à un générateur d'images et en utilisant les opérations de l'interface de ligne de commande (CLI) d'Image Assistant. Pour de plus amples informations, veuillez consulter [Créez votre image Amazon WorkSpaces Applications par programmation à l'aide des opérations de la CLI de l'Assistant Image](programmatically-create-image.md). 

# Gérez les applications incluses sous licence sur votre image dans Amazon WorkSpaces Applications
Gérer les applications incluses dans les licences

Vous pouvez diffuser les applications incluses sous licence Microsoft suivantes à l'aide d' WorkSpaces Applications. Vous pouvez installer ces applications sur votre image Windows, utiliser cette image personnalisée pour créer un ou plusieurs parcs, puis diffuser ces applications en streaming. Toutes les applications suivantes sont disponibles en architecture 32 bits et 64 bits :
+ Microsoft Office LTSC Professionnel Plus 2021/2024
+ Microsoft Visio LTSC Professionnel 2021/2024
+ Microsoft Project Professional 2021/2024
+ Norme Microsoft Office LTSC 2021/2024
+ Norme Microsoft Visio LTSC 2021/2024
+ Microsoft Project Standard 2021/2024
**Important**  
Microsoft Office, Visio et Project doivent suivre les mêmes versions. Par exemple, vous ne pouvez pas mélanger les candidatures de 2021 avec celles de 2024.
Microsoft Office, Visio et Project doivent suivre la même architecture. Par exemple, vous ne pouvez pas mélanger des applications 32 bits avec des applications 64 bits.
Les Standard/Professional versions are supported on Microsoft Windows Server 2019/2022/2025. Microsoft Office, Visio, and Project 2024 Standard/Professional versions Microsoft Office, Visio et Project 2021 sont prises en charge sur Microsoft Windows Server 2022 et 2025.
Pour activer cette fonctionnalité, vous devez utiliser un Application WorkSpaces Image Builder qui utilise un agent WorkSpaces Applications publié le 2 octobre 2025 ou après cette date. Pour plus d’informations, consultez [Gérer les versions WorkSpaces des agents d'applications](base-images-agent.md). Ou bien, votre image doit utiliser les mises à jour d'image des WorkSpaces applications gérées publiées le 3 octobre 2025 ou après cette date. Pour de plus amples informations, veuillez consulter [Conservez l'image de vos WorkSpaces applications Amazon Up-to-Date](keep-image-updated.md).
Le protocole TCP sortant sur le port 1688 doit être ouvert sur l'interface réseau de gestion de toutes les instances de streaming. 
Tous les utilisateurs utilisant une flotte alimentée par une image et utilisant une ou plusieurs applications sous licence sont facturés mensuellement pour ces applications, quelle que soit leur utilisation. La fonctionnalité d'autorisation des applications ne restreint pas l'accès à des utilisateurs spécifiques.
Les applications incluses sous licence sur Image Builder ne sont pas activées car elles sont installées à des fins administratives. L'activation se produit lorsque les utilisateurs diffusent du contenu via une instance de flotte.

**Topics**
+ [

# Afficher la liste des applications incluses sous licence installées sur votre image
](view-list-image.md)
+ [

# Consultez la liste des applications sous licence incluses dans votre générateur d'images
](view-list-apps.md)
+ [

# Installation ou désinstallation d'applications incluses sous licence
](install-uninstall-apps.md)
+ [

# Activer les mises à jour pour les applications incluses dans la licence sur Image Builder
](updates-image-builder.md)
+ [

# Activez les mises à jour pour les applications incluses sous licence sur le générateur d'images avec Powershell
](enable-updates-managed-powershell.md)
+ [

# Activez les mises à jour pour les applications incluses sous licence sur le générateur d'images avec Managed Image Update
](enable-updates-managed.md)

# Afficher la liste des applications incluses sous licence installées sur votre image


**Afficher la liste des applications incluses sous licence installées sur votre image**

Pour consulter la liste des applications incluses sous licence installées sur votre image, procédez comme suit.

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Choisissez **Images** dans le volet de navigation de gauche et dans l'onglet **Registre d'images**.

1. Sélectionnez une image, puis choisissez **Afficher les détails**.

1. Consultez la liste de toutes les applications installées dans la section **Applications incluses dans la licence**.

# Consultez la liste des applications sous licence incluses dans votre générateur d'images


**Consultez la liste des applications sous licence incluses dans votre générateur d'images**

Pour consulter la liste des applications incluses sous licence dans votre générateur d'images, procédez comme suit.

1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Choisissez **Images** dans le volet de navigation de gauche et dans l'onglet **Générateur d'images**.

1. Sélectionnez un générateur d'images, puis choisissez **Afficher les détails**.

1. Consultez la liste des applications et leur statut sous **Applications incluses dans la licence**.

# Installation ou désinstallation d'applications incluses sous licence


**Installation ou désinstallation d'applications incluses sous licence**

Pour installer ou désinstaller une ou plusieurs applications incluses sous licence sur votre image, procédez comme suit.

1. Complétez l'une des options suivantes :
   + Lancez un générateur d'images et configurez les applications incluses sous licence. Pour de plus amples informations, veuillez consulter [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md).
   + Gérez les applications incluses sous licence dans votre générateur d'images. Pour de plus amples informations, veuillez consulter [Droits d’application basés sur les attributs faisant appel à un fournisseur d’identité SAML 2.0 tiers](application-entitlements-saml.md).

1. Lorsque vous avez créé une image avec une ou plusieurs applications incluses dans une licence, vous pouvez utiliser cette image pour créer des flottes. Les utilisateurs qui se connectent à cette flotte peuvent accéder à ces applications. 
**Important**  
Tous les utilisateurs utilisant une flotte alimentée par une image et utilisant une ou plusieurs applications sous licence seront facturés pour ces applications tous les mois, quelle que soit leur utilisation. La fonctionnalité d'autorisation des applications ne restreint pas l'accès à des utilisateurs spécifiques. 

Si vous rencontrez des problèmes lors de l'installation ou de la désinstallation d'une application incluse dans la licence, vous verrez un état d'échec sur la page de détails de votre Image Builder. Pour résoudre ces problèmes, nous vous recommandons de vous connecter à votre Image Builder et d'activer la journalisation détaillée. Pour plus d'informations, consultez [Comment activer les applications Microsoft 365 pour la journalisation en entreprise](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging). Si le problème persiste après avoir examiné les journaux et résolu les problèmes, contactez AWS Support pour obtenir de l'aide.

# Activer les mises à jour pour les applications incluses dans la licence sur Image Builder


**Activer les mises à jour pour les applications incluses dans la licence sur Image Builder**

Les mises à jour pour toutes les applications incluses dans une licence sont désactivées par défaut. Vous pouvez activer les mises à jour pour ces applications dans le générateur d'images avec une image qui inclut une ou plusieurs de ces applications. Les mises à jour sur les instances de flotte restent désactivées pour empêcher l'installation lors de la configuration de la session.

Il existe trois options pour activer les mises à jour pour les applications incluses dans une licence sur Image Builder.

Pour activer les mises à jour des applications incluses sous licence sur Image Builder à l'aide du menu de l'application, procédez comme suit.

1. Ouvrez n'importe quelle application de licence incluse.

1. Choisissez **Fichier**, **Compte**, **Options de mise à jour** et **Activer les mises à jour**.

# Activez les mises à jour pour les applications incluses sous licence sur le générateur d'images avec Powershell


Pour activer les mises à jour des applications incluses sous licence sur Image Builder avec Powershell, procédez comme suit.
+ Exécutez la commande suivante en PowerShell tant qu'administrateur : 

  `Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `

# Activez les mises à jour pour les applications incluses sous licence sur le générateur d'images avec Managed Image Update


Pour activer les mises à jour des applications incluses sous licence sur Image Builder avec Managed Image Update, procédez comme suit.
+  Utilisez Managed Image Update pour recevoir des mises à jour sur les applications incluses sous licence Microsoft. Pour plus d’informations, veuillez consulter la rubrique 

  [Mettre à jour une image à l'aide des mises à jour WorkSpaces d'image des applications gérées](keep-image-updated-managed-image-updates.md).

# Importer une image
Importer une image

Vous pouvez créer des images WorkSpaces d'applications en important vos images personnalisées EC2 AMIs. Voici comment cela fonctionne :

1. Personnalisez votre EC2 AMI à l'aide de n'importe quelle méthode préférée, y compris [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/).

1. Importez votre AMI personnalisée dans WorkSpaces Applications pour créer une image d' WorkSpaces applications

1. Vous pouvez également utiliser Image Builder pour personnaliser davantage les images

Les images créées via l'importation d'AMI sont de`type = "custom"`, tandis que WorkSpaces les images fournies par les applications sont de`type = "native"`.

Vous pouvez utiliser les types d'instance stream.\$1 pour les images avec. `type = "native"` Pour utiliser l'un des types d'instance suivants, vous devez importer votre AMI et créer une image avec`type = "custom"`.
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Accéléré. \$1

## Conditions préalables à l'importation d'images


Toutes ces conditions préalables sont importantes pour une exécution réussie du flux de travail. Les configurations AMI prises en charge et les autres exigences obligatoires sont répertoriées ci-dessous.

### Propriétés de l'AMI requises


EBS  
+ Taille inférieure ou égale à 500 Go
  + Vous pouvez importer une AMI de moins de 200 Go, mais l'image importée utilisera au moins 200 Go.
+ GP2
  + Vous pouvez importer une AMI avec le type de volume EBS gp2 ou gp3, mais l'image importée utilisera gp2.
+ Un volume par image
+ `/dev/sda1`Nom du périphérique racine
+ Type d'image : Machine
+ Architecture : x86\$164
+ Type de virtualisation : HVM
+ Mode de démarrage : UEFI
+ Support TPM : version 2.0. Ceci est obligatoire. Reportez-vous à [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find) pour ami-windows-tpm-find trouver une AMI compatible avec le TPM.
+ Support ENA : vrai
+ Plateforme : Windows
+ Détails de la plateforme : Windows

### Propriétés du système d'exploitation


**Windows Server 2022/2025 (base complète)**  
+ Windows Server **Core** n'est pas pris en charge
+ Windows avec SQL Server n'est pas pris en charge

Agents  
+ EC2 Lancer la version V2 >= 2.1.1
+ Agent SSM requis

Pilotes  
+ EC2 Version du pilote ENA >= 2.9.0
+ EC2 NVMe Version du pilote >= 1.6.0

Support aux bibliothèques  
+ .NET Framework 4.8 ou supérieur
  + Installé par défaut dans Windows Server 2022/2025
+ PowerShell 5.1 ou supérieur
  + Installé par défaut dans Windows Server 2022/2025
+ Fonctionnalités Windows : L'hôte de session des services de bureau à distance et de licence des services de bureau à distance ne doit pas être installé
+ Ports : les ports 8000, 8300 et 8443 doivent être débloqués et inoccupés
+ Mode de démarrage : UEFI

Si vous souhaitez utiliser une image avec des instances graphiques telles que Accelerated.G4DN, Accelerated.G5, Accelerated.G6 ou Accelerated.G6E, vous devez installer le pilote GRID approprié sur votre AMI. Pour plus de détails, veuillez consulter le [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidiafichier -GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html). Si les pilotes ne sont pas correctement configurés, le streaming fonctionnera, mais la carte graphique peut ne pas être disponible.

**Important**  
Le « ID de compte propriétaire » de l'AMI doit être votre identifiant de AWS compte. Vous ne pouvez pas importer une EC2 AMI publique.  
Effectuez toutes les mises à jour de Windows et désactivez les mises à jour automatiques de Windows avant d'importer l'image.  
L'importation de données chiffrées n' EC2 AMIs est actuellement pas prise en charge

### Exigences relatives au rôle IAM


**Important**  
« Créez un rôle IAM avec les autorisations suivantes à utiliser pour l'importation d'images :

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}
```

Ajoutez la relation de confiance suivante pour ce rôle IAM

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## Pour importer une image


1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation de gauche, choisissez **Images**, puis choisissez **Image registry**.

1. Choisissez **Importer une image**.

1. **ID AMI** - Entrez un ID AMI pour l'AMI que vous souhaitez importer dans WorkSpaces Applications. Vous pouvez également rechercher votre AMI à l'aide de ce champ.

1. **Nom de l'image** - Entrez un nom unique pour l'image qui sera créée en raison de l'opération d'importation.

1. **Nom d'affichage** *(facultatif)* - Entrez le nom à afficher pour l'image.

1. **Description** *(facultatif)* — Entrez une description pour l'image.

1. Rôle **IAM : sélectionnez le rôle** IAM que vous avez créé pour l'importation d'images. Pour plus de détails, reportez-vous à[Exigences relatives au rôle IAM](#iam-role-requirements).

1. **Agent de gestion WorkSpaces des applications** : sélectionnez cette option si vous souhaitez toujours utiliser la dernière version de l'agent d' WorkSpaces applications. Vos instances de streaming sont automatiquement mises à jour avec les dernières fonctionnalités, améliorations de performances et mises à jour de sécurité disponibles AWS dès la publication d'une nouvelle version de l'agent.

1. **Validation à l'exécution** *(facultatif)* : sélectionnez cette option et le service fournira à une instance l'image en cours d'importation et exécutera des tests de streaming.
   + 
**Note**  
Ces tests de streaming seront exécutés en arrière-plan, vous ne pouvez pas vous connecter à cette instance via le client WorkSpaces Applications.
   + Nous vous recommandons d'utiliser cette option pour être plus sûr que votre image est adaptée aux WorkSpaces applications.
   + Le prix horaire de cette instance vous sera facturé.
   + Vous pouvez éviter d'exécuter la validation d'exécution si vous réimportez votre AMI après avoir apporté des modifications mineures susceptibles de ne pas affecter le test de streaming, et si la validation d'exécution a réussi la dernière fois, vous avez importé cette AMI.
   + **Choisissez le type d'instance** *(facultatif)* : sélectionnez la famille, le type et la taille d'instance appropriés pour exécuter le test de streaming. Il est recommandé d'utiliser la même instance que celle que vous avez l'intention d'utiliser pour la création de flotte.

1. **Catalogue des applications et manifeste des performances de lancement** *(facultatif)* : fournissez des informations détaillées pour créer un catalogue d'applications pour vos utilisateurs finaux et améliorer les performances de lancement de vos applications.
   + **Catalogue d'applications** : pour créer un catalogue d'applications, spécifiez les informations relatives aux applications installées sur votre image. Pour chaque application que vous prévoyez de diffuser, vous pouvez spécifier le nom, le nom d'affichage, le fichier exécutable à lancer et l'icône à afficher.
   + **Performances de lancement** : l'ajout de fichiers au manifeste d'optimisation de l'application réduit le temps nécessaire au premier lancement de l'application sur une nouvelle instance de flotte. Le manifeste d'optimisation est un fichier texte délimité par des lignes spécifique à l’application.

   Pour en savoir plus, reportez-vous à[Détails des applications](applications-details.md).

1. **Balises** *(facultatif)* - Choisissez **Ajouter une balise** et saisissez la clé et la valeur de la balise. Répétez cette étape pour ajouter d’autres balises. Pour de plus amples informations, veuillez consulter [Marquer les ressources de vos WorkSpaces applications Amazon](tagging-basic.md).

1. **Importer une image** — Vérifiez toutes les informations que vous avez saisies et choisissez **Importer une image**. Le service exécutera des contrôles de compatibilité pour s'assurer que l'AMI est compatible avec WorkSpaces les applications.
   + Si les contrôles statiques échouent, vous recevrez immédiatement un message d'erreur.
   + Si les vérifications statiques réussissent, votre demande d'importation sera soumise et, selon les options que vous avez sélectionnées, la création d'une nouvelle image d' WorkSpaces applications peut prendre 30 à 60 minutes avec `type = "custom"`

# Détails des applications
Détails des applications

Les détails des applications contiennent des informations sur les manifestes de préchauffage et les configurations du catalogue d'applications.

## Manifestes de PreWarm candidature


Lorsque vous créez WorkSpaces des images d'applications, vous pouvez spécifier les applications à mettre à la disposition de vos utilisateurs. Pour accélérer le lancement de l'application, vous pouvez préparer un PreWarm manifeste. Il s'agit essentiellement d'un catalogue des fichiers dont votre application a besoin pour être lancée lorsque les utilisateurs lancent votre application. Lors du provisionnement de l'instance, ces fichiers seront préparés avant les connexions de session afin d'accélérer le lancement des applications lors des sessions utilisateur.

Les manifestes de préchauffage doivent être créés au préalable sur votre AMI avant d'être importés dans l'environnement WorkSpaces Applications. Vous pouvez choisir de créer un fichier manifeste Prewarm commun ou un fichier par application. Cela change la façon dont vous allez importer votre AMI ultérieurement.

### Manifeste de préchauffage courant


Pour chaque application que vous souhaitez préchauffer, lancez l'application et effectuez les interactions initiales que vos utilisateurs peuvent effectuer. Utilisez ensuite la commande suivante pour cibler le répertoire dans lequel les données de vos applications sont stockées.

```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```

Cela ajoutera les fichiers à optimiser pour chaque application dans le `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` fichier commun. Aucune action supplémentaire n'est nécessaire pour effectuer le préchauffage de l'application. WorkSpaces Les applications rechercheront le fichier de préchauffage à l'emplacement ci-dessus et l'utiliseront s'il est présent.

Ce processus est facultatif et à mesure que la taille du manifeste de préchauffage augmente, le temps de provisionnement de la flotte augmentera également. Veillez donc à trouver un équilibre entre optimisation et approvisionnement de flotte.

### Manifestes spécifiques à l'application


Lors de l'importation d'images, vous souhaiterez peut-être spécifier des fichiers manifestes d'application distincts par application pour faciliter le suivi des actifs de préchauffage par application. Pour ce faire, suivez les mêmes étapes que ci-dessus, mais au lieu de créer un `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` fichier commun, créez un fichier par application sur votre AMI.

Pour chaque application que vous souhaitez préchauffer, lancez l'application et effectuez les interactions initiales que vos utilisateurs peuvent effectuer. Utilisez ensuite la commande suivante pour cibler le répertoire dans lequel les données de vos applications sont stockées.

```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\<ApplicationName>PreWarm.txt" -encoding UTF8 -append
```

Nous utiliserons ces fichiers de préchauffage de l'application pendant le processus d'importation des images. Encore une fois, c'est totalement facultatif. Vous pouvez choisir d'utiliser cette méthode, la méthode Common Prewarm Manifest, ou de ne pas utiliser de manifeste Prewarm du tout.

## Configurations du catalogue d'applications


`AppCatalogConfig`qui vous permet de spécifier les applications que vous souhaitez enregistrer sur votre image d' WorkSpaces applications lors de l'importation d'AMI. `AppCatalogConfig`Il s'agit d'une liste JSON d'objets de configuration d'application de la structure suivante.

```
[  
    {  
        "Name": "Rufus", //Required and must be unique among the list of applications  
        "DisplayName": "Rufus",  
        "AbsoluteAppPath": "Rufus", //Required  
        "AbsoluteIconPath": "Rufus",  
        "AbsoluteManifestPath": "Rufus",  
        "WorkingDirectory": "Rufus",  
        "LaunchParameters": "Rufus"  
    }  

    ...  

    // Up to 50 applications total  
 ]
```

Les seuls champs obligatoires par candidature sont le `Name` et le`AbsoluteAppPath`. Les détails de chaque champ sont les suivants :

Nom [**Obligatoire**]  
+ Un prénom pour votre application afin de l'identifier
+ Entre 1 et 100 caractères
+ Caractères autorisés regex `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ Doit être unique dans un domaine donné AppCatalogConfig

DisplayName  
+ Le nom d'affichage d'une application donnée à afficher aux utilisateurs
+ Entre 0 et 100 caractères
+ Caractères autorisés regex `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`

AbsoluteAppPath [**Obligatoire**]  
+ Le chemin d'accès à l'exécutable pour lancer votre application
  + Il s'agit de l'exécutable qui sera lancé lorsque les utilisateurs sélectionneront votre application
+ Entre 1 et 32 767 caractères
  + Cette limite supérieure de longueur de caractères est destinée à prendre en charge les chemins de fichiers étendus sous Windows. Assurez-vous que votre AMI et votre application sont correctement configurées pour prendre en charge les chemins de fichiers étendus de Windows si vous utilisez des chemins de fichiers de plus de 260 caractères.
+ Utilisez des chaînes de chemin de fichier échappées telles que
  + `"C:\\Windows\\System32\\notepad.exe"`

AbsoluteManifestPath  
+ Applicable uniquement si vous utilisez [Manifestes spécifiques à l'application](#application-specific-manifests)
+ Chemin d'accès au fichier manifeste de préchauffage pour cette application
+ Entre 0 et 32767 caractères
  + Cette limite supérieure de longueur de caractères est destinée à prendre en charge les chemins de fichiers étendus sous Windows. Assurez-vous que votre AMI et votre application sont correctement configurées pour prendre en charge les chemins de fichiers étendus de Windows si vous utilisez des chemins de fichiers de plus de 260 caractères.
+ Utilisez des chaînes de chemin de fichier échappées telles que
  + `"C:\\Path\\To\\PrewarmManifest.txt"`

AbsoluteIconPath  
+ Chemin d'accès au fichier d'icône sur l'AMI à utiliser pour l'application.
  + Cette icône sera montrée aux utilisateurs lors de la diffusion sur cette image.
  + Si aucune icône n'est fournie, l'icône sera dérivée de l'exécutable lui-même.
  + Veillez à sélectionner des fichiers d'icônes avec une transparence d'arrière-plan gérée de manière appropriée pour une bonne expérience client pour vos utilisateurs
    + Utiliser des images PNG
+ Entre 1 et 32 767 caractères
  + Cette limite supérieure de longueur de caractères est destinée à prendre en charge les chemins de fichiers étendus sous Windows. Assurez-vous que votre AMI et votre application sont correctement configurées pour prendre en charge les chemins de fichiers étendus de Windows si vous utilisez des chemins de fichiers de plus de 260 caractères.
+ Utilisez des chaînes de chemin de fichier échappées telles que
  + `"C:\\Path\\To\\ApplicationIcon.png"`

WorkingDirectory  
+ Le répertoire de travail dans lequel lancer votre application
+ Entre 0 et 32767 caractères
  + Cette limite supérieure de longueur de caractères est destinée à prendre en charge les chemins de fichiers étendus sous Windows. Assurez-vous que votre AMI et votre application sont correctement configurées pour prendre en charge les chemins de fichiers étendus de Windows si vous utilisez des chemins de fichiers de plus de 260 caractères.
+ Utilisez des chaînes de chemin de fichier échappées telles que
  + `"C:\\Path\\To\\Working\\Directory"`

LaunchParameters  
+ Chaîne à utiliser comme paramètres de lancement pour l'exécutable spécifié dans `AbsoluteAppPath`
+ Entre 0 et 1024 caractères
+ Utilisez des chaînes échappées avec la liste complète des paramètres de lancement requis, comme dans l'exemple suivant, qui montre comment vous pouvez utiliser PowerShell des scripts en tant qu'applications en utilisant l' PowerShell exécutable en tant qu'application avec un script fourni dans les paramètres de lancement.
  + AbsoluteAppPath
    + `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
  + LaunchParameters
    + `"-File \"C:\\Path\\To\\App\\Script.ps1\""`

### Exemple AppCatalogConfig


Ceci est un simple exemple d'un AppCatalogConfig pour Notepad, Google Chrome et Mozilla Firefox

```
[  
    {  
        "Name": "Notepad",  
        "DisplayName": "Notepad",  
        "AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
    },  
    {  
        "Name": "Chrome",  
        "DisplayName": "Chrome",  
        "AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
        "LaunchParameters": "https://www.amazon.com/"  
    },  
    {  
        "Name": "Firefox",  
        "DisplayName": "Firefox",  
        "AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
        "LaunchParameters": "https://aws.amazon.com/"  
    }  
 ]
```

# Exporter l'image
Exporter l'image

Vous pouvez exporter vos images pour les créer EC2 AMIs. Plus tard, vous pourrez [Importer une image](import-image.md) les AMIs récupérer pour créer des images WorkSpaces d'applications. Cela vous permet d'utiliser vos propres outils de personnalisation des AMI pour personnaliser vos images.

**Note**  
Lors de l'exportation, les composants suivants seront supprimés de vos images  
WorkSpaces Agent d'applications
La licence Microsoft incluait des applications, qui ont été ajoutées à l'aide d'Image Builder
Seules les images Microsoft Windows Server 2022 et 2025 peuvent être exportées.

## Exigences relatives au rôle IAM


**Important**  
Créez un rôle IAM avec les autorisations suivantes à utiliser pour l'exportation et l'importation :

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowCopyImage",  
            "Effect": "Allow",  
            "Action": "ec2:CopyImage",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowCreateTags",  
            "Effect": "Allow",  
            "Action": "ec2:CreateTags",  
            "Resource": "*"  
        }  
    ]  
}
```

Ajoutez la relation de confiance suivante pour ce rôle IAM

```
{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}
```

## Pour exporter une image


1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).

1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.

1. Dans la liste des images, sélectionnez l'image privée que vous souhaitez exporter.

1. Choisissez **Actions**, puis **Exporter**.

1. Dans la boîte de dialogue **Exporter une image**, tapez un **nom d'AMI** unique et éventuellement une **description de l'AMI** pour l'AMI.

1. Rôle **IAM : sélectionnez le rôle** IAM que vous avez créé pour l'exportation d'images.

1. Vous pouvez éventuellement copier les balises de votre image vers l'AMI en cochant la case **Copier les balises lors de l'exportation**.

1. Choisissez **Exporter l'image**.