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.
# Images
Vous pouvez créer des images Amazon WorkSpaces Applications contenant des applications que vous pouvez diffuser à vos utilisateurs, ainsi que les paramètres par défaut du système et des applications pour permettre à vos utilisateurs de démarrer rapidement avec ces applications. En revanche, vous ne pouvez pas modifier une image après sa création. 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. Si vous avez supprimé l'Image Builder, lancez un nouvel Image Builder basé sur votre image. Ensuite, apportez vos modifications et créez une nouvelle image. Pour plus d’informations, consultez [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md) et [Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications](tutorial-image-builder.md).
Les images mises à votre disposition sont répertoriées dans le **registre des images** de la console WorkSpaces Applications. Elles sont classées comme publiques, privées ou partagées. Vous pouvez utiliser n'importe lequel de ces types d'images pour lancer un générateur d'images et configurer un parc d' WorkSpaces applications. Les images partagées appartiennent à d’autres comptes Amazon Web Services et sont partagées avec vous. Les autorisations définies sur des images qui sont partagées avec vous peuvent limiter ce que vous pouvez faire avec ces images. Pour plus d’informations, consultez [Administrez les images de vos WorkSpaces applications Amazon](administer-images.md).
**Topics**
+ [Paramètres par défaut des applications et de Windows et performances de lancement des applications dans Amazon WorkSpaces Applications](customizing-appstream-images.md)
+ [Gérer les versions WorkSpaces des agents d'applications](base-images-agent.md)
+ [WorkSpaces Notes de mise à jour des agents d'applications](agent-software-versions.md)
+ [Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications](tutorial-image-builder.md)
+ [Administrez les images de vos WorkSpaces applications Amazon](administer-images.md)
+ [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)
+ [Création d’images basées sur Linux](create-linux-based-images.md)
+ [Utilisez des scripts de session pour gérer l'expérience de streaming de vos utilisateurs d'Amazon WorkSpaces Applications](use-session-scripts.md)
# Paramètres par défaut des applications et de Windows et performances de lancement des applications dans Amazon WorkSpaces Applications
Vous pouvez créer des paramètres par défaut pour les applications et Windows pour permettre à vos utilisateurs de démarrer rapidement avec leurs applications, sans devoir créer ou configurer les paramètres eux-mêmes.
WorkSpaces Les applications optimisent les performances de lancement de vos applications pour les sessions de streaming de vos utilisateurs. Pour vous assurer que tous les fichiers requis sont inclus dans ce processus, vous devrez peut-être ajouter manuellement certains fichiers et dossiers au manifeste d'optimisation.
**Topics**
+ [Création de paramètres d'application et Windows par défaut pour les utilisateurs de vos WorkSpaces applications](creating-default-app-Windows-settings.md)
+ [Optimisation des performances de lancement de vos applications dans Amazon WorkSpaces Applications](optimizing-app-launch-performance.md)
# Création de paramètres d'application et Windows par défaut pour les utilisateurs de vos WorkSpaces applications
Les personnalisations des applications et les paramètres Windows qui sont enregistrés dans le dossier de profil utilisateur Windows ou dans le hive du registre de l'utilisateur peuvent être définis comme valeurs par défaut. Lorsque vous enregistrez les paramètres par défaut à l'aide de l'**utilisateur modèle** dans Image Assistant, WorkSpaces Applications remplace le profil utilisateur par défaut de Windows par le profil que vous configurez. Le profil utilisateur Windows par défaut est ensuite utilisé pour créer les paramètres initiaux pour les utilisateurs dans l’instance de flotte. Si les paramètres des applications ou de Windows que vous configurez ne fonctionnent pas dans la flotte, assurez-vous qu’ils sont enregistrés dans le profil utilisateur Windows. Pour plus d’informations, consultez Étape 3 : créer des paramètres par défaut pour les applications et Windows dans [Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications](tutorial-image-builder.md).
Les paramètres par défaut que vous pouvez créer et configurer sont les suivants :
+ Des préférences d'application, y compris une page d'accueil pour le navigateur, des personnalisations de barre d'outils et des paramètres de sécurité.
+ Des paramètres de données d'application, y compris des signets de navigateur et des profils de connexion.
+ Des paramètres d'expérience Windows, y compris l'affichage des extensions de nom de fichier et des dossiers masqués.
En outre, vous pouvez modifier ou désactiver les paramètres de sécurité Internet Explorer tels que la Configuration de sécurité renforcée (ESC). Pour de plus amples informations, veuillez consulter [Désactiver la configuration de sécurité renforcée d'Internet Explorer dans Amazon WorkSpaces Applications](customize-fleets-disable-ie-esc.md).
# Optimisation des performances de lancement de vos applications dans Amazon WorkSpaces Applications
Lorsque vous créez une image, WorkSpaces Applications vous demande d'optimiser les performances de lancement de vos applications pour les sessions de streaming de vos utilisateurs. Lorsque vos applications sont ouverts au cours de ce processus, assurez-vous qu'elles utilisent les composants initiaux requis par vos utilisateurs. Cela permet de s'assurer que ces composants sont capturés par le processus d'optimisation. Dans certains cas, tous les fichiers nécessaires aux optimisations ne sont pas détectés. Parmi les exemples de ces fichiers, on pourrait citer les plug-ins ou composants qui ne sont pas ouverts dans l'Image Builder. Pour vous assurer que tous les fichiers nécessaires pour votre application soient capturés, vous pouvez les inclure dans le manifeste d'optimisation. L’ajout de fichiers au manifeste d’optimisation peut augmenter le temps nécessaire à la création et à la mise à disposition des utilisateurs des instances de flotte. Cependant, cela réduit le temps nécessaire au lancement initial de l'application sur l'instance de flotte.
Pour optimiser tous les fichiers d'un dossier, ouvrez PowerShell et utilisez la PowerShell commande suivante :
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Par défaut, Image Assistant remplace le manifeste d’optimisation de l’application à chaque exécution de l’étape **Optimiser** d’Image Assistant. Vous devez exécuter la PowerShell commande pour optimiser tous les fichiers d'un dossier :
+ après chaque exécution de l’étape **Optimiser** ;
+ avant de choisir **Se déconnecter et créer une image** sur la page **Vérifier** d’Image Assistant.
Vous pouvez également spécifier le manifeste d’optimisation indépendamment pour chaque application en utilisant les opérations d’interface de ligne de commande (CLI) Image Assistant. Lorsque vous spécifiez le manifeste d'optimisation à l'aide des opérations de la CLI d'Image Assistant, WorkSpaces Applications fusionne le manifeste d'optimisation d'application spécifié avec les fichiers identifiés par l'étape Image Assistant **Optimize**. 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érer les versions WorkSpaces des agents d'applications
L'agent WorkSpaces Applications est un logiciel qui s'exécute sur vos instances de streaming et permet aux utilisateurs de diffuser des applications. Lorsque vous créez une nouvelle image, l'option **Toujours utiliser la version la plus récente de l'agent** est sélectionnée par défaut. Lorsque cette option est sélectionnée, les nouveaux générateurs d'images ou les nouvelles instances de parc lancés à partir de votre image utilisent toujours la dernière version de l'agent WorkSpaces Applications. Vous souhaiterez peut-être contrôler les mises à jour de l’agent pour garantir la compatibilité avec votre logiciel ou pour qualifier l’environnement mis à jour avant de le déployer pour vos utilisateurs finaux.
Les procédures suivantes décrivent comment gérer les versions WorkSpaces des agents d'applications.
**Topics**
+ [Créez une image qui utilise toujours la dernière version de l'agent d' WorkSpaces applications](create-image-that-always-uses-latest-agent.md)
+ [Création d'une image utilisant une version spécifique de l'agent d' WorkSpaces applications](create-image-that-uses-specific-agent.md)
+ [Création d'une image utilisant une version plus récente de l'agent d' WorkSpaces applications](create-image-that-uses-newer-agent.md)
# Créez une image qui utilise toujours la dernière version de l'agent d' WorkSpaces applications
Lorsque vos images sont configurées pour toujours utiliser la dernière version de l'agent 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.
**Note**
Dans certains cas, une nouvelle version de l'agent d' WorkSpaces applications peut entrer en conflit avec votre logiciel. Nous vous recommandons de qualifier la nouvelle version de l'agent WorkSpaces Applications avant de la déployer dans vos flottes de production.
**Pour créer une image qui utilise toujours la dernière version de l'agent WorkSpaces Applications**
1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home).
1. Effectuez l’une des actions suivantes :
+ Si vous avez un Image Builder que vous souhaitez utiliser pour créer l’image, démarrez-le, puis connectez-vous-y. Si le générateur d'images n'exécute pas la dernière version de l'agent WorkSpaces Applications, vous êtes invité à choisir de démarrer le générateur d'images avec l'agent le plus récent. Assurez-vous que cette option est sélectionnée, choisissez **Démarrer**, puis connectez-vous à l’Image Builder.
+ Si vous n’avez pas un Image Builder que vous souhaitez utiliser pour créer l’image, lancez un nouvel Image Builder. À **l'étape 1 : Choisissez une image**, choisissez une image de AWS base ou une image personnalisée. À l'**étape 2 : Configuration d'Image Builder**, si l'image que vous choisissez n'exécute pas la dernière version de l'agent WorkSpaces Applications, la section **WorkSpaces Applications** s'affiche. Dans la liste **Version de l’agent,** sélectionnez la dernière version de l’agent. Suivez les étapes restantes pour créer l’Image Builder, puis connectez-vous à celui-ci. Pour plus d’informations, consultez [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md).
1. Sur le bureau de l’Image Builder, ouvrez Image Assistant et suivez les étapes pour créer votre image. Pour l'étape **Configurer une image**, assurez-vous que **Toujours utiliser la dernière version de l'agent** est sélectionné. Pour de plus amples informations, veuillez consulter [Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications](tutorial-image-builder.md).
Si vous décidez ultérieurement de ne pas toujours utiliser la dernière version de l'agent WorkSpaces Applications, vous devez créer une nouvelle image et désactiver cette option.
1. Créez un parc ou modifiez-en un existant. Lorsque vous configurez la flotte, sélectionnez la nouvelle image que vous avez créée. Pour plus d’informations, consultez [Créez un parc et une pile d' WorkSpaces applications Amazon](set-up-stacks-fleets.md).
1. Créez une nouvelle pile ou modifiez une pile existante et associez-la à votre flotte.
# Création d'une image utilisant une version spécifique de l'agent d' WorkSpaces applications
Vous souhaiterez peut-être contrôler WorkSpaces les mises à jour des agents d'applications plutôt que de toujours utiliser la dernière version afin de pouvoir d'abord tester la compatibilité. Pour vous assurer que la version de l'agent WorkSpaces Applications que vous utilisez est compatible avec vos applications de streaming, vous pouvez créer une image qui utilise une version spécifique du logiciel de l'agent. Ensuite, effectuez vos tests de qualification dans une flotte distincte avant le déploiement dans votre flotte de production.
Lorsque vous créez l’image, l’option **Toujours utiliser la version la plus récente de l’agent** n’est pas sélectionnée. Cela permet d'associer votre image à la version de l'agent WorkSpaces Applications que vous avez sélectionnée lorsque vous avez lancé le générateur d'images, plutôt que d'utiliser toujours la dernière version. Une fois que vous avez terminé vos essais de qualification, vous pouvez mettre à jour votre flotte de production avec l’image.
**Pour créer une image utilisant une version spécifique de l'agent WorkSpaces Applications**
1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home).
1. Effectuez l’une des actions suivantes :
+ Si vous avez un Image Builder que vous souhaitez utiliser pour créer l’image, démarrez-le, puis connectez-vous-y.
+ Si vous n’avez pas un Image Builder que vous souhaitez utiliser pour créer l’image, lancez un nouvel Image Builder. À **l'étape 1 : Choisissez une image**, choisissez une image de AWS base ou une image personnalisée. À l'**étape 2 : Configuration d'Image Builder**, si l'image que vous choisissez n'exécute pas la dernière version de l'agent WorkSpaces Applications, la section **WorkSpaces Applications** s'affiche. Dans la liste **Version de l'agent,** ne sélectionnez pas la dernière version de l'agent. Suivez les étapes restantes pour créer l’Image Builder, puis connectez-vous à celui-ci. Pour plus d’informations, consultez [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md).
1. Sur le bureau de l’Image Builder, ouvrez Image Assistant et suivez les étapes pour créer votre image. Pour l’étape **Configurer une image** dans Image Assistant, assurez-vous que **Toujours utiliser la dernière version de l’agent** n’est pas sélectionné. Pour de plus amples informations, veuillez consulter [Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications](tutorial-image-builder.md).
Si vous décidez ultérieurement de toujours utiliser la dernière version de l'agent WorkSpaces Applications, vous devez créer une nouvelle image et sélectionner cette option.
1. Créez un parc ou modifiez-en un existant. Lorsque vous configurez la flotte, sélectionnez la nouvelle image que vous avez créée. Pour plus d’informations, consultez [Créez un parc et une pile d' WorkSpaces applications Amazon](set-up-stacks-fleets.md).
1. Créez une nouvelle pile ou modifiez une pile existante et associez-la à votre flotte.
1. Connectez-vous à votre flotte et testez vos applications pour la compatibilité.
# Création d'une image utilisant une version plus récente de l'agent d' WorkSpaces applications
Si vous épinglez votre image sur une version spécifique de l'agent d' WorkSpaces applications, vous devez passer à une version plus récente en créant une nouvelle image. Cette approche vous permet de tester la compatibilité de chaque mise à jour de l’agent, puis de mettre à jour votre flotte de façon incrémentielle.
Lorsque vous créez l’image, l’option **Toujours utiliser la version la plus récente de l’agent** n’est pas sélectionnée. Après la création de votre image, effectuez vos tests de qualification dans une flotte distincte avant le déploiement dans votre flotte de production. Une fois que vous avez terminé vos essais de qualification, vous pouvez mettre à jour votre flotte de production avec l’image.
**Pour créer une image utilisant une version plus récente de l'agent WorkSpaces Applications**
1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home).
1. Effectuez l’une des actions suivantes :
+ Si vous avez un Image Builder que vous souhaitez utiliser pour créer l’image, démarrez-le, puis connectez-vous-y. Si le générateur d'images n'exécute pas la dernière version de l'agent WorkSpaces Applications, vous êtes invité à choisir de démarrer le générateur d'images avec l'agent le plus récent. Assurez-vous que cette option est sélectionnée, choisissez **Démarrer**, puis connectez-vous à l’Image Builder.
+ Si vous n’avez pas un Image Builder que vous souhaitez utiliser pour créer l’image, lancez un nouvel Image Builder. À **l'étape 1 : Choisissez une image**, choisissez une image de AWS base ou une image personnalisée. À l'**étape 2 : Configuration d'Image Builder**, si l'image que vous choisissez n'exécute pas la dernière version de l'agent WorkSpaces Applications, la section **WorkSpaces Applications** s'affiche. Dans la liste **Version de l’agent,** sélectionnez la dernière version de l’agent. Suivez les étapes restantes pour créer l’Image Builder, puis connectez-vous à celui-ci. Pour plus d’informations, consultez [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md).
1. Sur le bureau de l’Image Builder, ouvrez Image Assistant et suivez les étapes pour créer votre image. Pour l’étape **Configurer une image** dans Image Assistant, assurez-vous que **Toujours utiliser la dernière version de l’agent** n’est pas sélectionné. Pour de plus amples informations, veuillez consulter [Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications](tutorial-image-builder.md).
Si vous décidez ultérieurement de toujours utiliser la dernière version de l'agent WorkSpaces Applications, vous devez créer une nouvelle image et sélectionner cette option.
1. Créez un parc ou modifiez-en un existant. Lorsque vous configurez la flotte, sélectionnez la nouvelle image que vous avez créée. Pour plus d’informations, consultez [Créez un parc et une pile d' WorkSpaces applications Amazon](set-up-stacks-fleets.md).
1. Créez une nouvelle pile ou modifiez une pile existante et associez-la à votre flotte.
1. Connectez-vous à votre flotte et testez vos applications pour la compatibilité.
# WorkSpaces Notes de mise à jour des agents d'applications
Le logiciel d'agent Amazon WorkSpaces Applications s'exécute sur vos instances de streaming, permettant aux utilisateurs finaux de se connecter à leurs applications de streaming et de les démarrer. À compter du 7 décembre 2017, vos instances de streaming pourront être automatiquement mises à jour avec les dernières fonctionnalités, améliorations de performances et mises à jour de sécurité disponibles sur AWS. Avant le 7 décembre 2017, les mises à jour de l'agent étaient incluses dans les nouvelles versions des images de base.
Pour utiliser le dernier logiciel d'agent d' WorkSpaces applications, vous devez reconstruire vos images à l'aide de nouvelles images de base publiées avant AWS le 7 décembre 2017 ou après cette date. Dans ce cas, l'option d'activation des mises à jour automatiques de l'agent est sélectionnée par défaut dans l'Image Assistant. Nous vous recommandons de laisser cette option sélectionnée pour que toute nouvelle instance Image Builder ou de flotte qui est lancée à partir de votre image utilise toujours la dernière version de l’agent. Pour de plus amples informations, veuillez consulter [Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications](tutorial-image-builder.md).
Le tableau suivant décrit les dernières mises à jour disponibles dans les versions publiées de l'agent WorkSpaces Applications pour les instances Windows.
| Version de l'agent Amazon WorkSpaces Applications | Modifications |
| --- | --- |
| 02-09-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-04-2026 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-06-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 02/10/2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 30/09/2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 15/07/2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 29/05/2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-05-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-07-2025 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 31-10-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-10-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 18-09-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-05-2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 15/04/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/01/2024 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-07-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-06-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 30/05/2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-08-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 13/04/2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-03-2023 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 13-10-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 20/06/2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 14/03/2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 21-02-2022 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 20-12-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 19-10-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 08/02/2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 01/07/2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 25/06/2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 17/05/2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 17-12-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-04-2021 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 17-12-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 09-01-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 30/07/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 27/05/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-20-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 02-19-2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 13/01/2020 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 11-13-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-08-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 23-09-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 09/03/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 08/08/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 26/07/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 19/06/2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-07-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 04-02-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-07-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-22-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-08-2019 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-19-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-17-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 12-04-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 11-14-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-30-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-24-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 10-01-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 08-29-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-26-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-19-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 06-06-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-31-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 05-21-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 03-19-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 01-24-2018 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
| 07-12-2017 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/agent-software-versions.html) |
# Tutoriel : Création d'une image d' WorkSpaces applications personnalisée à l'aide de la console WorkSpaces d'applications
Ce didacticiel explique comment créer des images d' WorkSpaces applications basées sur les systèmes d'exploitation Microsoft Windows Server. Si vous souhaitez créer des images personnalisées basées sur les systèmes d'exploitation Amazon Linux 2, Rocky Linux ou Red Hat Enterprise Linux, consultez[Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée](tutorial-create-linux-image.md).
Dans ce didacticiel, vous allez apprendre à créer une image Amazon WorkSpaces Applications personnalisée contenant des applications que vous pouvez diffuser à vos utilisateurs, ainsi que des paramètres d'application et Windows par défaut pour permettre à vos utilisateurs de démarrer rapidement avec leurs applications. Pour suivre ce didacticiel, vous devez déjà disposer d’une instance Image Builder. Si vous n’avez pas d’instance Image Builder à utiliser, consultez [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md).
**Important**
Ce didacticiel contient des informations qui s’appliquent à la dernière publication sur les images de base. Pour de plus amples informations, veuillez consulter [WorkSpaces Notes de mise à jour de l'image de base et de l'image gérée des applications](base-image-version-history.md).
**Topics**
+ [Étape 1 : installer des applications sur l’instance Image Builder](#tutorial-image-builder-install)
+ [Étape 2 : Création d'un catalogue d' WorkSpaces applications](#tutorial-image-builder-add)
+ [Étape 3 : créer des paramètres par défaut pour Windows et les applications](#tutorial-image-builder-create-default-app-settings)
+ [Étape 4 : tester les applications](#tutorial-image-builder-test-applications)
+ [Étape 5 : optimiser les applications](#tutorial-image-builder-optimize)
+ [Étape 6 : terminer la création de l’image](#tutorial-image-builder-finish-create-image)
+ [Étape 7 (facultative) : baliser et copier une image](#tutorial-image-builder-tag-copy)
+ [Étape 8 : nettoyer](#tutorial-image-builder-finish)
## Étape 1 : installer des applications sur l’instance Image Builder
Au cours de cette étape, vous allez connecter une instance Image Builder et y installer vos applications.
**Important**
Pour terminer l’étape, connectez-vous à l’instance Image Builder avec le compte **Administrateur** local ou un compte de domaine disposant des autorisations d’administrateur local. Ne renommez pas ou ne supprimez pas le compte **Administrateur** local intégré. Si vous renommez ou supprimez le compte, l’instance Image Builder ne démarre pas et la création de l’image échoue.
**Pour installer des applications sur l’instance Image Builder**
1. Connectez-vous à l’instance Image Builder en effectuant l’une des actions suivantes :
+ [Utiliser la console WorkSpaces Applications](managing-image-builders-connect-console.md) (pour les connexions Web uniquement)
+ [Création d'une URL de streaming](managing-image-builders-connect-streaming-URL.md) (pour les connexions client Web ou WorkSpaces applicatives)
**Note**
Si le générateur d'images auquel vous souhaitez vous connecter est joint à un domaine Active Directory et que votre organisation doit se connecter par carte à puce, vous devez créer une URL de streaming et utiliser le client WorkSpaces Applications pour la connexion. Pour plus d’informations sur la connexion par carte à puce, consultez [Cartes à puce](feature-support-USB-devices-qualified.md#feature-support-USB-devices-qualified-smart-cards).
1. Installez des applications à partir d'un site web ou de toute autre source de téléchargement. Installez les applications que vous souhaitez avant de passer à l'étape suivante.
**Note**
Téléchargez et installez uniquement les applications de sites dans lesquels vous avez confiance.
Si une application nécessite le redémarrage du système d'exploitation Windows, effectuez cette opération. Avant le redémarrage du système d’exploitation, vous êtes déconnecté de votre instance Image Builder. Une fois que le redémarrage est effectué, connectez-vous de nouveau à l'Image Builder, puis terminez l'installation de l'application.
## Étape 2 : Création d'un catalogue d' WorkSpaces applications
Au cours de cette étape, créez un catalogue d' WorkSpaces applications en spécifiant des applications (*.exe*), des scripts batch (*.bat*) et des raccourcis d'applications (*.lnk*) pour 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. Si vous choisissez un raccourci d'application, ces valeurs sont préremplies pour vous.
**Important**
Pour terminer l’étape, vous devez être connecté à l’instance Image Builder avec le compte **Administrateur** local ou un compte de domaine ayant les autorisations d’administrateur local.
**Pour créer un catalogue d' WorkSpaces applications**
1. À partir du bureau de l'Image Builder, ouvrez l'application Image Assistant. Image Assistant vous guide tout au long du processus de création d'image.
![\[Row of icons representing different functions in Image Assistant interface.\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/images/Image-Builder-Desktop-Image-Assistant.png)
1. Dans **1. Ajouter des applications**, choisissez **\$1 Ajouter une application** et naviguez jusqu’à l’emplacement de l’application, du script ou du raccourci à ajouter. Choisissez **Ouvrir**.
1. Dans la boîte de dialogue **Paramètres de lancement de l’application**, conservez ou modifiez les paramètres par défaut pour **Nom**, **Nom d’affichage** et **Chemin d’accès à l’icône**. Le cas échéant, vous pouvez spécifier des paramètres de lancement (arguments supplémentaires transmis à l'application lorsqu'elle est lancée) et un répertoire de travail pour l'application. Lorsque vous avez terminé, sélectionnez **Enregistrer**.
Les paramètres **Display Name (Nom d'affichage)** et **Icon Path (Chemin d'accès à l'icône)** déterminent la façon dont le nom et l'icône de votre application apparaissent dans le catalogue d'applications. Le catalogue s'affiche pour les utilisateurs lorsqu'ils se connectent à une session de streaming d' WorkSpaces applications.
1. Répétez les étapes 2 et 3 pour chaque application dans Image Assistant et confirmez que les applications apparaissent sur l'onglet**Add Apps (Ajouter des applications)**. Lorsque vous avez terminé, choisissez **Suivant** pour continuer à utiliser Image Assistant pour créer votre image.
## Étape 3 : créer des paramètres par défaut pour Windows et les applications
Au cours de cette étape, vous créez les paramètres d'application et Windows par défaut pour les utilisateurs de vos WorkSpaces applications. Cela permet à vos utilisateurs de démarrer rapidement avec les applications pendant leurs sessions de streaming d' WorkSpaces applications, sans avoir à créer ou à configurer eux-mêmes ces paramètres.
**Important**
Pour terminer cette étape, vous devrez être connecté à l'Image Builder avec le compte local **Template User (Utilisateur de modèle)** ou un compte utilisateur du domaine qui ne dispose pas des autorisations d'administrateur local.
**Pour créer des paramètres par défaut pour Windows et les applications pour vos utilisateurs**
1. Dans Image Assistant, dans **2. Configurer les applications**, choisissez **Changer d’utilisateur**. Cela déconnecte votre session actuelle et affiche le menu de connexion.
1. Effectuez l’une des actions suivantes :
+ Si l’instance Image Builder n’est pas jointe à un domaine Active Directory, sous l’onglet **Utilisateur local**, choisissez **Utilisateur modèle**. Ce compte vous permet de créer des paramètres par défaut pour Windows et les applications.
+ Si votre Image Builder est joint à un domaine Active Directory, choisissez l'onglet **Directory User (Utilisateur Directory)**, connectez-vous en tant qu'utilisateur du domaine ne disposant pas des autorisations d'administrateur local.
1. À partir du bureau de l’instance Image Builder, ouvrez Image Assistant, qui affiche les applications que vous avez ajoutées lorsque vous avez créé le catalogue d’applications.
1. Choisissez l'application pour laquelle vous souhaitez créer des paramètres d'application par défaut.
1. Lorsque l'application est ouverte, créez ces paramètres en fonction des besoins.
1. Lorsque vous avez terminé, fermez l'application et revenez à Image Assistant.
1. Si vous avez spécifié plusieurs applications dans Image Assistant, répétez les étapes 4 à 6 pour chaque application en fonction des besoins.
1. Si vous souhaitez définir des paramètres Windows par défaut, faites-le maintenant. Lorsque vous avez terminé, revenez à Image Assistant.
1. Choisissez **Switch user (Changer d'utilisateur)** et connectez-vous avec le même compte que celui que vous avez utilisé pour créer le catalogue d'applications (un compte qui dispose des autorisations d'administrateur local).
1. Dans Image Assistant, dans **2. Configurer les applications**, exécutez l’une des actions suivantes :
+ Si votre Image Builder n'est pas joint à un domaine Active Directory, choisissez **Save settings (Enregistrer les paramètres)**.
+ Si l’instance Image Builder est jointe à un domaine Active Directory, dans la liste **Choose which user settings to copy (Choisir les paramètres utilisateur à copier)**, choisissez le même compte que celui que vous avez utilisé pour vous connecter à l’instance Image Builder lorsque vous avez créé les paramètres d’application et Windows par défaut, puis choisissez **Save settings (Enregistrer les paramètres)**.
La liste **Choisir les paramètres à copier** affiche tous les comptes utilisateur dont les paramètres sont enregistrés sur l’instance Image Builder.
1. Lorsque vous avez terminé, choisissez **Suivant** pour continuer à créer votre image.
## Étape 4 : tester les applications
Dans cette étape, vérifiez que les applications que vous avez ajoutées s'ouvrent correctement et fonctionnent comme prévu. Pour ce faire, démarrez une nouvelle session Windows en tant qu'utilisateur disposant d'autorisations similaires à celles de vos utilisateurs.
**Important**
Pour terminer l’étape, vous devez vous connecter à l’instance Image Builder avec le compte **Utilisateur test** ou un compte de domaine ne disposant pas des autorisations d’administrateur local.
**Pour tester vos applications**
1. Dans Image Assistant, dans **3. Test**, exécutez l’une des actions suivantes :
+ Si votre Image Builder n'est pas joint à un domaine Active Directory, choisissez **Switch user (Changer d'utilisateur)**.
+ Si l’instance Image Builder est jointe à un domaine Active Directory, vous avez besoin d’un compte de domaine pour tester les applications ; si l’utilisateur dispose déjà de paramètres sur l’instance Image Builder, vous devez réinitialiser ses paramètres d’application. Pour ce faire, sélectionnez l'utilisateur à partir de la liste **User to reset (Utilisateur à réinitialiser)**, puis choisissez **Reset (Réinitialiser)**. Lorsque vous avez terminé, sélectionnez **Switch user (Changer d'utilisateur)**.
**Note**
Si votre Image Builder est nouveau et qu'aucun utilisateur n'a de paramètres dessus, la liste n'affiche aucun utilisateur.
1. Choisissez le compte utilisateur à utiliser pour les tests en exécutant l’une des actions suivantes :
+ Si votre Image Builder n'est pas joint à un domaine Active Directory, choisissez **Test User (Tester l'utilisateur)**. Ce compte vous permet de tester vos applications en utilisant les mêmes stratégies et autorisations que vos utilisateurs.
+ Si l’instance Image Builder est jointe à un domaine Active Directory, choisissez **Utilisateur Active Directory**, spécifiez les informations d’identification d’un compte de domaine ne disposant pas des autorisations d’administrateur local, puis choisissez **Connexion**.
1. À partir du bureau de l’instance Image Builder, ouvrez Image Assistant, qui affiche les applications que vous avez spécifiées lorsque vous avez créé le catalogue d’applications.
1. Choisissez l'application que vous souhaitez tester, pour confirmer qu'elle s'ouvre correctement et que tous les paramètres d'application par défaut que vous avez créés sont appliqués.
1. Lorsque l'application est ouverte, testez-la selon vos besoins. Lorsque vous avez terminé, fermez l'application et revenez à Image Assistant.
1. Si vous avez spécifié plusieurs applications dans Image Assistant, répétez les étapes 4 à 5 pour tester chaque application en fonction des besoins.
1. Lorsque vous avez terminé, sélectionnez **Switch User (Changer d'utilisateur)**, puis effectuez l'une des actions suivantes :
+ Si l’instance Image Builder n’est pas jointe à un domaine Active Directory, sous l’onglet **Utilisateur local**, choisissez **Administrateur**.
+ Si votre Image Builder est joint à un domaine Active Directory et que vous étiez connecté en tant qu'utilisateur du domaine disposant des autorisations d'administrateur local pour spécifier des applications dans Image Assistant, connectez-vous sous le même utilisateur.
1. Choisissez **Suivant** pour continuer à créer votre image.
## Étape 5 : optimiser les applications
Au cours de cette étape, Image Assistant ouvre vos applications l'une après l'autre, identifie leurs dépendances de lancement et effectue des optimisations pour s'assurer que les applications se lancent rapidement. Il s'agit des étapes obligatoires effectuées sur toutes les applications de la liste.
**Pour optimiser vos applications**
1. Dans Image Assistant, dans **4. Optimiser**, choisissez **Lancer**.
1. WorkSpaces Applications lance automatiquement la première application de votre liste. Lorsque l'application a complètement démarré, fournissez toute entrée requise pour procéder à la première exécution de l'application. Par exemple, un navigateur Web peut vous inviter à importer des paramètres avant d'être totalement opérationnel.
1. Une fois que vous avez terminé la première exécution et vérifié que l'application fonctionne comme prévu, choisissez **Continue (Continuer)**. Si vous avez ajouté plus d'une application à votre image, chaque application s'ouvre automatiquement. Répétez cette étape pour chaque application en fonction des besoins, en gardant toutes les applications en cours d'exécution.
1. Lorsque vous avez terminé, l’onglet suivant dans Image Assistant, **5. Configurer l’image**, s’affiche automatiquement.
## Étape 6 : terminer la création de l’image
Au cours de cette étape, vous allez attribuer un nom à l’image et achever sa création.
**Pour créer l’image**
1. Saisissez un nom unique pour l'image, puis un nom d'affichage et une description (facultatifs). Le nom de l'image ne peut pas commencer par « Amazon »AWS, «, » ou « »AppStream.
Vous pouvez également ajouter une ou plusieurs balise(s) à l'image. Pour ce faire, sélectionnez **Add tags (Ajouter des balises)**, puis tapez 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). Lorsque vous avez terminé, sélectionnez **Next**.
**Note**
Si vous choisissez une image de base publiée AWS le 7 décembre 2017 ou après cette date, l'option **Toujours utiliser la dernière version de l'agent** apparaît, sélectionnée par défaut. Nous vous recommandons de laisser cette option sélectionnée pour que les instances de streaming qui sont lancées à partir de l'image utilisent toujours la dernière version de l'agent. Si vous désactivez l’option, vous ne pouvez pas l’activer à nouveau une fois la création de l’image terminée. Pour plus d'informations sur la dernière version de l'agent WorkSpaces Applications, consultez[WorkSpaces Notes de mise à jour des agents d'applications](agent-software-versions.md).
1. Dans **6. Vérifier**, vérifiez les détails de l’image. Pour effectuer des modifications, choisissez **Previous (Précédent)** pour accéder à l'onglet Image Assistant approprié, effectuez les modifications nécessaires, puis suivez les étapes indiquées dans Image Assistant en fonction des besoins.
1. Après avoir vérifié les détails de l'image, choisissez **Disconnect and Create Image (Se déconnecter et créer l'image)**.
1. La session à distance se déconnecte quelques instants plus tard. Lorsque le message **Connectivité perdue** s’affiche, fermez l’onglet du navigateur. Pendant la création de l’image, l’instance Image Builder a pour état **Création de l’instantané en cours**. Vous ne pouvez pas vous connecter à l'Image Builder tant que ce processus n'est pas terminé.
1. Revenez à la console et naviguez jusqu’à **Images**, **Registre d’images**. Vérifiez que la nouvelle image figure dans la liste.
Pendant la création de l'image, l'état de l'image dans le registre d'images de la console apparaît comme **Pending (En suspens)** et vous ne pouvez pas vous y connecter.
1. Choisissez l'icône **Refresh (Actualiser)** régulièrement pour mettre l'état à jour. Une fois que votre image est créée, l'état de l'image devient **Available (Disponible)** et l'Image Builder est automatiquement arrêté.
Pour continuer à créer des images, démarrez l'Image Builder et connectez-vous y à partir de la console, ou créez un nouvel Image Builder.
**Note**
Après la création de l’image, vous êtes responsable de la maintenance des mises à jour du système d’exploitation Windows. Pour ce faire, vous pouvez utiliser les mises à jour d'image WorkSpaces des applications gérées. Vous êtes également responsable de la maintenance des mises à jour de vos applications et de leurs dépendances. Pour de plus amples informations, veuillez consulter [Conservez l'image de vos WorkSpaces applications Amazon Up-to-Date](keep-image-updated.md).
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.
## Étape 7 (facultative) : baliser et copier une image
Vous pouvez ajouter une ou plusieurs balise(s) à une image pendant ou après sa création. Vous pouvez également copier l’image dans la même région, ou dans une nouvelle région du même compte Amazon Web Services. La copie d'une image source permet d'obtenir une image de destination identique mais distincte. AWS ne copie toutefois aucune balise définie par l'utilisateur. De plus, vous pouvez uniquement copier les images personnalisées que vous créez, pas les images de base fournies par AWS.
**Note**
Vous ne pouvez pas copier simultanément plus de deux images vers une destination. Si la destination vers laquelle vous copiez une image atteint la limite d'images, vous recevez une erreur. Dans ce cas, avant de copier l’image, vous devez supprimer des images de la destination. Une fois que le nombre d’images de la région de destination est inférieur au quota (aussi appelé limite) défini, lancez la copie d’image à partir de la région source. Pour plus d’informations, consultez [Quotas du Service Amazon WorkSpaces Applications](limits.md).
**Pour ajouter des balises à une image existante**
1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.
1. Dans la liste des images, sélectionnez celle à laquelle vous souhaitez ajouter des balises.
1. Choisissez **Tags**, **Add/Edit Tags**, **Add Tag**, puis spécifiez la clé et la valeur de la balise, et choisissez **Save**.
Pour de plus amples informations, veuillez consulter [Marquer les ressources de vos WorkSpaces applications Amazon](tagging-basic.md).
**Pour copier une image**
La copie d'une image entre différentes régions géographiques vous permet de diffuser des applications à partir de plusieurs régions, à partir de la même image. En diffusant vos applications au plus près de vos utilisateurs, vous pouvez améliorer l'expérience de vos utilisateurs en diffusant des applications avec WorkSpaces Applications.
1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.
1. Dans la liste des images, sélectionnez celle à copier.
1. Choisissez **Actions**, puis **Copier**.
1. Dans la boîte de dialogue **Copier une image**, spécifiez les informations suivantes, puis choisissez **Copier l’image** :
+ Pour **Destination region** (Région de destination), choisissez la région vers laquelle copier la nouvelle image.
+ Pour **Name** (Nom), spécifiez un nom que l'image aura lorsqu'elle sera copiée dans la destination.
+ Pour **Description** (facultatif), spécifiez une description que l'image aura lorsqu'elle sera copiée dans la destination.
1. Pour vérifier la progression de l'opération de copie, revenez dans la console et naviguez jusqu'à **Images**, **Image Registry** (Registre d'images). Utilisez la barre de navigation pour basculer vers la région de destination (le cas échéant) et vérifiez que la nouvelle image s’affiche dans la liste des images.
La nouvelle image s'affiche d'abord avec un statut **Copying** (En cours de copie) dans le registre d'images de votre console. Lorsque l'image est créée avec succès, l'état de l'image devient **Available**, ce qui signifie que vous pouvez désormais utiliser l'image pour lancer une pile et diffuser vos applications.
## Étape 8 : nettoyer
Enfin, arrêtez vos instances Image Builder en cours d'exécution pour libérer des ressources et éviter l'imputation de frais inutiles à votre compte. Il est recommandé d’arrêter toutes les instances Image Builder en cours d’exécution et non utilisées. Pour plus d'informations, consultez la section [Tarification des WorkSpaces applications](https://aws.amazon.com/appstream2/pricing/).
**Pour arrêter une instance Image Builder en cours d’exécution**
1. Dans le volet de navigation, choisissez **Images**, **Instances Image Builder**, puis sélectionnez l’instance Image Builder en cours d’exécution.
1. Choisissez **Actions**, puis **Arrêter**.
# Administrez les images de vos WorkSpaces applications Amazon
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
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
**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
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
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
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
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
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
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
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
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\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
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**.
# Créez votre image Amazon WorkSpaces Applications par programmation à l'aide des opérations de la CLI de l'Assistant Image
Vous pouvez créer des images Amazon WorkSpaces Applications en vous connectant à un générateur d'images et en utilisant les opérations de l'interface utilisateur graphique (GUI) ou de l'interface de ligne de commande (CLI) d'Image Assistant. Les opérations d'interface de ligne de commande Image Assistant fournissent des fonctionnalités similaires à l’interface utilisateur graphique d’Image Assistant. Avec ces opérations, vous pouvez effectuer les actions suivantes par programmation :
+ Gérer les applications incluses dans une image.
+ Enregistrer, mettre à jour et réinitialiser les paramètres par défaut d’une application.
+ Activez ou désactivez le framework WorkSpaces d'applications dynamiques des applications.
+ Spécifier des balises.
+ Créer une image.
Vous pouvez utiliser ces opérations pour intégrer la création d'images d' WorkSpaces applications à votre processus de développement logiciel d'intégration continue ou de déploiement.
Pour utiliser les opérations d’interface de ligne de commande d’Image Assistant, utilisez le shell de ligne de commande de votre choix sur un Image Builder. Par exemple, vous pouvez utiliser l'invite de commande Windows ou PowerShell.
**Note**
Le générateur d'images doit utiliser une version de l'agent WorkSpaces Applications publiée le 26 juillet 2019 ou après cette date. Si vous ne disposez pas d’une instance Image Builder, vous devez en créer une. Pour plus d’informations, consultez [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md).
**Topics**
+ [Création des paramètres d’application et Windows par défaut avec les opérations d'interface de ligne de commande d’Image Assisant](create-default-app-windows-settings-image-assistant.md)
+ [Optimisation des performances de lancement de vos applications avec les opérations d’interface de ligne de commande d’Image Assistant](optimize-app-launch-performance-image-assistant-cli.md)
+ [Présentation du processus de création programmatique d'une image Amazon Applications WorkSpaces](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [Opérations de la CLI Image Assistant pour créer et gérer votre image d' WorkSpaces applications Amazon](cli-operations-managing-creating-image-image-assistant.md)
# Création des paramètres d’application et Windows par défaut avec les opérations d'interface de ligne de commande d’Image Assisant
Vous pouvez créer des paramètres d'application et Windows par défaut afin que vos utilisateurs puissent démarrer rapidement avec leurs applications. Lorsque vous créez ces paramètres, WorkSpaces Applications remplace le profil utilisateur par défaut de Windows par le profil que vous configurez. Le profil utilisateur Windows par défaut est ensuite utilisé pour créer les paramètres initiaux pour les utilisateurs dans l’instance de flotte. Si vous créez ces paramètres à l'aide des opérations d’interface de ligne de commande Image Assistant, votre programme d'installation de l'application, ou l'automatisation, doit modifier le profil d’utilisateur Windows par défaut directement.
Pour remplacer le profil d’utilisateur Windows par défaut par celui d’un autre utilisateur Windows, vous pouvez également utiliser l'opération d’interface de ligne de commande `update-default-profile` d’Image Assistant.
Pour plus d'informations sur la configuration des applications par défaut et des paramètres Windows, voir *Création de paramètres d'application et Windows par défaut pour les utilisateurs de vos WorkSpaces applications* dans[Paramètres par défaut des applications et de Windows et performances de lancement des applications dans Amazon WorkSpaces Applications](customizing-appstream-images.md).
# Optimisation des performances de lancement de vos applications avec les opérations d’interface de ligne de commande d’Image Assistant
WorkSpaces Les applications vous permettent d'optimiser les performances de lancement de vos applications pour les sessions de streaming de vos utilisateurs. Lorsque vous utilisez pour ce faire des opérations d’interface de ligne de commande d’Image Assistant, vous pouvez spécifier les fichiers à optimiser pour le lancement de votre application. L’ajout de fichiers au manifeste d’optimisation d’application réduit le temps nécessaire au lancement initial d’une application sur une nouvelle instance de flotte. Toutefois, cela augmente également le temps nécessaire pour que les instances de flotte soient mises à la disposition des utilisateurs. Le manifeste d'optimisation est un fichier texte délimité par des lignes spécifique à l’application.
**Note**
Si vous intégrez des manifestes d’optimisation d'application en utilisant à la fois des opérations d’interface de ligne de commande d’Image Assistant et l’interface utilisateur graphique d’Image Assistant, les manifestes sont fusionnés.
Voici un exemple de fichier manifeste d’optimisation des applications :
```
C:\Program Files (x86)\Notepad++\autoCompletion
C:\Program Files (x86)\Notepad++\localization
C:\Program Files (x86)\Notepad++\plugins
C:\Program Files (x86)\Notepad++\themes
C:\Program Files (x86)\Notepad++\updater
C:\Program Files (x86)\Notepad++\userDefineLangs
C:\Program Files (x86)\Notepad++\change.log
C:\Program Files (x86)\Notepad++\config.xml
C:\Program Files (x86)\Notepad++\contextMenu.xml
C:\Program Files (x86)\Notepad++\doLocalConf.xml
C:\Program Files (x86)\Notepad++\functionList.xml
C:\Program Files (x86)\Notepad++\langs.model.xml
C:\Program Files (x86)\Notepad++\license.txt
C:\Program Files (x86)\Notepad++\notepad++.exe
C:\Program Files (x86)\Notepad++\readme.txt
C:\Program Files (x86)\Notepad++\SciLexer.dll
C:\Program Files (x86)\Notepad++\shortcuts.xml
C:\Program Files (x86)\Notepad++\stylers.model.xml
```
Pour plus d'informations sur l'optimisation des performances de lancement de vos applications, consultez *Optimisation des performances de lancement de vos applications* dans [Paramètres par défaut des applications et de Windows et performances de lancement des applications dans Amazon WorkSpaces Applications](customizing-appstream-images.md).
# Présentation du processus de création programmatique d'une image Amazon Applications WorkSpaces
Vous pouvez utiliser les opérations de la CLI Image Assistant avec l'automatisation de l'installation de vos applications pour créer un flux de travail de création d'images d' WorkSpaces applications entièrement programmatique. Une fois votre demande d'automatisation d'installation terminée, mais avant la création de l'image, utilisez les opérations d'interface de ligne de commande d’Image Assistant pour spécifier les éléments suivants :
+ Les fichiers exécutables que vos utilisateurs peuvent lancer
+ Les manifestes d’optimisation pour vos applications
+ Métadonnées d'image WorkSpaces pour les autres applications
La présentation générale suivante décrit le processus de création par programmation d'une image d' WorkSpaces applications.
1. Utilisez l’automatisation d’installation de votre application pour installer les applications requises sur votre mage Builder. Cette installation peut inclure des applications que vos utilisateurs lanceront, des dépendances, et des applications en arrière-plan.
1. Déterminez les fichiers et les dossiers à optimiser.
1. Le cas échéant, utilisez l'opération Image Assistant `add-application` CLI pour spécifier les métadonnées de l'application et le manifeste d'optimisation pour l'image WorkSpaces Applications.
1. Pour spécifier des applications supplémentaires pour l'image WorkSpaces Applications, répétez les étapes 1 à 3 pour chaque application selon les besoins.
1. Le cas échéant, utilisez l'opération d’interface de ligne de commande `update-default-profile` d’Image Assistant pour remplacer le profil Windows par défaut et créer les paramètres d’application et Windows par défaut pour vos utilisateurs.
1. Utilisez l'opération d’interface de ligne de commande `create-image` d’Image Assistant pour créer l'image.
# Opérations de la CLI Image Assistant pour créer et gérer votre image d' WorkSpaces applications Amazon
Cette section décrit les opérations de la CLI Image Assistant que vous pouvez utiliser pour créer et gérer votre image d' WorkSpaces applications.
Sur les générateurs d'images Windows, le fichier exécutable qui inclut l'interface de ligne de commande se trouve à l'emplacement suivant : C:\$1Program Files \$1 Amazon \$1 Photon \$1 ConsoleImageBuilder \$1 Image-Assistant.exe. Pour plus de commodité, ce fichier exécutable est inclus dans la variable Windows PATH. Cela vous permet d'appeler les opérations d'interface de ligne de commande d’Image Assistant sans spécifier le chemin absolu vers le fichier exécutable. Pour appeler ces opérations, tapez la commande **image-assistant.exe**.
Sur les générateurs d'images Linux, l'outil d'assistant d'image se trouve à l'adresse/usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.
## Opération `help`
Extrait une liste de toutes les opérations d'interface de ligne de commande d’Image Assistant. Pour chaque opération de la liste, la description et la syntaxe d'utilisation sont fournies. Pour afficher l'aide relative à une opération spécifique, tapez le nom de l'opération et spécifiez le paramètre **-help**. Par exemple :
```
add-application --help
```
**Résumé**
```
help
```
**Sortie**
Imprime sur la sortie standard la liste des opérations disponibles avec une description de leur fonction.
## Opération `add-application`
Ajoute l'application à la liste des WorkSpaces applications pour les utilisateurs des applications. Les applications de cette liste sont incluses dans le catalogue d'applications. Le catalogue d'applications s'affiche pour les utilisateurs lorsqu'ils se connectent à une session de streaming d' WorkSpaces applications.
**Note**
Si vous devez apporter des modifications à la configuration d’une application, supprimez-la, puis ajoutez-la avec les paramètres mis à jour.
**Résumé**
```
add-application
--name
--absolute-app-path
[--display-name ]
[--absolute-icon-path ]
[--working-directory ]
[--launch-parameters <""-escaped value>]
[--absolute-manifest-path ]
```
**Options**
**`--name` (chaîne)**
Nom unique de l'application. La longueur maximale est de 256 caractères. Vous pouvez ajouter jusqu'à 50 applications. Vous ne pouvez pas utiliser d’espace.
**`--absolute-app-path` (chaîne)**
Chemin absolu vers le fichier exécutable, le fichier de commandes ou le script pour l'application. Le chemin doit pointer vers un fichier valide.
**`--display-name` (chaîne)**
Nom à afficher pour l'application dans le catalogue d'applications. Si vous ne spécifiez pas de nom d'affichage, WorkSpaces Applications crée un nom dérivé du nom du fichier exécutable. Le nom est créé sans l'extension de fichier et avec des traits de soulignement à la place des espaces. La longueur maximale est de 256 caractères.
**`--absolute-icon-path` (chaîne)**
Chemin absolu vers l'icône de l'application. Le chemin doit pointer vers un fichier d'icône valide de type .jpg, .png ou .bmp. Les dimensions maximales sont : 256 px x 256 px. Si vous ne spécifiez pas de chemin d'accès, l'icône par défaut pour le fichier exécutable est utilisée, si elle est disponible. Si aucune icône par défaut n'est disponible pour le fichier exécutable, une icône d'application WorkSpaces Applications par défaut est utilisée.
**`--working-directory` (chaîne)**
Répertoire de travail initial pour l'application lorsque celle-ci est lancée.
**`--absolute-manifest-path` (chaîne)**
Chemin d'accès à un nouveau fichier texte séparé par des lignes. Le fichier spécifie le chemin absolu des fichiers à optimiser avant que l'instance de flotte soit disponible à un utilisateur pour le streaming. Le chemin doit pointer vers un fichier texte valide.
**Sortie de message**
| Code de sortie | Message imprimé sur la sortie standard | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | L'application a été ajoutée avec succès. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | \$1"status": 1, "message": "Unable to add more than 50 apps to the catalog."\$1 | L'application n'a pas pu être ajoutée car le nombre maximum d'applications pouvant être ajoutées au catalogue d' WorkSpaces applications est de 50. |
| 1 | \$1"status": 1, "message": "Name is not unique"\$1 | Une application portant ce nom existe déjà dans le catalogue d' WorkSpaces applications Applications. |
| 1 | \$1"status » : 1, « message » : « Fichier introuvable (absolute-app-path)"\$1 | Le fichier spécifié pour absolute-app-path est introuvable. |
| 1 | \$1"status": 1, "message": "Unsupported file extension"\$1 | Le paramètre Absolute-app-path prend uniquement en charge les types de fichiers suivants : .exe et .bat. |
| 1 | \$1"status": 1, "message": "Directory not found (répertoire\$1travail)" | Le répertoire spécifié pour working-directory est introuvable. |
| 1 | \$1"status": 1, "message": "Optimization-manifest not found: "\$1 | Le fichier spécifié pour optimization-manifest est introuvable. |
| 1 | \$1"status": 1, "message": "File not found: "\$1 | Un fichier spécifié dans le manifeste d'optimisation est introuvable. |
| 255 | \$1"status": 255, "message": \$1 | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le [Centre AWS Support](https://console.aws.amazon.com/support/home#/). |
## Opération `remove-application`
Supprime une application de la liste des applications pour l'image WorkSpaces Applications. L'application n'est ni désinstallée ni modifiée, mais les utilisateurs ne pourront pas la lancer depuis le catalogue d' WorkSpaces applications Applications.
**Résumé**
```
remove-application
--name
```
**Options**
**`--name` (chaîne)**
Identifiant unique de l'application à supprimer.
**Sortie de message**
| Code de sortie | Message imprimé sur la sortie standard | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | L'application a été supprimée avec succès. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | \$1"status": 1, "message": "App not found"\$1 | L'application spécifiée est introuvable dans le catalogue d' WorkSpaces applications Applications. |
| 255 | \$1"status": 255, "message": \$1 | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le [Centre AWS Support](https://console.aws.amazon.com/support/home#/). |
## Opération `list-applications`
Répertorie toutes les applications spécifiées dans le catalogue d'applications.
**Résumé**
```
list-applications
```
**Sortie de message**
| Code de sortie | Message imprimé sur la sortie standard | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success", "applications": [ \$1..app1.. \$1, \$1 ..app2.. \$1]\$1 | Liste des applications du catalogue WorkSpaces d'applications Applications. |
| 255 | \$1"status": 255, "message": \$1 | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le [Centre AWS Support](https://console.aws.amazon.com/support/home#/). |
## Opération `update-default-profile`
Copie le profil de l’utilisateur Windows spécifié dans le profil d’utilisateur Windows par défaut. Les nouveaux utilisateurs qui diffusent héritent des paramètres stockés dans le profil spécifié.
**Note**
Cette opération n’est pas prise en charge par l’outil de CLI Image Assistant Linux.
**Résumé**
```
update-default-profile
[--profile ]
```
**Options**
**`--profile` (chaîne)**
Nom de l'utilisateur dont le profil Windows Windows sera copié dans le profil utilisateur Windows par défaut. Utilisez le format suivant pour le nom :
"\$1"
Si votre instance Image Builder n’est pas jointe à un domaine Microsoft Active Directory, entrez un point « . » pour le domaine. Si vous ne spécifiez aucun utilisateur, le compte utilisateur du modèle d' WorkSpaces applications est utilisé.
**Sortie de message**
| Code de sortie | Message imprimé sur la sortie standard | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | Les paramètres utilisateur ont été copiés dans le profil Windows par défaut. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | \$1"status": 1, "message": "Unable to copy file or folder: . "\$1 | Les paramètres utilisateur n'ont pas pu être copiés, car un fichier ou un dossier était indisponible. |
| 1 | \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1 | Un utilisateur du domaine Microsoft Active Directory a été spécifié, mais l’instance Image Builder n’est jointe à aucun domaine Active Directory. |
| 255 | \$1"status": 255, "message": \$1 | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le [Centre AWS Support](https://console.aws.amazon.com/support/home#/). |
## Opération `reset-user-profile`
Supprime le profil utilisateur Windows pour l'utilisateur spécifié.
**Note**
Cette opération n’est pas prise en charge par l’outil de CLI Image Assistant Linux.
**Résumé**
```
reset-user-profile
[--profile ]
```
**Options**
**`--profile` (chaîne)**
Nom de l'utilisateur Windows dont le profil Windows sera supprimé. Utilisez le format suivant pour le nom :
"\$1"
Si votre instance Image Builder n’est pas jointe à un domaine Microsoft Active Directory, entrez un point « . » pour le domaine.
**Sortie de message**
| Code de sortie | Message imprimé sur la sortie standard | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | Les paramètres de l'utilisateur spécifié ont été supprimés avec succès. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | \$1"status": 1, "message": "Unable to copy file or folder: . "\$1 | Les paramètres de l'utilisateur n'a pas pu être réinitialisés, car un fichier ou un dossier était indisponible. |
| 1 | \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1 | Un utilisateur du domaine Microsoft Active Directory a été spécifié, mais l’instance Image Builder n’est jointe à aucun domaine Active Directory. |
| 255 | \$1"status": 255, "message": \$1 | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le [Centre AWS Support](https://console.aws.amazon.com/support/home#/). |
## Opération `create-image`
Lance le flux de travail de création d'image, qui produit une image d' WorkSpaces applications qui peut être utilisée pour les flottes WorkSpaces d'applications.
**Résumé**
```
create-image
--name
[--description ]
[--display-name ]
[--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog]
[--use-latest-agent-version] | [--no-use-latest-agent-version]
[--tags ]
[--dry-run]
```
**Options**
**`--name` (chaîne)**
Nom de l'image WorkSpaces Applications. Le nom doit être unique au sein du compte et de la AWS région Amazon Web Services. La longueur maximale est de 100 caractères. Les caractères autorisés sont les suivants :
a-z, A-Z, 0-9, traits de soulignement (\$1), tirets (-) et points (.)
Le nom d'image ne peut pas commencer par un des préfixes suivants : « aws », « appstream » et « amazon ». Ces préfixes sont réservés pour une utilisation AWS .
**`--description` (chaîne)**
Description à afficher pour l'image. La longueur maximale est de 256 caractères.
**`--display-name` (chaîne)**
Nom à afficher pour l'image. La longueur maximale est de 256 caractères.
**`--enable-dynamic-app-catalog` \$1 `--no-enable-dynamic-app-catalog`**
Active ou désactive la prise en charge de l'infrastructure WorkSpaces d'applications dynamiques des applications. Si vous ne spécifiez aucun paramètre, la prise en charge du cadre d’application dynamique n'est pas activée.
L'infrastructure d'applications dynamiques fournit des opérations au sein d'une instance de streaming d' WorkSpaces applications que vous pouvez utiliser pour créer un fournisseur d'applications dynamiques. Les fournisseurs d'application dynamique peuvent utiliser ces opérations pour modifier le catalogue d'applications auquel vos utilisateurs peuvent accéder en temps réel. Pour de plus amples informations, veuillez consulter [Utiliser le framework d' WorkSpaces applications dynamiques pour créer un fournisseur d'applications dynamiques](build-dynamic-app-provider.md).
**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**
Spécifie s'il faut épingler l'image à la version de l'agent WorkSpaces Applications actuellement installée ou s'il faut toujours utiliser la dernière version de l'agent. Si vous ne spécifiez aucun paramètre, l'image est épinglée à la version de l'agent WorkSpaces Applications actuellement installée. Pour de plus amples informations, veuillez consulter [Gérer les versions WorkSpaces des agents d'applications](base-images-agent.md).
**`--tags` (chaîne)**
Balises à associer à l'image. Une balise est une paire clé-valeur. Utilisez le format suivant :
--tags "mykey" "myval" "mykey2" "myval2"
Pour en savoir plus sur les identifications, consultez [Marquer les ressources de vos WorkSpaces applications Amazon](tagging-basic.md).
**`--dry-run` (chaîne)**
Effectue une validation sans créer l'image. Utilisez cette commande pour vérifier si votre image contient des problèmes avant de la créer.
**Sortie de message**
| Code de sortie | Message imprimé sur la sortie standard | Description |
| --- | --- | --- |
| 0 | \$1"status": 0, "message": "Success"\$1 | Le flux de travail utilisé pour créer l'image a été lancé avec succès. |
| 1 | \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1 | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | \$1"status": 1, "message": "An image with the given name already exists"\$1 | Une image du même nom existe déjà dans le compte Amazon Web Services. |
| 1 | \$1"status": 1, "message": "Invalid value (balises)"\$1 | Les balises spécifiées ne sont pas valides. |
| 255 | \$1"status": 255, "message": \$1 | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le [Centre AWS Support](https://console.aws.amazon.com/support/home#/). |
# Création d’images basées sur Linux
Vous pouvez créer des images WorkSpaces Amazon Applications basées sur Linux en vous connectant à un générateur d'images Linux, en installant les applications dont vous avez besoin, en créant des paramètres d'application par défaut et des variables d'environnement, et en utilisant un outil d'interface de ligne de commande (CLI) ou un outil d'assistant d'image (GUI) pour ajouter ces applications au catalogue d'applications. Pour ouvrir l’outil graphique, recherchez **Image Assistant** dans la liste des applications.
**Topics**
+ [Création de paramètres d’application par défaut pour vos utilisateurs](create-default-app-settings.md)
+ [Création de variables d’environnement par défaut pour vos utilisateurs Linux](create-default-variables-linux.md)
+ [Optimisation des performances de lancement de vos applications Linux](optimize-launch-performance.md)
+ [Création de scripts de session](create-session-scripts.md)
+ [Utilisation de l’outil d’interface de ligne de commande Image Assistant pour Linux](image-assistant-cli.md)
+ [Activation et désactivation de la prise en charge de la webcam](webcam-support.md)
+ [Activation et désactivation du mode de synchronisation des fichiers lourds pour les dossiers personnels](heavy-file-sync.md)
+ [Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée](tutorial-create-linux-image.md)
+ [Didacticiel : Activation de la prise en charge du japonais pour vos images Linux](enable-japanese-support-linux.md)
# Création de paramètres d’application par défaut pour vos utilisateurs
Suivez ces étapes pour créer les paramètres d'application par défaut pour vos utilisateurs.
**Topics**
+ [Étape 1 : installer les applications Linux sur l’instance Image Builder](#app-settings-image-install)
+ [Étape 2 : créer un TemplateUser compte](#app-settings-template-user)
+ [Étape 3 : créer les paramètres d’application par défaut](#app-settings-image-create-default-app-settings)
+ [Étape 4 : enregistrer les paramètres d’application par défaut](#app-settings-image-save-default-app-settings)
+ [Étape 5 : tester les paramètres d’application par défaut (facultatif)](#app-settings-image-test-applications)
+ [Étape 6 : nettoyer](#app-settings-image-finish)
## Étape 1 : installer les applications Linux sur l’instance Image Builder
Au cours de cette étape, vous allez vous connecter à une instance Image Builder Linux et y installer les applications.
**Pour installer des applications sur l’instance Image Builder**
1. Connectez-vous à l’instance Image Builder en effectuant l’une des actions suivantes :
+ [Utiliser la console WorkSpaces Applications](managing-image-builders-connect-console.md) (pour les connexions Web uniquement)
+ [Création d'une URL de streaming](managing-image-builders-connect-streaming-URL.md) (pour les connexions client Web ou WorkSpaces applicatives)
**Note**
Vous serez connecté en tant qu' ImageBuilderAdmin utilisateur au bureau Amazon Linux GNOME et aurez les privilèges d'administrateur root.
1. Installez les applications nécessaires. Par exemple, pour installer un navigateur Chromium à partir d’un référentiel yum public, ouvrez d’abord l’application Terminal, puis exécutez la commande suivante :
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
## Étape 2 : créer un TemplateUser compte
Au cours de cette étape, vous créez un TemplateUser compte qui crée les paramètres d'application par défaut pour vos utilisateurs de streaming.
**Pour créer un TemplateUser compte**
1. Créez un TemplateUser compte qui ne possède aucune autorisation root. Par exemple, dans une fenêtre de terminal, exécutez les commandes suivantes pour créer dans TemplateUser le générateur d'images :
**[ImageBuilderAdmin]\$1 sudo useradd -m TemplateUser**
**[ImageBuilderAdmin]\$1 echo -e '<*password*>\$1n<*password*>\$1n' \$1 sudo passwd TemplateUser**
1. Passez au TemplateUser compte :
**[ImageBuilderAdmin]\$1 su - TemplateUser**
## Étape 3 : créer les paramètres d’application par défaut
Au cours de cette étape, vous créez les paramètres d'application par défaut pour les utilisateurs de vos WorkSpaces applications. Cela permet à vos utilisateurs de démarrer rapidement avec les applications pendant leurs sessions de streaming d' WorkSpaces applications, sans avoir à créer ou à configurer eux-mêmes ces paramètres.
**Pour créer les paramètres d’application par défaut pour vos utilisateurs**
1. Lancez l’application pour laquelle vous souhaitez créer les paramètres par défaut. Par exemple, dans une fenêtre Terminal, exécutez la commande suivante pour lancer le navigateur Chromium :
**[TemplateUser]\$1 chromium-browser**
1. Configurez les paramètres de l’application. Par exemple, définissez **https://aws.amazon.com** comme page d’accueil du navigateur Chromium.
1. Fermez les applications.
1. Déconnectez-vous :
**[TemplateUser]\$1 logout**
## Étape 4 : enregistrer les paramètres d’application par défaut
Au cours de cette étape, vous copiez les paramètres d’application par défaut que vous avez ajoutés dans le répertoire **/etc/skel/** et vous les mettez à la disposition de vos utilisateurs de streaming.
**Pour enregistrer les paramètres d’application par défaut**
+ Exécutez la commande suivante dans une fenêtre Terminal pour copier les paramètres d’application par défaut pour vos utilisateurs de streaming :
**[ImageBuilderAdmin]\$1 sudo cp -r -f /home/TemplateUser/. /etc/skel**
## Étape 5 : tester les paramètres d’application par défaut (facultatif)
Au cours de cette étape, vérifiez que les applications que vous avez ajoutées s’exécutent correctement et que les paramètres d’application par défaut fonctionnent comme prévu.
**Pour tester vos applications et vos paramètres par défaut sur une instance Image Builder**
1. Créez un utilisateur test qui ne dispose d’aucune autorisation root. Par exemple, dans une fenêtre **Terminal**, exécutez les commandes suivantes pour créer **test-user** sur l’instance Image Builder :
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e '*password*>\$1n<*password*>\$1n' \$1 sudo passwd test-user**
1. Basculez vers l’utilisateur test :
**[ImageBuilderAdmin]\$1 su - test-user**
1. Lancez l’application (par exemple, Chromium) en tant qu’utilisateur test :
**[test-user]\$1 /usr/bin/chromium-browser**
1. Vérifiez que les paramètres par défaut sont disponibles pour l'utilisateur de test (par exemple, la page d'accueil de Chromium est https://aws.amazon.com/).
1. Déconnectez-vous :
**[test-user]\$1 logout**
## Étape 6 : nettoyer
Enfin, la dernière étape consiste à effectuer le nettoyage.
**Pour nettoyer**
1. Supprimer TemplateUser :
**[ImageBuilderAdmin]\$1 sudo killall -u TemplateUser**
**[ImageBuilderAdmin]\$1 sudo userdel -r TemplateUser**
1. Supprimer l'utilisateur de test (non obligatoire si vous avez ignoré l'étape 5) :
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**ImageBuilderAdmin]\$1 sudo userdel -r test-user**
# Création de variables d’environnement par défaut pour vos utilisateurs Linux
Vous pouvez créer des variables d’environnement sur une instance Image Builder Linux. La création de variables d’environnement les rend disponibles sur les instances de streaming créées à partir de cette image.
**Note**
Sur les instances de flotte Linux, les variables d'environnement définies à l'aide de l'outil Image Assistant (GUI) et les variables d'environnement système par défaut sont exportées via le script/etc/profile.d/appstream\$1system\$1vars.sh script. To access these environment variables, you must explicitly source the /etc/profile.d/appstream\$1system\$1vars.sh dans vos applications.
**Pour créer des variables d’environnement pour vos utilisateurs**
1. Si le dossier `/etc/profile` n’existe pas, exécutez la commande suivante pour le créer :
**[ImageBuilderAdmin]\$1 sudo mkdir -p /etc/profile.d**
1. Pour créer un nouveau fichier de script shell (par exemple, my-environment.sh) dans ce dossier, exécutez la commande suivante :
**[ImageBuilderAdmin]\$1 vim my-environment.sh**
1. Sur la première ligne du fichier de script, ajoutez le contenu suivant :
**\$1\$1/bin/sh **
1. Pour chaque ligne suivante, ajoutez une commande **export** pour définir les variables d’environnement de votre image. L’exemple suivant ajoute `$HOME/bin` à la variable `PATH` :
**export PATH=”\$1HOME/bin:\$1PATH”**
1. Appuyez sur la touche **Echap** pour revenir en mode commande dans vim, puis exécutez la commande suivante pour enregistrer votre script et quitter vim :
**:x**
1. Exécutez la commande suivante pour permettre au script de s’exécuter en tant que programme :
**[ImageBuilderAdmin]\$1 chmod \$1x my-environment.sh**
# Optimisation des performances de lancement de vos applications Linux
Si vous utilisez l’outil graphique Image Assistant, celui-ci optimise automatiquement les performances de lancement de vos applications.
Si vous utilisez l’interface de ligne de commande Image Assistant, suivez les étapes ci-dessous pour optimiser les performances de lancement manuellement. Lorsque vous créez et ajoutez des fichiers au manifeste d’optimisation d’une application, celle-ci se lance plus rapidement lorsqu’elle est démarrée pour la première fois sur une nouvelle instance de flotte. Toutefois, cela augmente également le temps nécessaire pour que les instances de flotte soient mises à la disposition des utilisateurs. Le manifeste d’optimisation est un fichier texte délimité par des lignes pour chaque application.
Vous pouvez créer un fichier manifeste (tel que < *your-app* >-manifest.txt) manuellement ou en suivant les étapes ci-dessous.
**Pour créer un fichier manifeste**
1. Assurez-vous que l’application que vous essayez d’optimiser est lancée et en cours d’exécution.
1. À partir d’un terminal dans l’instance Image Builder Linux, exécutez la commande suivante :
**ps -ef \$1 grep <*application-process-name*>**
1. Recherchez le plus petit numéro PID dans la sortie de la dernière étape. Il s’agit du PID du processus parent racine de l’application.
1. Maintenez l’application en cours d’exécution et veillez à utiliser les composants initiaux requis par vos utilisateurs. Vous garantissez ainsi que ces composants sont capturés par le processus d’optimisation.
1. Créez un fichier script (par exemple, `~/getfilestool.sh`) avec le contenu suivant :
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Assurez-vous que ce fichier peut être exécuté avec la commande suivante :
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Exécutez la commande suivante pour capturer tous les fichiers en cours d’exécution à partir du processus parent racine trouvé à l’étape 3, et enregistrez-les dans un fichier manifeste temporaire.
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh <*root-parent-pid*> > /tmp/-manifest.txt **
1. Vérifiez le contenu du manifeste d’optimisation, qui est un fichier texte délimité par des lignes pour chaque application.
Vous pouvez spécifier le manifeste d’optimisation indépendamment pour chaque application en utilisant l’outil d’interface de ligne de commande (CLI) Image Assistant. Pour plus d’informations, consultez [Utilisation de l’outil d’interface de ligne de commande Image Assistant pour Linux](image-assistant-cli.md).
# Création de scripts de session
WorkSpaces Les applications fournissent des scripts de session sur instance sur les instances de streaming basées sur Windows et Linux. Pour plus d’informations sur les scripts de session, consultez [Utilisez des scripts de session pour gérer l'expérience de streaming de vos utilisateurs d'Amazon WorkSpaces Applications](use-session-scripts.md).
Les scripts de session sont spécifiés dans une image d' WorkSpaces applications. Pour localiser le fichier de configuration des scripts de session sur une instance Linux, accédez à `/opt/appstream/SessionScripts/config.json`. Le code suivant est un exemple de fichier `config.json` qui spécifie un script de démarrage de session nommé « `test-session-start` » et un script de fin de session nommé « `test-session-stop` », ainsi que leurs paramètres d’exécution. Assurez-vous que les scripts référencés dans `config.json` disposent des autorisations d’exécution et qu’un interpréteur de commandes est défini (par exemple, \$1\$1/bin/bash).
```
{
"SessionStart": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-start",
"Arguments": "arg1",
"S3LogEnabled": true
}
],
"WaitingTime": 30
},
"SessionTermination": {
"Executables": [
{
"Context": "system",
"Filename": "/opt/appstream/SessionScripts/test-session-stop",
"Arguments": "arg2",
"S3LogEnabled": true
}
],
"WaitingTime": 30
}
}
```
# Utilisation de l’outil d’interface de ligne de commande Image Assistant pour Linux
Sur un générateur d'images basé sur Linux, vous pouvez utiliser l'outil Image Assistant CLI **AppStreamImageAssistant**pour créer et gérer l'image de vos WorkSpaces applications. L’outil se trouve sous `/usr/local/appstream/image-assistant/AppStreamImageAssistant` avec un lien symbolique à l’adresse `/bin/AppStreamImageAssistant`. Cet outil de CLI pour Linux prend en charge bon nombre des mêmes opérations que l’outil d’interface de ligne de commande Image Assistant pour Windows. Pour plus d’informations sur ces opérations, consultez [Opérations de la CLI Image Assistant pour créer et gérer votre image d' WorkSpaces applications Amazon](cli-operations-managing-creating-image-image-assistant.md).
# Activation et désactivation de la prise en charge de la webcam
WorkSpaces Les applications prennent en charge l'audio-vidéo (AV) en temps réel en redirigeant l'entrée vidéo de la webcam locale vers les sessions de streaming WorkSpaces des applications. Cette fonctionnalité permet à vos utilisateurs d'utiliser leur webcam locale pour des conférences vidéo et audio dans le cadre d'une session de streaming d' WorkSpaces applications. Grâce à l'audiovisuel en temps réel et à la prise en charge du son en temps réel, vos utilisateurs peuvent collaborer en utilisant des applications de visioconférence et d'audioconférence familières sans avoir à quitter leur session de streaming d' WorkSpaces applications.
Pour utiliser cette fonctionnalité, vous devez utiliser une image d' WorkSpaces applications Linux qui utilise un agent d' WorkSpaces applications Linux publié le 21 septembre 2022 ou après cette date.
**Note**
L'audiovisuel en temps réel n'est pas pris en charge pour les instances stream.standard.small alimentées par Rocky Linux ou Red Hat Enterprise Linux. Les utilisateurs ne voient pas les icônes de caméra et de micro dans la barre d'outils du client.
La fonctionnalité AV en temps réel est activée par défaut pour les sessions de streaming Linux. Pour configurer les autorisations de webcam pour vos utilisateurs sur une instance Image Builder Linux, créez `/etc/appstream/appstream.conf` et ajoutez le contenu suivant :
**Note**
Spécifiez **1** pour activer la webcam ou **0** pour la désactiver.
```
[webcam]
permission = 1
```
# Activation et désactivation du mode de synchronisation des fichiers lourds pour les dossiers personnels
Vous pouvez activer les options des dossiers d' Amazon Simple Storage Service accueil pour votre organisation. Lorsque vous activez les dossiers de base Amazon S3 pour une pile d' WorkSpaces applications, les utilisateurs de la pile peuvent accéder à un dossier de stockage persistant pendant leurs sessions de streaming d'applications. Aucune configuration supplémentaire n'est requise de la part des utilisateurs pour que ceux-ci puissent accéder à leur dossier de base. Les données stockées par les utilisateurs dans leur dossier de base sont automatiquement sauvegardées dans un compartiment Amazon S3 de votre Compte AWS répertoire et sont mises à la disposition de ces utilisateurs lors des sessions suivantes. Pour de plus amples informations, veuillez consulter [Activez et gérez les dossiers personnels pour les utilisateurs de vos WorkSpaces applications](home-folders.md).
Pour garantir une expérience fluide et remédier à certaines limitations existantes, lorsqu'une synchronisation de fichiers incohérente peut être observée lorsque les utilisateurs enregistrent des fichiers texte volumineux depuis leurs instances de streaming dans leurs dossiers personnels, les administrateurs d' WorkSpaces applications peuvent activer l'option de configuration **heavy\$1sync** si le téléchargement de fichiers volumineux vers Amazon S3 est un scénario utilisateur courant lors de l'utilisation d'applications. WorkSpaces L'activation de cette option peut ajouter de la latence au processus de synchronisation des fichiers du dossier de base, mais l'exhaustivité de toutes les synchronisations avec Amazon S3 est garantie.
Cette fonctionnalité est disponible sur toutes les images Red Hat Enterprise Linux et les images d' WorkSpaces applications Linux qui utilisent un agent d' WorkSpaces applications Linux publié le 12 septembre 2024 ou après cette date.
La fonctionnalité de synchronisation intensive est désactivée par défaut pour les sessions de streaming Red Hat Enterprise Linux et Amazon Linux. Pour configurer des autorisations de synchronisation étendues pour vos utilisateurs sur un générateur d'images Red Hat Enterprise Linux ou Amazon Linux, créez `/etc/appstream/appstream.conf` et ajoutez le contenu suivant :
**Note**
Spécifiez **1** si vous souhaitez activer la synchronisation intensive ou **0** désactiver la synchronisation intensive.
```
[storage]
heavy_sync = 1
```
# Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée
Ce didacticiel explique comment créer une image WorkSpaces Amazon Applications personnalisée basée sur Linux contenant des applications que vous pouvez diffuser à vos utilisateurs.
**Important**
Ne créez pas d'utilisateur nommé « as2-streaming-user » dans votre générateur d'images. Il s'agit d'un nom d'utilisateur réservé à Fleet. Si vous créez ce nom d'utilisateur en dehors du flux de travail WorkSpaces des applications, vous risquez de rencontrer des problèmes de streaming dans les flottes.
**Topics**
+ [Étape 1 : installer les applications Linux sur l’instance Image Builder](#tutorial-linux-image-install)
+ [Étape 2 : générer un fichier manifeste d’optimisation des applications](#tutorial-linux-image-manifest)
+ [Étape 3 : Création d'un catalogue d' WorkSpaces applications](#tutorial-linux-image-catalog)
+ [Étape 4 : créer les paramètres d’application et les variables d’environnement par défaut](#tutorial-linux-image-create-default-app-settings)
+ [Étape 5 : tester les applications et les paramètres](#tutorial-linux-image-test-applications)
+ [Étape 6 : terminer la création de l’image](#tutorial-linux-image-finish-create-image)
+ [Étape 7 (facultative) : baliser et copier une image](#tutorial-linux-image-tag-copy)
+ [Étape 8 : nettoyer](#tutorial-linux-image-finish)
## Étape 1 : installer les applications Linux sur l’instance Image Builder
Au cours de cette étape, vous allez vous connecter à une instance Image Builder Linux et y installer les applications.
**Pour installer des applications sur l’instance Image Builder**
1. Connectez-vous à l’instance Image Builder en effectuant l’une des actions suivantes :
+ [Utiliser la console WorkSpaces Applications](managing-image-builders-connect-console.md) (pour les connexions Web uniquement)
+ [Création d'une URL de streaming](managing-image-builders-connect-streaming-URL.md) (pour les connexions client Web ou WorkSpaces applicatives)
**Note**
Vous serez connecté en tant qu' ImageBuilderAdmin utilisateur au bureau Amazon Linux GNOME et aurez les privilèges d'administrateur root.
1. Installez les applications nécessaires. Par exemple, pour installer un navigateur Chromium à partir d’un référentiel yum public, ouvrez d’abord l’application Terminal, puis exécutez la commande suivante :
**[ImageBuilderAdmin]\$1 sudo yum update && sudo yum install chromium.x86\$164**
**Note**
Téléchargez et installez uniquement les applications de sites dans lesquels vous avez confiance.
## Étape 2 : générer un fichier manifeste d’optimisation des applications
Au cours de cette étape, vous allez générer le fichier manifeste de chaque application installée à l’étape 1.
**Pour générer un fichier manifeste destiné à optimiser les performances de lancement d’une application**
1. Assurez-vous que l’application (Chromium, par exemple) à optimiser est lancée et en cours d’exécution.
1. Dans une fenêtre de l’application Terminal, exécutez la commande suivante pour afficher les processus liés à l’application :
**[ImageBuilderAdmin]\$1 ps -ef \$1 grep chromium **
1. Recherchez le PID du parent racine dans la sortie de la commande ci-dessus. Dans l’exemple de sortie suivant, le PID du parent racine est 16712 :
**Example**
```
[ImageBuilderAdmin]$ ps -ef | grep chromium
ImageBu+ 16712 4128 0 Aug26 ? 00:00:44 /usr/lib64/chromium- browser/chromium-browser --enable-plugins --enable-extensions -- enable-user- scripts --enable-printing --enable-gpu-rasterization -- enable-sync --auto-ssl- client-auth
ImageBu+ 16726 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygote --no-zygote-sandbox ImageBu+ 16727 16712 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium- browser --type=zygote
ImageBu+ 16731 16727 0 Aug26 ? 00:00:00 /usr/lib64/chromium- browser/chromium-browser --type=zygot
```
1. Maintenez l’application en cours d’exécution et veillez à utiliser les composants initiaux requis par vos utilisateurs. Vous garantissez ainsi que ces composants sont capturés par le processus d’optimisation.
1. Créez un fichier de script (`~/getfilestool.sh`, par exemple) avec le contenu suivant :
```
#!/bin/bash
## usage getfilestool.sh $pid
lsof -p $(pstree -p $1 | grep -o '([0-9]\+)' | grep -o '[0-9]\+' | tr '\012' ,)|grep REG | sed -n '1!p' | awk '{print $9}'|awk 'NF'
```
1. Exécutez la commande suivante pour vérifier que le fichier peut être exécuté :
**[ImageBuilderAdmin]\$1 chmod u\$1x \$1/getfilestool.sh**
1. Exécutez la commande suivante pour capturer tous les fichiers en cours d’exécution à partir du processus parent racine trouvé à l’étape 3 ci-dessus. Ensuite, enregistrez-les dans un fichier manifeste temporaire :
**[ImageBuilderAdmin]\$1 sudo \$1/getfilestool.sh 16712 > /tmp/chromium-manifest.txt **
1. Vérifiez le contenu du manifeste d’optimisation (fichier texte délimité par des lignes pour chaque application).
## Étape 3 : Création d'un catalogue d' WorkSpaces applications
Au cours de cette étape, vous utilisez l'outil `AppStreamImageAssistant` CLI du générateur d'images pour créer un catalogue d' WorkSpaces applications en spécifiant des applications pour votre image. Pour chaque application que vous prévoyez de diffuser, spécifiez le nom, le nom d’affichage, le fichier exécutable à lancer et l’icône à afficher.
**Pour créer un catalogue d' WorkSpaces applications**
1. Depuis le bureau de l’instance Image Builder, ouvrez l’application **Terminal** à partir du volet latéral ou affichez la grille des applications.
1. Exécutez **AppStreamImageAssistant --help** pour afficher la liste des commandes disponibles. Vous allez utiliser ces commandes pour ajouter des applications et créer une image.
1. Exécutez la commande suivante pour ajouter une application installée (par exemple, Chromium) à la liste des WorkSpaces applications pour les utilisateurs d'applications :
```
AppStreamImageAssistant add-application \
--name Chromium \
--absolute-app-path /usr/lib64/chromium-browser/chromium-browser \
--display-name Chromium \
--absolute-icon-path /usr/share/icons/hicolor/256x256/apps/chromium-browser.png \
--absolute-manifest-path /tmp/chromium-manifest.txt
```
Vous pouvez également exécuter la commande suivante :
```
AppStreamImageAssistant add-application \
--name="Chromium" \
--absolute-app-path="/usr/lib64/chromium-browser/chromium-browser" \
--display-name="Chromium" \
--absolute-icon-path="/usr/share/icons/hicolor/256x256/apps/chromium-browser.png" \
--absolute-manifest-path="/tmp/chromium-manifest.txt"
```
1. Pour ajouter d’autres applications, répétez l’étape 3 pour chacune d’elles.
1. Pour afficher la liste des applications ajoutées au catalogue, ainsi que les métadonnées telles que les chemins d’icônes et les paramètres de lancement, exécutez la commande suivante :
**AppStreamImageAssistant list-applications**
1. Pour supprimer une application du catalogue, exécutez la commande suivante :
**AppStreamImageAssistant remove-application –-name *application\$1name***
## Étape 4 : créer les paramètres d’application et les variables d’environnement par défaut
Au cours de cette étape, vous créez les paramètres d'application par défaut et les variables d'environnement pour les utilisateurs de vos WorkSpaces applications. Cela permet à vos utilisateurs de démarrer rapidement avec les applications pendant leurs sessions de streaming d' WorkSpaces applications, sans avoir à créer ou à configurer eux-mêmes ces paramètres.
**Pour créer les paramètres d’application et les variables d’environnement par défaut des utilisateurs**
1. Lancez l’application pour laquelle vous souhaitez créer les paramètres par défaut. Par exemple, dans une fenêtre Terminal, exécutez la commande suivante pour lancer le navigateur Chromium :
**[ImageBuilderAdmin]\$1 chromium-browser**
1. Configurez les paramètres de l’application. Par exemple, définissez **https://aws.amazon.com** comme page d’accueil du navigateur Chromium.
1. Assurez-vous que l'application Chromium est fermée, puis exécutez les commandes suivantes pour copier la configuration de Chromium dans **/etc/skel** :
**[ImageBuilderAdmin]\$1 sudo mkdir /etc/skel/.config**
**[ImageBuilderAdmin]\$1 sudo cp -R \$1/.config/chromium /etc/skel/.config**
1. Définissez les variables d’environnement et ajoutez-les au fichier de script. Par exemple, exécutez les commandes suivantes :
**[ImageBuilderAdmin]\$1 echo "export *FOO*=*BAR*" \$1 sudo tee -a /etc/profile.d/myenvvars.sh**
**[ImageBuilderAdmin]\$1 sudo chmod \$1x /etc/profile.d/myenvvars.sh**
## Étape 5 : tester les applications et les paramètres
Au cours de cette étape, vérifiez que les applications ajoutées s’exécutent correctement et que les paramètres d’application et les variables d’environnement par défaut fonctionnent comme prévu.
**Pour tester vos applications et vos paramètres par défaut sur une instance Image Builder**
1. Créez un utilisateur test qui ne dispose d’aucune autorisation root. Par exemple, dans une fenêtre **Terminal**, exécutez les commandes suivantes pour créer **test-user** sur l’instance Image Builder :
**[ImageBuilderAdmin]\$1 sudo useradd -m test-user**
**[ImageBuilderAdmin]\$1 echo -e 'Pa55w0rdas2\$1\$1\$1\$1nPa55w0rdas2\$1\$1\$1\$1n' \$1 sudo passwd test-user**
1. Basculez vers l’utilisateur test :
**[ImageBuilderAdmin]\$1 su - test-user**
1. Lancez l’application (par exemple, Chromium) en tant qu’utilisateur test :
**[test-user]\$1 /usr/bin/chromium-browser**
1. Vérifiez que les paramètres par défaut sont disponibles pour l'utilisateur de test (par exemple, la page d'accueil de Chromium est https://aws.amazon.com/).
1. Vérifiez aussi qu’il a accès aux variables d’environnement. Par exemple, exécutez la commande suivante :
**[test-user]\$1 echo \$1*FOO***
La commande doit afficher la sortie ***BAR*** dans l’application Terminal.
1. Exécutez les commandes suivantes pour supprimer l’utilisateur test avant de créer une image à partir de l’instance Image Builder :
**\$1 logout test user**
**[test-user]\$1 logout**
**\$1 kill test user's running processes**
**[ImageBuilderAdmin]\$1 sudo killall -u test-user**
**\$1 delete user**
**[ImageBuilderAdmin]\$1 sudo userdel -r test-user**
## Étape 6 : terminer la création de l’image
Au cours de cette étape, vous allez attribuer un nom à l’image et achever sa création.
**Pour créer l’image**
1. Dans une fenêtre de l’application **Terminal**, exécutez **AppStreamImageAssistant create-image** pour créer une image depuis l’instance Image Builder. Cette image contient les applications que vous avez installées et enregistrées, ainsi que les scripts de session et les paramètres d’application par défaut que vous avez configurés.
Pour afficher la liste des options disponibles, exécutez **AppStreamImageAssistant create-image --help**. Pour plus d’informations, consultez l’opération **create-image** dans [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).
1. La session à distance se déconnecte au bout de quelques instants. Lorsque le message **Connectivité perdue** s’affiche, fermez l’onglet du navigateur. Pendant la création de l’image, l’instance Image Builder a pour état **Création de l’instantané en cours**. Vous ne pouvez pas vous connecter à l'Image Builder tant que ce processus n'est pas terminé.
1. Revenez à la console et naviguez jusqu’à **Images**, **Registre d’images**. Vérifiez que la nouvelle image figure dans la liste.
Pendant la création de l’image, son état dans le registre d’images de la console est **En attente**. Il est impossible de se connecter aux images dont l’état est **En attente**.
1. Choisissez l’icône **Actualiser** pour mettre à jour l’état. Une fois que votre image est créée, l'état de l'image devient **Available (Disponible)** et l'Image Builder est automatiquement arrêté.
Pour continuer à créer des images, démarrez l'Image Builder et connectez-vous y à partir de la console, ou créez un nouvel Image Builder.
## Étape 7 (facultative) : baliser et copier une image
Vous pouvez ajouter une ou plusieurs balise(s) à une image pendant ou après sa création. Vous pouvez également copier l’image dans la même région, ou dans une nouvelle région du même compte Amazon Web Services. La copie d'une image source permet d'obtenir une image de destination identique mais distincte. AWS ne copie toutefois aucune balise définie par l'utilisateur. De plus, vous pouvez uniquement copier les images personnalisées que vous créez, pas les images de base fournies par AWS.
**Note**
Vous ne pouvez pas copier simultanément plus de deux images vers une destination. Si la destination vers laquelle vous copiez une image atteint la limite d'images, vous recevez une erreur. Dans ce cas, avant de copier l’image, vous devez supprimer des images de la destination. Une fois que le nombre d’images de la région de destination est inférieur au quota (aussi appelé limite) défini, lancez la copie d’image à partir de la région source. Pour plus d’informations, consultez [Quotas du Service Amazon WorkSpaces Applications](limits.md).
**Pour ajouter des balises à une image existante**
1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.
1. Dans la liste des images, sélectionnez celle à laquelle vous souhaitez ajouter des balises.
1. Choisissez successivement **Balises**, **Ajouter/modifier des balises** et **Ajouter une balise**. Spécifiez la clé et la valeur de la balise, puis choisissez **Enregistrer**.
Pour plus d’informations, consultez [Marquer les ressources de vos WorkSpaces applications Amazon](tagging-basic.md).
**Pour copier une image**
La copie d'une image entre différentes régions géographiques vous permet de diffuser des applications à partir de plusieurs régions, à partir de la même image. En diffusant vos applications au plus près de vos utilisateurs, vous pouvez améliorer l'expérience de vos utilisateurs en diffusant des applications avec WorkSpaces Applications.
1. Dans le volet de navigation, choisissez **Images**, puis **Registre d’images**.
1. Dans la liste des images, sélectionnez celle à copier.
1. Choisissez **Actions**, puis **Copier**.
1. Dans la boîte de dialogue **Copier une image**, spécifiez les informations suivantes, puis choisissez **Copier l’image** :
+ Pour **Destination region** (Région de destination), choisissez la région vers laquelle copier la nouvelle image.
+ Pour **Name** (Nom), spécifiez un nom que l'image aura lorsqu'elle sera copiée dans la destination.
+ Pour **Description** (facultatif), spécifiez une description que l'image aura lorsqu'elle sera copiée dans la destination.
1. Pour vérifier la progression de l'opération de copie, revenez dans la console et naviguez jusqu'à **Images**, **Image Registry** (Registre d'images). Utilisez la barre de navigation pour basculer vers la région de destination (le cas échéant) et vérifiez que la nouvelle image s’affiche dans la liste des images.
La nouvelle image s'affiche d'abord avec un statut **Copying** (En cours de copie) dans le registre d'images de votre console. Lorsque l'image est créée avec succès, l'état de l'image devient **Available**, ce qui signifie que vous pouvez désormais utiliser l'image pour lancer une pile et diffuser vos applications.
## Étape 8 : nettoyer
Enfin, arrêtez les instances Image Builder en cours d’exécution pour libérer des ressources et éviter l’imputation de frais inutiles à votre compte. Il est recommandé d’arrêter toutes les instances Image Builder en cours d’exécution et non utilisées. Pour plus d'informations, consultez la section [Tarification des WorkSpaces applications](https://aws.amazon.com/appstream2/pricing/).
**Pour arrêter une instance Image Builder en cours d’exécution**
1. Dans le volet de navigation, choisissez **Images**, **Instances Image Builder**, puis sélectionnez l’instance Image Builder en cours d’exécution.
1. Choisissez **Actions**, puis **Arrêter**.
# Didacticiel : Activation de la prise en charge du japonais pour vos images Linux
Ce didacticiel explique comment activer la prise en charge du japonais pour une image Linux. Cela permet aux applications présentes sur l’image d’afficher des caractères japonais et aux utilisateurs du streaming d’utiliser la méthode de saisie japonaise dans les sessions de streaming à partir de l’image.
**Topics**
+ [Étape 1 : installer la police et la méthode de saisie japonaises](#tutorial-japanese-font)
+ [Étape 2 : définir le fuseau horaire du système](#tutorial-japanese-zone)
+ [Étape 3 : définir les paramètres régionaux et la langue d’affichage du système](#tutorial-japanese-locale)
+ [Étape 4 : configurer les méthodes de saisie](#tutorial-japanese-input)
+ [Étape 5 : définir la disposition du clavier](#tutorial-japense-keyboard)
+ [Étape 6 : vérifier sur l’instance Image Builder](#tutorial-japense-verify)
+ [Étape 7 : créer l’image](#tutorial-japanese-create)
## Étape 1 : installer la police et la méthode de saisie japonaises
Au cours de cette étape, vous connectez une instance Image Builder Linux et vous installez les packages de police et de méthode de saisie de votre choix.
**Pour installer la police et la méthode de saisie japonaises**
1. Connectez-vous à l’instance Image Builder en effectuant l’une des actions suivantes :
+ [Utiliser la console WorkSpaces Applications](managing-image-builders-connect-console.md) (pour les connexions Web uniquement)
+ [Création d'une URL de streaming](managing-image-builders-connect-streaming-URL.md) (pour les connexions client Web ou WorkSpaces applicatives)
**Note**
Vous serez connecté en tant qu' ImageBuilderAdmin utilisateur au bureau Amazon Linux GNOME et aurez les privilèges d'administrateur root.
1. Installez la police et la méthode de saisie dont vous avez besoin. Pour ce faire, ouvrez l’application Terminal, puis exécutez les commandes suivantes :
**sudo yum install vlgothic-p-fonts.noarch**
**sudo yum install ibus-kkc.x86\$164**
1. Outre les commandes ci-dessus, pour Rocky Linux et Red Hat Enterprise Linux, exécutez la commande suivante :
**sudo yum install glibc-langpack-ja**
## Étape 2 : définir le fuseau horaire du système
Pour définir le fuseau horaire du système, exécutez la commande suivante :
**sudo timedatectl set-timezone "Asia/Tokyo"**
## Étape 3 : définir les paramètres régionaux et la langue d’affichage du système
Pour définir les paramètres régionaux et la langue d’affichage du système, exécutez les commandes suivantes.
**Pour définir les paramètres régionaux et la langue d’affichage du système**
1. Mettez à jour le fichier `cloud-init config` en exécutant la commande **sudo vim /etc/cloud/cloud.cfg** et remplacez **locale** par **locale: ja\$1JP.utf8**, puis enregistrez et fermez le fichier.
1. Mettez à jour les paramètres système en exécutant **sudo localectl set-locale LANG=ja\$1JP.utf8**.
1. Mettez à jour les paramètres du shell Gnome en exécutant **sudo gsettings set org.gnome.system.locale region "ja\$1JP.utf8"**.
## Étape 4 : configurer les méthodes de saisie
Configurez les méthodes de saisie pour l’application que vous souhaitez ajouter à l’image. Pour plus d’informations sur l’installation d’une application, la génération d’un fichier manifeste et la création de paramètres par défaut, consultez [Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée](tutorial-create-linux-image.md). Dans cette étape, nous partons du principe que vous avez déjà installé l’application Firefox, qui se trouve sous `/usr/local/firefox/firefox`.
**Pour configurer les méthodes de saisie**
1. Créez un script en exécutant la commande **sudo vim /usr/local/bin/update-input-method.sh**, puis ajoutez-y le contenu suivant :
```
#!/bin/bash
function start_process()
{
command=$1
process_name=$2
process_count=$(pgrep $process_name -c)
echo "$(date) current $process_name count: $process_count"
while [ $process_count -lt 1 ]
do
echo "$(date) starting $process_name"
eval $command
sleep 1
process_count=$(pgrep $process_name -c)
done
echo "$(date) $process_name started"
}
start_process "ibus-daemon --xim &" "ibus-daemon"
start_process "/usr/libexec/ibus-engine-kkc --ibus &" "ibus-engine-kkc"
gsettings set org.gnome.desktop.input-sources sources "[('ibus','kkc'), ('xkb', 'us')]"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source "['space']"
gsettings set org.gnome.desktop.wm.keybindings switch-input-source-backward "['space']"
echo "$(date) updated input source and switch shortcut"
```
Dans le script ci-dessus, la première source d’entrée (’ibus’, ’kkc’) est la méthode de saisie par défaut. Vous pouvez modifier la méthode de saisie par défaut en modifiant l’ordre des sources d’entrée. En outre, « Ctrl\$1Espace » et « Maj\$1Ctrl\$1Espace » sont spécifiés comme combinaisons de touches de raccourci pour passer d’une méthode de saisie à l’autre. Vous pouvez définir vos propres combinaisons de touches que vos utilisateurs pourront utiliser pour changer de méthode de saisie pendant les sessions de streaming.
1. Créez le script de lancement de l’application (Firefox) que vous allez ajouter à l’image. Pour ce faire, exécutez la commande**sudo vim /usr/local/bin/firefox-jp.sh**, puis ajoutez le contenu suivant au script :
```
#!/bin/bash
# Gather required environment variables from the GNOME shell session
while IFS= read -r -d $'\0' env_var; do
case "$env_var" in
DBUS_SESSION_BUS_ADDRESS=*|\
GTK_IM_MODULE=*|\
QT_IM_MODULE=*|\
XMODIFIERS=*|\
XAUTHORITY=*)
echo "$env_var"
export "$env_var"
;;
esac
done < "/proc/$(pgrep -u as2-streaming-user gnome-shell | head -n1)/environ"
/usr/local/bin/update-input-method.sh > /var/tmp/update-input-method.log 2>&1 &
/usr/local/firefox/firefox &
```
1. Ajoutez l’autorisation d’exécution aux deux scripts en exécutant les commandes suivantes :
**sudo chmod \$1x /usr/local/bin/update-input-method.sh**
**sudo chmod \$1x /usr/local/bin/firefox-jp.sh**
1. Si vous avez déjà créé le fichier manifeste d’optimisation pour l’application, exécutez les commandes suivantes pour ajouter le script de lancement de l’application au catalogue d’applications :
```
sudo AppStreamImageAssistant add-application \
--name firefox \
--absolute-app-path /usr/local/bin/firefox-jp.sh \
--display-name firefox \
--absolute-icon-path /usr/local/firefox/browser/chrome/icons/default/default128.png \
--absolute-manifest-path /tmp/firefox-manifest.txt
```
Vous pouvez également configurer les méthodes de saisie en ajoutant le script update-input-method .sh en tant qu'application distincte au catalogue d'applications pour l'image. Pendant les sessions de streaming, vos utilisateurs peuvent lancer cette application pour activer la saisie en japonais, et passer d’une méthode de saisie à l’autre à l’aide des touches de raccourci spécifiées au cours de la même session.
## Étape 5 : définir la disposition du clavier
Définissez la disposition du clavier pour qu’elle corresponde aux claviers que vos utilisateurs utiliseront pendant les sessions de streaming. Vous pouvez utiliser la commande **localectl list-keymaps** pour répertorier tous les mappages de touches disponibles, et la commande **sudo localectl set-keymap jp106** pour définir le mappage de touches sur le clavier japonais de 106 touches, par exemple.
## Étape 6 : vérifier sur l’instance Image Builder
Pour vérifier sur l’instance Image Builder, redémarrez d’abord celle-ci en exécutant la commande **sudo shutdown -r now**. Après le redémarrage, reconnectez-vous à l’instance Image Builder et vérifiez que tout fonctionne comme prévu, y compris le fuseau horaire, les paramètres régionaux, la langue et la méthode de saisie.
## Étape 7 : créer l’image
Créez l’image sur l’instance Image Builder. Pour plus d’informations, consultez [Tutoriel : Création d'une image d'applications Linux WorkSpaces personnalisée](tutorial-create-linux-image.md). Assurez-vous de créer les paramètres d’application par défaut, y compris les paramètres régionaux que vous venez de configurer. Pour plus d’informations, consultez « Création de paramètres d’application par défaut pour vos utilisateurs » dans [Création d’images basées sur Linux](create-linux-based-images.md).
Toutes les instances de flotte Linux créées à partir de cette image auront les mêmes paramètres régionaux, de fuseau horaire, de langue et de méthode de saisie par défaut que ceux que vous avez configurés pour l’image.
# Utilisez des scripts de session pour gérer l'expérience de streaming de vos utilisateurs d'Amazon WorkSpaces Applications
WorkSpaces Les applications fournissent des scripts de session sur instance. Vous pouvez les utiliser pour exécuter vos propres scripts personnalisés lorsque des événements spécifiques surviennent au cours des sessions de streaming des utilisateurs. Par exemple, vous pouvez utiliser des scripts personnalisés pour préparer l'environnement de vos WorkSpaces applications avant le début des sessions de streaming de vos utilisateurs. Vous pouvez également utiliser les scripts personnalisés pour nettoyer les instances de streaming après que les utilisateurs ont terminé leur session.
Les scripts de session sont spécifiés dans une image d' WorkSpaces applications. Ces scripts sont exécutés au sein du contexte de l'utilisateur ou du contexte du système. Si vos scripts de session utilisent la sortie standard pour écrire des messages d’information, d’erreur ou de débogage, ils peuvent éventuellement être enregistrés dans un compartiment Amazon S3 de votre compte Amazon Web Services.
**Topics**
+ [Exécution de scripts avant le début des sessions de streaming](run-scripts-before-streaming-sessions-begin.md)
+ [Exécution de scripts une fois les sessions de streaming terminées](run-scripts-after-streaming-sessions-end.md)
+ [Création et spécification de scripts de session](create-specify-session-scripts.md)
+ [Fichier de configuration des scripts de session](session-script-configuration-file.md)
+ [Utilisation de PowerShell fichiers Windows](using-powershell-files-with-session-scripts.md)
+ [Journalisation de la sortie du script de session](logging-session-output.md)
+ [Utilisation des connecteurs de stockage avec les scripts de session](use-storage-connectors-with-session-scripts.md)
+ [Activation du stockage des journaux de script de session dans un compartiment Amazon S3](enable-S3-bucket-storage-session-script-logs.md)
+ [Utiliser des scripts de session sur des flottes multisessions](session-scripts-multi-session-fleets.md)
# Exécution de scripts avant le début des sessions de streaming
Vous pouvez configurer vos scripts pour qu'ils s'exécutent pendant 60 secondes maximum avant que les applications de vos utilisateurs se lancent et que leurs sessions de streaming commencent. Cela vous permet de personnaliser l'environnement des WorkSpaces applications avant que les utilisateurs ne commencent à diffuser leurs applications. Pendant que les scripts de session s'exécutent, une icône de chargement s'affiche sur l'écran de vos utilisateurs. Lorsque l'exécution des scripts est terminée ou que le temps d'attente maximum s'est écoulé, la session de streaming de vos utilisateurs commence. Si vos scripts ne parviennent pas à s'exécuter complètement, un message d'erreur s'affiche sur l'écran de vos utilisateurs. Toutefois, cette erreur ne les empêche pas d'accéder à leur session de streaming.
Lorsque vous spécifiez un nom de fichier sur une instance Windows, vous devez utiliser une double barre oblique inverse. Par exemple :
C:\$1\$1Scripts\$1\$1Myscript.bat
Si vous n'utilisez pas une une double barre oblique inverse, un message d'erreur s'affiche pour vous avertir que le fichier .json n'est pas correctement formaté.
**Note**
Si l'exécution de vos scripts réussit complètement, une valeur de 0 devrait vous être renvoyée. Si vos scripts renvoient une valeur autre que 0, WorkSpaces Applications affiche le message d'erreur à l'attention de l'utilisateur.
Lorsque vous exécutez des scripts avant le début des sessions de streaming et que le framework d' WorkSpaces applications dynamiques des applications n'est pas activé, le processus suivant se produit :
![\[WorkSpaces Applications workflow diagram showing connection, application selection, and session launch steps.\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/images/session-scripts-without-DAF-non-domain-joined2.png)
1. Vos utilisateurs se connectent à une instance de parc d' WorkSpaces applications qui n'est pas jointe à un domaine. Ils se connectent à l'aide d'une des méthodes d'accès suivantes :
+ WorkSpaces Groupe d'utilisateurs d'applications
+ SAML 2.0
+ WorkSpaces API d'applications
1. Le catalogue d'applications s'affiche dans le portail WorkSpaces Applications, et vos utilisateurs choisissent l'application à lancer.
1. L'un des scénarios suivants survient :
+ Si la persistance des paramètres d'application est activée pour vos utilisateurs, le fichier de paramètres d'application VHD (Virtual Hard Disk), qui stocke les personnalisations et les paramètres Windows de vos utilisateurs, est téléchargé et monté. Dans ce cas, la connexion utilisateur à Windows est requise.
Pour en savoir plus sur la persistance des paramètres d'application, consultez [Activer la persistance des paramètres d'application pour les utilisateurs de vos WorkSpaces applications](app-settings-persistence.md).
+ Si la persistance des paramètres d'application n'est pas activée, l'utilisateur Windows est déjà connecté.
1. Vos scripts de session démarrent. Si le stockage persistant est activé pour vos utilisateurs, le montage du connecteur de stockage se lance également. Pour en savoir plus sur le stockage persistant, consultez [Activez et gérez le stockage permanent pour les utilisateurs de vos WorkSpaces applications](persistent-storage.md).
**Note**
Le montage du connecteur de stockage n’a pas besoin d’être terminé pour que la session de streaming démarre. Si l’exécution des scripts de session est terminée avant que le connecteur de stockage ne soit monté, la session de streaming commence.
Pour savoir comment surveiller l’état de montage des connecteurs de stockage, consultez [Utilisation des connecteurs de stockage avec les scripts de session](use-storage-connectors-with-session-scripts.md).
1. L’exécution de vos scripts de session est terminée ou expire.
1. La session de streaming des utilisateurs démarre.
1. L’application que vos utilisateurs ont sélectionnée se lance.
Pour plus d'informations sur le framework d' WorkSpaces applications dynamiques Applications, consultez[Utiliser le framework d' WorkSpaces applications dynamiques pour créer un fournisseur d'applications dynamiques](build-dynamic-app-provider.md).
Lorsque vous exécutez des scripts avant le début des sessions de streaming et que le framework d' WorkSpaces applications dynamiques des applications est activé, le processus suivant se produit :
![\[WorkSpaces Applications workflow from user login to application launch, including SAML authentication and session scripts.\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/images/session-scripts-with-DAF-domain-joined2.png)
1. Vos utilisateurs consultent le portail d'applications SAML 2.0 de votre organisation et choisissent la pile WorkSpaces Applications.
1. Ils se connectent à une instance de parc d' WorkSpaces applications jointe à un domaine.
1. Si la persistance des paramètres d'application est activée pour vos utilisateurs, le fichier de paramètres d'application VHD, qui stocke les personnalisations et les paramètres Windows de vos utilisateurs, est téléchargé et monté.
1. L'utilisateur Windows est connecté.
1. Le catalogue d'applications s'affiche dans le portail WorkSpaces Applications et vos utilisateurs choisissent l'application à lancer.
1. Vos scripts de session démarrent. Si le stockage persistant est activé pour vos utilisateurs, le montage du connecteur de stockage se lance également.
**Note**
Le montage du connecteur de stockage n’a pas besoin d’être terminé pour que la session de streaming démarre. Si l’exécution des scripts de session est terminée avant que le connecteur de stockage ne soit monté, la session de streaming commence.
Pour savoir comment surveiller l’état de montage des connecteurs de stockage, consultez [Utilisation des connecteurs de stockage avec les scripts de session](use-storage-connectors-with-session-scripts.md).
1. L’exécution de vos scripts de session est terminée ou expire.
1. La session de streaming des utilisateurs démarre.
1. L’application que vos utilisateurs ont sélectionnée se lance.
# Exécution de scripts une fois les sessions de streaming terminées
Vous pouvez également configurer vos scripts de manière à ce qu'ils s'exécutent après les sessions de streaming. Par exemple, vous pouvez exécuter un script lorsque les utilisateurs sélectionnent **Fin de session** dans la barre d'outils des WorkSpaces applications ou lorsqu'ils atteignent la durée maximale autorisée pour la session. Vous pouvez également utiliser ces scripts de session pour nettoyer l'environnement de vos WorkSpaces applications avant de mettre fin à une instance de streaming. Par exemple, vous pouvez utiliser les scripts pour libérer des verrouillages de fichiers ou pour charger des fichiers journaux. Si vous exécutez des scripts une fois les sessions de streaming terminées, le scénario suivant se produit :
![\[Flowchart showing WorkSpaces Applications session termination process with scripts and storage actions.\]](http://docs.aws.amazon.com/fr_fr/appstream2/latest/developerguide/images/session-scripts-termination.png)
1. La session de streaming des WorkSpaces applications de vos utilisateurs se termine.
1. Vos scripts d'arrêt de session démarrent.
1. L'exécution des scripts d'arrêt de session se termine ou expire.
1. L'utilisateur Windows est déconnecté.
1. Un des scénarios suivants, ou les deux, se produi(sen)t, le cas échéant :
+ Si la persistance des paramètres d’application est activée pour vos utilisateurs, le fichier VHD de paramètres d’application, qui stocke les personnalisations et les paramètres Windows de vos utilisateurs, est démonté et chargé dans un compartiment Amazon S3 de votre compte.
+ Si le stockage persistant est activé pour vos utilisateurs, le connecteur de stockage effectue une synchronisation finale et est démonté.
1. L'instance de flotte est arrêtée.
# Création et spécification de scripts de session
Vous pouvez configurer et spécifier des scripts de session pour les flottes toujours actives, à la demande et Elastic.
**Pour configurer et spécifier des scripts de session pour les flottes toujours actives et à la demande**
1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Dans le panneau de navigation, choisissez **Images**, puis **Image Builder**.
1. Choisissez un Image Builder dont l'état correspond à **Running (En cours d'exécution)**, puis sélectionnez **Connect (Se connecter)**.
1. Lorsque vous y êtes invité, sélectionnez **Administrateur**.
1. Accédez à `C:\AppStream\SessionScripts` et ouvrez le fichier de configuration `config.json`.
Pour en savoir plus sur les paramètres des scripts de session, consultez [Fichier de configuration des scripts de session](session-script-configuration-file.md).
1. Une fois que vous avez terminé d’effectuer vos modifications, enregistrez puis fermez le fichier `config.json`.
1. Sur le bureau de l’instance Image Builder, ouvrez l’application **Image Assistant**.
1. (Facultatif) Spécifiez les autres applications que vous souhaitez inclure dans l’image.
1. Effectuez les étapes nécessaires dans Image Assistant pour finaliser la création de votre image.
Si la configuration des scripts de session ne peut pas être validée (par exemple, si le fichier .json n'est pas correctement formaté), vous en êtes averti lorsque vous choisissez **Disconnect and create image (Se déconnecter et créer une image)**.
**Note**
Pour localiser le fichier de configuration des scripts de session pour les instances Image Builder Linux, accédez à `/opt/appstream/SessionScripts/config.json`.
**Pour configurer et spécifier des scripts de session pour les flottes Elastic**
1. Créez un fichier zip contenant les scripts de session et le fichier config.json. Les fichiers de script seront copiés aux emplacements suivants. Vous devez utiliser ces emplacements pour votre fichier config.json.
+ Pour Windows, utilisez `C:\AppStream\SessionScripts\SessionScript`.
+ Pour Linux, utilisez `/opt/appstream/SessionScripts/SessionScript`.
**Note**
Pour exécuter les fichiers de script de session, assurez-vous que le fichier .zip inclut uniquement les scripts de session et les fichiers `config.json`, et non le dossier qui les contient. Pour plus d’informations, consultez [Fichier de configuration des scripts de session](session-script-configuration-file.md).
1. Chargez le fichier zip dans un compartiment Amazon S3 de votre compte.
**Note**
Votre VPC doit fournir l’accès au compartiment Amazon S3. Pour de plus amples informations, veuillez consulter [Fonctionnalités d'utilisation des points de terminaison VPC Amazon S3 pour les applications WorkSpaces](managing-network-vpce-iam-policy.md).
Vous devez avoir votre compartiment S3 et votre parc WorkSpaces d'applications au même endroit Région AWS.
Vous devez disposer des autorisations IAM pour effectuer l’action `S3:GetObject` sur l’objet scripts de session dans le compartiment Amazon S3. Pour en savoir plus sur le stockage des scripts de session dans un compartiment Amazon S3, consultez [Stockage de l’icône de l’application, du script de configuration, du script de session et du VHD dans un compartiment S3](store-s3-bucket.md).
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, sélectionnez **Flottes**.
1. Choisissez une flotte Elastic à mettre à jour, puis sélectionnez **Afficher les détails**.
1. Dans l’onglet **Paramètres des scripts de session**, choisissez **Modifier**.
1. Pour **Objet scripts de session dans S3**, entrez l’URI S3 qui représente l’objet scripts de session ou choisissez **Parcourir S3** pour accéder à vos compartiments S3 et trouver l’objet scripts de session.
1. Une fois les modifications terminées, choisissez **Enregistrer les modifications**.
1. À ce stade, les scripts de session sont disponibles pour toutes les instances de flotte lancées.
**Note**
Vous pouvez également configurer les scripts de session lorsque vous créez une nouvelle flotte Elastic.
# Fichier de configuration des scripts de session
Pour localiser le fichier de configuration des scripts de session dans une instance Windows, accédez à C : \$1 \$1 AppStream SessionScripts \$1 config.json. Sur une instance Linux, accédez à/opt/appstream/SessionScripts/config.json. Le format du fichier est le suivant.
**Note**
Le fichier de configuration est au format .json. Vérifiez que tout le texte que vous saisissez dans ce fichier est au format .json valide.
```
{
"SessionStart": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
},
"SessionTermination": {
"executables": [
{
"context": "system",
"filename": "",
"arguments": "",
"s3LogEnabled": true
},
{
"context": "user",
"filename": "",
"arguments": "",
"s3LogEnabled": true
}
],
"waitingTime": 30
}
}
```
Vous pouvez utiliser les paramètres suivants dans le fichier de configuration des scripts de session.
***SessionStart/SessionTermination ***
Les scripts de session s'exécutent dans l'événement de session approprié, en fonction du nom de l'objet.
**Type** : chaîne
**Obligatoire** : non
**Valeurs autorisées :** **SessionStart**, **SessionTermination**
***WaitingTime***
Durée maximale en secondes des scripts de session.
**Type** : entier
**Obligatoire** : non
**Contraintes :** la durée maximale ne peut pas dépasser 60 secondes. Si l'exécution des scripts de session n'est pas terminée au terme de ce délai, elle s’arrête. Si vous avez besoin d'un script pour continuer l’exécution, lancez-le comme un processus distinct.
***Executables***
Détails sur les scripts de session à exécuter.
**Type** : chaîne
**Obligatoire** : oui
**Contraintes :** le nombre maximum de scripts qui peuvent s'exécuter par événement de session est de 2 (un pour le contexte de l'utilisateur et l'autre pour le contexte du système).
***Context***
Le contexte dans lequel le script de session doit être exécuté.
**Type** : chaîne
**Obligatoire** : oui
**Valeurs autorisées :** **user**, **system**
***Filename***
Le chemin d'accès complet au script de session qui doit être exécuter. Si ce paramètre n'est pas spécifié, le script de session n'est pas exécuté.
**Type** : chaîne
**Obligatoire** : non
**Contraintes :** la longueur maximale du nom de fichier et du chemin d'accès complet est de 1 000 caractères.
**Valeurs autorisées :****.bat**,**.exe**, **.sh**
Vous pouvez également utiliser des PowerShell fichiers Windows. Pour de plus amples informations, veuillez consulter [Utilisation de PowerShell fichiers Windows](using-powershell-files-with-session-scripts.md).
***Arguments***
Les arguments pour votre script de session ou votre fichier exécutable.
**Type** : chaîne
**Obligatoire** : non
**Contraintes de longueur :** la longueur maximale est de 1 000 caractères.
***S3LogEnabled***
Lorsque la valeur de ce paramètre est définie sur **True**, un compartiment S3 est créé dans votre compte Amazon Web Services pour stocker les journaux créés par le script de session. Par défaut, cette valeur indique **True**. Pour en savoir plus, consultez la section *Journalisation de la sortie du script de session* plus loin dans cette rubrique.
**Type** : valeur booléenne
**Obligatoire** : non
**Valeurs autorisées :** **True**, **False**
# Utilisation de PowerShell fichiers Windows
Pour utiliser PowerShell des fichiers Windows, spécifiez le chemin complet du PowerShell fichier dans le **filename** paramètre :
```
"filename":
"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
```
Ensuite, spécifiez votre script de session dans le paramètre **arguments** :
```
"arguments": "-File \"C:\\path\\to\\session\\script.ps1\"",
```
Enfin, vérifiez que la politique PowerShell d'exécution autorise l'exécution de votre PowerShell fichier.
# Journalisation de la sortie du script de session
Lorsque cette option est activée dans le fichier de configuration, WorkSpaces Applications capture automatiquement le résultat du script de session écrit sur la sortie standard. Cette sortie est chargée dans un compartiment Amazon S3 de votre compte. Vous pouvez consulter les fichiers journaux à des fins de dépannage ou de débogage.
**Note**
Les fichiers journaux sont chargés lorsque le script de session renvoie une valeur, ou lorsque la valeur définit dans **WaitingTime** s'est écoulée, en fonction de l'événement qui se produit en premier.
# Utilisation des connecteurs de stockage avec les scripts de session
Lorsque WorkSpaces les connecteurs de stockage des applications sont activés, leur montage commence lorsque les scripts de démarrage de session s'exécutent. Si votre script repose sur le montage des connecteurs de stockage, vous pouvez attendre qu'ils soient disponibles. WorkSpaces Les applications conservent l'état de montage des connecteurs de stockage dans le registre Windows sur les instances Windows, à l'aide de la clé suivante :
HKEY\$1LOCAL\$1MACHINE \$1 SOFTWARE \$1 Amazon \$1 \$1 Storage \$1 \$1 AppStream
Les valeurs de la clé de registre sont les suivantes :
+ Nom d’utilisateur fourni : ID utilisateur fourni via le mode d’accès. Les modes d'accès et la valeur pour chaque mode sont les suivants :
+ Groupe d’utilisateurs : adresse e-mail de l’utilisateur
+ URL de streaming : ID utilisateur (UserID)
+ SAML : ID du nom (NameID). Si le nom d'utilisateur inclut une barre oblique (par exemple, le SAMAccount nom d'utilisateur d'un domaine), la barre oblique est remplacée par un caractère « - ».
+ Connecteur de stockage : connecteur pour l’option de stockage persistant qui a été activée pour l’utilisateur. Les valeurs du connecteur de stockage sont les suivantes :
+ HomeFolder
+ GoogleDrive
+ OneDrive
Chaque clé de registre du connecteur de stockage contient une valeur **MountStatus**DWORD. Le tableau suivant répertorie les valeurs possibles pour **MountStatus**.
**Note**
Pour afficher ces clés de registre, vous devez avoir installé Microsoft .NET Framework version 4.7.2 ou ultérieure sur votre image.
| Value | Description |
| --- | --- |
| 0 | Connecteur de stockage non activé pour cet utilisateur |
| 1 | Montage du connecteur de stockage en cours |
| 2 | Montage du connecteur de stockage terminé |
| 3 | Échec du montage du connecteur de stockage |
| 4 | Le montage du connecteur de stockage est activé, mais pas encore monté |
Sur les instances Linux, vous pouvez vérifier l'état de montage du dossier de base en consultant la valeur de appstream\$1home\$1folder\$1mount\$1status dans le fichier \$1/. config/appstream-home-folder/appstream-home-folder-mount-status.
| Value | Description |
| --- | --- |
| True | Le dossier de base est monté avec succès |
| False | Le dossier de base n’est pas encore monté |
# Activation du stockage des journaux de script de session dans un compartiment Amazon S3
Lorsque vous activez la connexion Amazon S3 dans la configuration de votre script de session, WorkSpaces Applications capture le résultat standard de votre script de session. La sortie est régulièrement chargée dans un compartiment S3 au sein de votre compte Amazon Web Services. Pour chaque AWS région, WorkSpaces Applications crée un compartiment dans votre compte qui est propre à votre compte et à la région.
Vous n'avez à effectuer aucune tâche de configuration pour gérer ces compartiments S3. Ils sont entièrement gérés par le service WorkSpaces Applications. Les fichiers journaux qui sont stockés dans chaque compartiment sont chiffrés en transit à l’aide des points de terminaison SSL d’Amazon S3 et au repos à l’aide des clés de chiffrement gérées par Amazon S3. Les compartiments sont nommés dans un format spécifique comme suit :
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
***region-code***
Il s'agit du code de AWS région dans lequel la pile est créée avec le stockage par compartiment Amazon S3 activé pour les journaux de script de session.
***account-id-without-hyphens***
Identifiant de votre compte Amazon Web Services. L'identifiant aléatoire permet de garantir qu'aucun conflit ne sera déclenché avec les autres compartiments de la région. La première partie du nom du compartiment, `appstream-logs`, ne change pas quel que soit le compte ou la région.
Par exemple, si vous spécifiez des scripts de session dans une image de la région USA Ouest (Oregon) (us-west-2) sous le numéro de compte 123456789012 WorkSpaces , Applications crée un compartiment Amazon S3 au sein de votre compte dans cette région avec le nom indiqué. Seul un administrateur disposant d’autorisations suffisantes peut supprimer ce compartiment.
```
appstream-logs-us-west-2-1234567890123-abcdefg
```
La désactivation des scripts de session ne supprime aucun fichier journal stocké dans le compartiment S3. Pour supprimer définitivement les fichiers journaux, vous ou un autre administrateur disposant des autorisations appropriées devez le faire à l'aide de la console ou de l'API Amazon S3. WorkSpaces Applications ajoute une politique de compartiment qui empêche la suppression accidentelle du compartiment. Pour plus d’informations, consultez *Stratégies IAM et compartiment Amazon S3 pour la persistance des paramètres d’application* dans [Identity and Access Management pour les WorkSpaces applications Amazon](controlling-access.md).
Lorsque les scripts de session sont activés, un dossier unique est créé pour chaque session de streaming démarrée.
Le chemin d’accès au dossier dans lequel les fichiers journaux sont stockés dans le compartiment S3 de votre compte est structuré comme suit :
```
bucket-name/stack-name/fleet-name/access-mode/user-id-SHA-256-hash/session-id/SessionScriptsLogs/session-event
```
***bucket-name***
Le nom du compartiment S3 dans lequel les scripts de session sont stockés. Le format du nom est décrit plus haut dans cette section.
***stack-name***
Le nom de la pile d'où est issue la session.
***fleet-name***
Le nom de la flotte sur laquelle le script de session s'exécute.
***access-mode***
La méthode d'identification de l'utilisateur : `custom` pour l'API ou la CLI des WorkSpaces applications, `federated` pour le SAML et `userpool` pour les utilisateurs du groupe d'utilisateurs.
***user-id-SHA-256-hash***
Nom du dossier spécifique à l’utilisateur. Ce nom est créé à l'aide d'une chaîne hexadécimale de hachage SHA-256 en minuscules, générée à partir de l'identifiant utilisateur.
***session-id***
L'identifiant de la session de streaming de l'utilisateur. Chaque session de streaming utilisateur génère un ID unique.
***session-event***
L'événement qui a généré le journal du script de session. Les valeurs des événements sont `SessionStart` et `SessionTermination`.
L'exemple de structure de dossier suivant correspond à une session de streaming démarrée à partir de test-stack (pile-test) et test-fleet (flotte-test). La session utilise l'API de l'ID utilisateur`testuser@mydomain.com`, à partir d'un Compte AWS ID de`123456789012`, et le groupe `test-stack` de paramètres de la région USA Ouest (Oregon) (us-west-2) :
```
appstream-logs-us-west-2-1234567890123-abcdefg/test-stack/test-fleet/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/05yd1391-4805-3da6-f498-76f5x6746016/SessionScriptsLogs/SessionStart/
```
L'exemple de structure de dossier contient un fichier journal pour le script de démarrage de session du contexte utilisateur, et un autre fichier journal pour le script de démarrage de session du contexte système, le cas échéant.
# Utiliser des scripts de session sur des flottes multisessions
Lorsque vous utilisez des scripts de session sur des flottes multisessions, des exigences et des considérations supplémentaires doivent être prises en compte pour garantir des performances et une sécurité optimales.
## Exigences
Sur une flotte à session unique, pour une instance donnée, il est garanti que les **SessionTermination**hooks **SessionStart**et ne fonctionneront qu'une seule fois. Cela est dû au fait qu'il existe un mappage 1:1 des sessions aux instances. Lorsque vous utilisez des flottes multisessions, il existe un mappage N:M des sessions aux instances, où chaque session exécute sa propre session et se connecte. **SessionStart**SessionTermination**** Cela signifie que les **SessionTermination**hooks **SessionStart**and peuvent être exécutés plusieurs fois sur une instance donnée, et dans de nombreux ordres différents. Pour une expérience optimale, les règles suivantes doivent s'appliquer à vos scripts de session lorsqu'ils sont utilisés sur des flottes multisessions :
+ Les scripts sont idempotents.
Lorsqu'une action a déjà été exécutée, les scripts doivent gérer plusieurs exécutions sur la même instance avec une gestion harmonieuse.
+ Les scripts sont indépendants.
Comme les scripts s'exécutent par session, si une session est **SessionTermination**en cours d'exécution pendant qu'une autre est en cours d'exécution **SessionStart**, ils ne doivent pas interférer les uns avec les autres ni avec l'expérience des autres sessions.
+ Les scripts sont performants.
Sur les instances multisessions, plusieurs sessions peuvent être mises en service simultanément. Cela signifie qu'il peut y avoir plusieurs exécutions simultanées des scripts de session. Les scripts doivent être efficaces, ne pas consommer trop de ressources et ne pas affecter l'expérience des autres utilisateurs sur l'instance ni la stabilité des sessions.
La plupart de ces exigences peuvent être satisfaites en gardant la logique du script de session centrée sur la session utilisateur spécifique pour laquelle le script est exécuté.
## Considérations de sécurité
WorkSpaces Les images des applications ne doivent pas être configurées pour autoriser les utilisateurs à accéder en écriture aux fichiers de script de session. Cela introduit un vecteur d'attaque critique pour les utilisateurs malveillants, qui peuvent modifier les fichiers de script. Ces fichiers peuvent ensuite être exécutés en tant que SYSTEM ou sous un autre nom d'utilisateur, en fonction de votre configuration.
**Important**
Il est de votre responsabilité de vous assurer que les images de vos WorkSpaces applications sont configurées de manière sécurisée. Cela est particulièrement important pour les instances multi-sessions, où plusieurs utilisateurs utilisent la même instance. Si les images ne sont pas configurées de manière sécurisée, il existe un risque de sécurité pour tous les utilisateurs de cette instance.
Ce qui suit doit être vrai pour vos images et vos fichiers de scripts de session :
+ Les utilisateurs ne sont pas autorisés à modifier les fichiers de script de session.
+ Les utilisateurs ne sont pas autorisés à modifier le script de session config.json. Le comportement par défaut de l'image restreint l'accès aux administrateurs.
Les exécutables des scripts de session doivent être stockés dans un emplacement sécurisé où ils ne peuvent pas être modifiés lors de l'exécution.
Si le service détecte qu'un exécutable de script de session a été modifié, il échouera à toute exécution ultérieure de ce hook sur cette instance, téléchargera les fichiers journaux sur Amazon S3 (si la journalisation Amazon S3 est activée) et le message suivant s'affichera :
**Le script de session n'a pas été exécuté car l'exécutable a été modifié après le provisionnement de l'instance. L'exécution a été ignorée pour des raisons de sécurité.**
Si votre cas d'utilisation nécessite de modifier le script de session exécutable au moment de l'exécution (par exemple, si vous pointez sur un fichier EXE modifié par un processus de mise à jour automatique lors de l'exécution), les vérifications ci-dessus échoueront. Dans ce cas, utilisez un script pour rediriger l'exécution vers votre exécutable modifié. Ne modifiez pas le script au moment de l'exécution lorsque le service effectue des contrôles de sécurité.
Si les fichiers de script de session sont trop volumineux (plus de 100 Mo), cela peut entraîner des retards dans le provisionnement des instances et des sessions, et les contrôles de sécurité peuvent prendre plus de temps (en fonction du type d'instance et des ressources disponibles). Si votre cas d'utilisation nécessite des scripts de session volumineux, pensez à utiliser des scripts plus petits pour rediriger l'exécution. Cela améliorera les expériences de provisionnement des instances et des sessions.
Notez que le service ne vérifie que l'exécutable défini dans les scripts de session config.json, et qu'il ne s'agit que d'un mécanisme d' fallback/best effort. Il est de votre responsabilité de vous assurer que tous les chemins de code des exécutables des scripts de session sont sécurisés et ne peuvent pas être modifiés par les utilisateurs finaux.