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. # Bundles et images pour les piscines WorkSpaces Un *WorkSpace bundle* est une combinaison d'un système d'exploitation et de ressources de stockage, de calcul et logicielles. Lorsque vous lancez un WorkSpace, vous sélectionnez le pack qui répond à vos besoins. Les offres groupées par défaut disponibles WorkSpaces sont appelées *offres groupées publiques*. Pour plus d'informations sur les différents forfaits publics disponibles WorkSpaces, consultez [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Si vous avez lancé un Windows WorkSpace et que vous l'avez personnalisé, vous pouvez créer une image personnalisée à partir de celui-ci WorkSpace à utiliser avec WorkSpaces Pool. Linux n'est pas pris en charge dans WorkSpaces Pool. Une *image personnalisée* contient uniquement le système d'exploitation, le logiciel et les paramètres du WorkSpace. Un *bundle personnalisé* est une combinaison de cette image personnalisée et du matériel à partir duquel il WorkSpace peut être lancé. Après avoir créé une image personnalisée, vous pouvez créer un ensemble personnalisé qui combine l' WorkSpace image personnalisée et la configuration de calcul et de stockage sous-jacente que vous sélectionnez. Vous pouvez ensuite spécifier ce bundle personnalisé lorsque vous créez de nouveaux WorkSpaces pools afin de vous assurer que WorkSpaces les nouveaux pools ont la même configuration cohérente (matérielle et logicielle). Si vous devez effectuer des mises à jour logicielles ou installer des logiciels supplémentaires sur votre WorkSpaces, vous pouvez mettre à jour votre bundle personnalisé et l'utiliser pour reconstruire votre WorkSpaces. WorkSpaces Les pools prennent en charge différents systèmes d'exploitation (OS), protocoles de streaming et offres groupées. Le tableau suivant fournit des informations sur les licences, les protocoles de streaming et les offres groupées pris en charge par chaque système d'exploitation. | Système d’exploitation | Licences | Protocoles de streaming | Offres groupées prises en charge | Politique de cycle de vie/date de retraite | | --- | --- | --- | --- | --- | | Windows Server 2019 | Inclus | DCV | Valeur, norme, performance, puissance, PowerPro | [9 janvier 2029](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2019) | | Windows Server 2022 | Inclus | DCV | Standard, performance, alimentation, carte PowerPro graphique.G4DN, .G4DN GraphicsPro | [14 octobre 2031](https://learn.microsoft.com/en-us/lifecycle/products/windows-server-2022) | **Note** Les versions du système d'exploitation qui ne sont plus prises en charge par le fournisseur ne sont pas garanties de fonctionner et ne sont pas prises en charge par le AWS support. **Topics** + [Options de bundle pour les WorkSpaces piscines](pools-custom-images-bundles.md) + [Création d'une image personnalisée et d'un bundle pour WorkSpaces Pools](pools-images-custom-image.md) + [Gérez des images et des ensembles personnalisés pour les pools WorkSpaces](pools-images-managing.md) + [Utilisez des scripts de session pour gérer l'expérience de streaming de vos utilisateurs](pools-images-session-scripts.md) # Options de bundle pour les WorkSpaces piscines Avant de sélectionner un bundle à utiliser avec WorkSpaces Pool, assurez-vous que le bundle que vous souhaitez sélectionner est compatible avec votre protocole WorkSpaces, votre système d'exploitation, votre réseau et votre type de calcul. Nous recommandons de tester dans un environnement dédié les performances des bundles que vous souhaitez choisir, en exécutant et en utilisant les applications qui reproduisent les tâches quotidiennes des utilisateurs. Pour plus d'informations sur les protocoles, consultez[Protocoles pour le WorkSpaces personnel](amazon-workspaces-networking.md#amazon-workspaces-protocols). Pour plus d'informations sur les réseaux, consultez[Configuration requise pour le réseau client pour WorkSpaces Personal](workspaces-network-requirements.md). Les bundles publics suivants peuvent être utilisés avec WorkSpaces Pool. Pour plus d'informations sur les offres groupées incluses WorkSpaces, consultez [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Valeur, norme, performance, puissance, PowerPro ## Offre Value Ce bundle convient parfaitement aux activités suivantes : + Édition de texte et saisie de données de base + Navigation sur le Web avec une utilisation légère + Messagerie instantanée Ce bundle n'est pas recommandé pour le traitement de texte, les conférences audio et vidéo, le partage d'écran, les outils de développement logiciel, les applications d'informatique décisionnelle et les applications graphiques. ## Offre Standard Ce bundle convient parfaitement aux activités suivantes : + Édition de texte et saisie de données de base + Navigation sur le Web + Messagerie instantanée + E-mails Ce bundle n'est pas recommandé pour les conférences audio et vidéo, le partage d'écran, le traitement de texte, les outils de développement logiciel, les applications d'informatique décisionnelle et les applications graphiques ## Offre Performance Ce bundle convient parfaitement aux activités suivantes : + Navigation sur le Web + Traitement de texte + Messagerie instantanée + E-mails + Feuilles de calcul + Traitement audio + Didacticiels Ce bundle n'est pas recommandé pour les visioconférences, le partage d'écran, les outils de développement logiciel, les applications d'informatique décisionnelle et les applications graphiques ## Offre Power Ce bundle convient parfaitement aux activités suivantes : + Navigation sur le Web + Traitement de texte + E-mails + Messagerie instantanée + Feuilles de calcul + Traitement audio + Développement logiciel (environnement de développement intégré (IDE)) + Traitement des données de niveau basique à intermédiaire + Conférences audio et vidéo Ce bundle n'est pas recommandé pour le partage d'écran, les outils de développement logiciel, les applications d'informatique décisionnelle et les applications graphiques. ## PowerPro offre groupée Ce bundle convient parfaitement aux activités suivantes : + Navigation sur le Web + Traitement de texte + E-mails + Messagerie instantanée + Feuilles de calcul + Traitement audio + Développement logiciel (environnement de développement intégré (IDE)) + Entreposage de données + Applications d'informatique décisionnelle + Conférences audio et vidéo Ce bundle n'est pas recommandé pour le machine learning (ML), la formation de modèles et les applications graphiques. ## Offre Graphics.g4dn Cet ensemble offre un haut niveau de performances graphiques, un niveau modéré de performances du processeur et de mémoire pour votre WorkSpaces ordinateur. Il est parfaitement adapté aux applications suivantes : + Navigation sur le Web + Traitement de texte + E-mails + Feuilles de calcul + Messagerie instantanée + Conférence audio + Développement logiciel (environnement de développement intégré (IDE)) + Traitement des données de niveau basique à intermédiaire + Entreposage de données + Applications d'informatique décisionnelle + Conception graphique + CAD/CAM (computer-aided design/computer-fabrication assistée) Ce bundle n'est pas recommandé pour les conférences audio et vidéo, le rendu 3D, la conception photoréaliste et la formation de modèles de machine learning. ## GraphicsProEnsemble .g4dn Cet ensemble offre un haut niveau de performances graphiques, de performances du processeur et de mémoire pour votre WorkSpaces ordinateur et convient parfaitement aux applications suivantes : + Navigation sur le Web + Traitement de texte + E-mails + Feuilles de calcul + Messagerie instantanée + Conférence audio + Développement logiciel (environnement de développement intégré (IDE)) + Traitement des données de niveau basique à intermédiaire + Entreposage de données + Applications d'informatique décisionnelle + Conception graphique + CAD/CAM (computer-aided design/computer-fabrication assistée) + Transcodage vidéo + Rendu 3D + Conception photoréaliste + Streaming de jeux + Formation de modèles de machine learning (ML) et inférence de ML Ce bundle n'est pas recommandé pour les conférences audio et vidéo. # Création d'une image personnalisée et d'un bundle pour WorkSpaces Pools WorkSpaces Le pool prend uniquement en charge les images et les ensembles Windows. Si vous avez lancé un Windows ou WorkSpace que vous l'avez personnalisé, vous pouvez créer une image personnalisée et des ensembles personnalisés à partir de celui-ci WorkSpace. Une *image personnalisée* contient uniquement le système d'exploitation, le logiciel et les paramètres du WorkSpace. Un *bundle personnalisé* est une combinaison de cette image personnalisée et du matériel à partir duquel il WorkSpace peut être lancé. Après avoir créé une image personnalisée, vous pouvez créer un bundle personnalisé qui combine l'image personnalisée et la configuration de calcul et de stockage sous-jacente que vous sélectionnez. Vous pouvez ensuite spécifier ce bundle personnalisé lorsque vous lancez un nouveau bundle WorkSpaces pour vous assurer que le nouveau WorkSpaces possède la même configuration cohérente (matérielle et logicielle). Vous pouvez utiliser la même image personnalisée pour créer différents lots personnalisés en sélectionnant différentes options de calcul et de stockage pour chaque lot. **Important** Les volumes de stockage groupés personnalisés ne peuvent pas être inférieurs aux volumes de stockage d'images. Les offres groupées personnalisées coûtent le même prix que les offres groupées publiques à partir desquelles elles sont créées. Pour plus d'informations sur les tarifs, consultez [Amazon WorkSpaces Pricing](https://aws.amazon.com/workspaces/pricing/). **Topics** + [Conditions requises pour créer des images personnalisées Windows](#pools-windows_custom_image_requirements) + [Bonnes pratiques](#pools-custom_image_best_practices) + [Étape 1 : Exécuter l'outil de vérification d'image](#pools-run_image_checker) + [Étape 2 : Création d'une image personnalisée et d'un bundle personnalisé](#pools-create_custom_image_bundle) + [Ce qui est inclus dans les images WorkSpaces personnalisées Windows](#pools-image_creation_windows) ## Conditions requises pour créer des images personnalisées Windows **Note** Windows définit actuellement 1 Go comme 1 073 741 824 octets. Vous devez vous assurer qu'ils disposent de plus de 12 884 901 888 octets (ou 12 Go) libres sur le lecteur C et que le profil utilisateur est inférieur à 10 737 418 240 octets (ou 10 Go) pour créer une image d'un. WorkSpace + Le statut du WorkSpace doit être **Disponible** et son état de modification doit être **Aucun**. + Toutes les applications et tous les profils utilisateur sur WorkSpaces les images doivent être compatibles avec Microsoft Sysprep. + Toutes les applications à inclure dans l'image doivent être installées sur le lecteur `C`. + Tous les services d'application exécutés sur le WorkSpace doivent utiliser un compte système local au lieu des informations d'identification de l'utilisateur du domaine. Par exemple, une installation de Microsoft SQL Server Express ne peut pas s'exécuter avec les informations d'identification d'un utilisateur de domaine. + Ils ne WorkSpace doivent pas être chiffrés. La création d'images à partir d'une image chiffrée n' WorkSpace est actuellement pas prise en charge. + Les composants suivants sont requis dans une image. Sans ces composants, le fichier WorkSpaces que vous lancez à partir de l'image ne fonctionnera pas correctement. Pour de plus amples informations, veuillez consulter [Composants de configuration et de service requis pour WorkSpaces Personal](required-service-components.md). + Windows PowerShell version 3.0 ou ultérieure + Services Bureau à distance + AWS Pilotes photovoltaïques + Gestion à distance Windows (WinRM) + Agents et pilotes Teradici PCo IP + Agents et pilotes STXHD + AWS et WorkSpaces certificats + Agent Skylight + WorkSpaces Les pools ne prennent en charge qu'une taille maximale de volume bundle/image racine de 200 Go. Lorsque vous créez une image personnalisée Windows, assurez-vous qu'elle est inférieure à la taille du volume racine de 200 Go. ## Bonnes pratiques Avant de créer une image à partir d'un WorkSpace, procédez comme suit : + Utilisez un VPC distinct, qui n'est pas connecté à votre environnement de production. + Déployez le WorkSpace dans un sous-réseau privé et utilisez une instance NAT pour le trafic sortant. + Utilisez un petit répertoire Simple AD. + Utilisez la plus petite taille de volume pour la source WorkSpace, puis ajustez-la selon vos besoins lors de la création du bundle personnalisé. + Installez toutes les mises à jour du système d'exploitation (à l'exception des mises à jour des fonctionnalités/versions de Windows) et toutes les mises à jour des applications sur le. WorkSpace + Supprimez les données mises en cache WorkSpace qui ne devraient pas être incluses dans le bundle (par exemple, l'historique du navigateur, les fichiers mis en cache et les cookies du navigateur). + Supprimez les paramètres de configuration WorkSpace qui ne devraient pas être inclus dans le bundle (par exemple, les profils de messagerie). + Basculez vers les paramètres d'adresse IP dynamique à l'aide de DHCP. + Assurez-vous de ne pas avoir dépassé votre quota d' WorkSpace images autorisées dans une région. Par défaut, vous êtes autorisé à 40 WorkSpace images par région. Si vous avez atteint ce quota, les nouvelles tentatives de création d'une image échoueront. Pour demander une augmentation de quota, utilisez le formulaire [Limites WorkSpaces ](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=workspaces). + Assurez-vous que vous n'essayez pas de créer une image à partir d'une image chiffrée WorkSpace. La création d'images à partir d'une image chiffrée n' WorkSpace est actuellement pas prise en charge. + Si vous utilisez un logiciel antivirus sur le WorkSpace, désactivez-le pendant que vous essayez de créer une image. + Si un pare-feu est activé sur votre WorkSpace ordinateur, assurez-vous qu'il ne bloque aucun port nécessaire. Pour de plus amples informations, veuillez consulter [Exigences relatives à l'adresse IP et au port pour WorkSpaces Personal](workspaces-port-requirements.md). + Pour Windows WorkSpaces, ne configurez aucun objet de stratégie de groupe (GPOs) avant la création de l'image. + Pour Windows WorkSpaces, ne personnalisez pas le profil utilisateur par défaut (`C:\Users\Default`) avant de créer une image. Nous vous recommandons d'apporter des personnalisations au GPOs profil utilisateur et de les appliquer après la création de l'image. GPOs peuvent être facilement modifiés ou annulés, et sont donc moins sujets aux erreurs que les personnalisations apportées au profil utilisateur par défaut. + Assurez-vous de mettre à jour les pilotes de dépendance réseau tels que les pilotes ENA et PV de votre WorkSpaces. NVMe Vous devez le faire au moins une fois tous les 6 mois. Pour plus d'informations, voir [Installer ou mettre à niveau le pilote Elastic Network Adapter (ENA)](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/enhanced-networking-ena.html#ena-adapter-driver-install-upgrade-win), [Pilotes NVMe AWS pour les instances Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/aws-nvme-drivers.html), et [Mettre à niveau les pilotes PV sur les instances Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html). + Assurez-vous de mettre régulièrement à jour les agents EC2 Config, EC2 EC2 Launch et Launch V2 vers les dernières versions. Vous devez le faire au moins une fois tous les 6 mois. Pour plus d'informations, consultez [Update EC2 Config and EC2 Launch](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/migrating-latest-types.html#upgdate-ec2config-ec2launch). ## Étape 1 : Exécuter l'outil de vérification d'image Pour vérifier que votre Windows WorkSpace répond aux exigences relatives à la création d'images, nous vous recommandons d'exécuter l'application Image Checker. Le vérificateur d'images effectue une série de tests sur le produit WorkSpace que vous souhaitez utiliser pour créer votre image et fournit des conseils sur la manière de résoudre les problèmes détectés. Le vérificateur d'images n'est disponible que pour Windows WorkSpaces. **Important** Vous WorkSpace devez réussir tous les tests effectués par le vérificateur d'images avant de pouvoir l'utiliser pour créer une image. Avant d'exécuter le vérificateur d'images, vérifiez que les dernières mises à jour de sécurité et cumulatives de Windows sont installées sur votre WorkSpace. Pour obtenir l'outil de vérification d'image, effectuez l'une des opérations suivantes : + [Redémarrez votre WorkSpace](reboot-workspaces.md). L'outil de vérification d'image est téléchargé automatiquement pendant le redémarrage et installé à l'emplacement `C:\Program Files\Amazon\ImageChecker.exe`. + Téléchargez Amazon WorkSpaces Image Checker depuis [https://tools.amazonworkspaces.comImageChecker/.zip ](https://tools.amazonworkspaces.com/ImageChecker.zip) et extrayez le fichier. `ImageChecker.exe` Copiez ce fichier dans `C:\Program Files\Amazon\`. **Pour exécuter le l'outil de vérification d'image** 1. Ouvrez le fichier `C:\Program Files\Amazon\ImageChecker.exe`. 1. Dans la boîte de dialogue **Amazon WorkSpaces Image Checker**, choisissez **Run**. 1. Lorsqu'un test est terminé, vous pouvez en afficher le statut. Si un test affiche le statut **FAILED (ÉCHEC)**, choisissez **Info (Informations)** pour afficher de plus amples informations sur la manière de résoudre le problème qui a provoqué l'échec. Pour de plus amples informations sur la résolution de ces problèmes, veuillez consulter [Conseils pour résoudre les problèmes détectés par l'outil de vérification d'image](#pools-image_checker_tips). Si des tests affichent le statut **WARNING (AVERTISSEMENT)**, choisissez le bouton **Fix all Warnings (Corriger tous les avertissements)**. L'outil génère un fichier journal de sortie dans le répertoire où se trouve l'outil de vérification d'image. Par défaut, ce fichier est situé à l'emplacement suivant : `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`. Ne supprimez pas ce fichier journal. Si un problème se produit, ce fichier journal peut être utile pour le résoudre. 1. Le cas échéant, résolvez les problèmes à l'origine d'échecs et d'avertissements, et répétez le processus d'exécution du vérificateur d'images jusqu'à ce qu'il WorkSpace réussisse tous les tests. Tous les échecs et avertissements doivent être résolus pour pouvoir créer une image. 1. Une fois que vous WorkSpace avez réussi tous les tests, le message « **Validation réussie** » s'affiche. Vous êtes maintenant prêt pour créer un bundle personnalisé. ### Conseils pour résoudre les problèmes détectés par l'outil de vérification d'image En plus de consulter les conseils suivants pour résoudre les problèmes détectés par l'outil de vérification d'image, assurez-vous de consulter le fichier journal de l'outil de vérification d'image à l'adresse `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log`. #### PowerShell la version 3.0 ou ultérieure doit être installée Installez la dernière version de [Microsoft Windows PowerShell](https://docs.microsoft.com/powershell). **Important** La politique PowerShell d'exécution d'un WorkSpace doit être définie pour autoriser **RemoteSigned**les scripts. Pour vérifier la politique d'exécution, exécutez la ExecutionPolicy PowerShell commande **Get-**. Si la politique d'exécution n'est pas définie sur **Unrestricted **RemoteSigned****, exécutez la ExecutionPolicy RemoteSigned commande **Set- ExecutionPolicy —** pour modifier la valeur de la politique d'exécution. Ce **RemoteSigned**paramètre permet l'exécution de scripts sur Amazon WorkSpaces, ce qui est nécessaire pour créer une image. #### Seuls les lecteurs C et D peuvent être présents Seuls les `D` lecteurs `C` et peuvent être présents sur un WorkSpace disque utilisé pour l'imagerie. Retirez tous les autres lecteurs, y compris les lecteurs virtuels. #### Aucun redémarrage en attente dans le cadre de mises à jour Windows ne peut être détecté + Le processus de création d'image ne peut pas être exécuté tant que Windows n'a pas été redémarré pour terminer l'installation des mises à jour de sécurité ou cumulatives. Redémarrez Windows pour appliquer ces mises à jour et assurez-vous qu'aucune autre mise à jour cumulative ou de sécurité Windows en attente ne doit être installée. + La création d'images n'est pas prise en charge sur les systèmes Windows 10 qui ont été mis à niveau d'une version de Windows 10 vers une version plus récente de Windows 10 ( feature/version mise à niveau de Windows). Toutefois, les mises à jour cumulatives ou de sécurité de Windows sont prises en charge par le processus de WorkSpaces création d'images. #### Le fichier Sysprep doit exister et ne peut pas être vide En cas de problème avec votre fichier Sysprep, contactez le [AWS Support Centre](https://console.aws.amazon.com/support/home#/) pour faire réparer votre EC2 Config ou EC2 Launch. #### La taille du profil utilisateur doit être inférieure à 10 Go Pour Windows 7 WorkSpaces, le profil utilisateur (`D:\Users\username`) doit être inférieur à 10 Go au total. Pour réduire la taille du profil utilisateur, supprimez des fichiers. #### Le lecteur C doit avoir suffisamment d'espace libre Pour Windows 7 WorkSpaces, vous devez disposer d'au moins 12 Go d'espace libre sur le disque`C`. Pour libérer de l'espace sur le lecteur `C`, supprimez des fichiers. Pour Windows 10 WorkSpaces, ignorez si vous recevez un `FAILED` message et que l'espace disque est supérieur à 2 Go. #### Aucun service ne peut être exécuté sous un compte de domaine Pour exécuter le processus de création d'image, aucun service ne WorkSpace peut être exécuté sous un compte de domaine. Tous les services doivent être exécutés sous un compte local. **Pour exécuter des services sous un compte local** 1. Ouvrez `C:\Program Files\Amazon\ImageChecker_yyyyMMddhhmmss.log` et recherchez la liste des services qui s'exécutent sous un compte de domaine. 1. Dans la zone de recherche Windows, entrez **services.msc** pour ouvrir le Gestionnaire des services Windows. 1. Sous **Ouvrir une session en tant que**, recherchez les services qui s'exécutent sous des comptes de domaine. (Les services s'exécutant en tant que **Système local**, **Service local**, ou **Service réseau** n'interfèrent pas avec la création d'image.) 1. Sélectionnez un service qui s'exécute sous un compte de domaine, puis choisissez **Action**, **Propriétés**. 1. Ouvrez l'onglet **Ouvrir une session**. Sous **Ouvrir une session en tant que**, choisissez **Compte système local**. 1. Choisissez **OK**. #### Le WorkSpace doit être configuré pour utiliser le DHCP Vous devez configurer tous les adaptateurs réseau de manière WorkSpace à utiliser le DHCP au lieu d'adresses IP statiques. **Pour configurer toutes les cartes réseau afin qu'elles utilisent DHCP** 1. Dans la zone de recherche Windows, entrez **control panel** pour ouvrir le Panneau de configuration. 1. Choisissez **Réseau et Internet**. 1. Choisissez **Centre Réseau et partage**. 1. Choisissez **Modifier les paramètres de la carte**, puis sélectionnez une carte. 1. Choisissez **Modifier les paramètres de cette connexion**. 1. **Dans l'onglet **Réseau**, sélectionnez **Internet Protocol version 4 (TCP/IPv4)**, puis choisissez Propriétés.** 1. Dans la boîte de dialogue **Propriétés du protocole Internet version 4 (TCP/IPv4)**, sélectionnez **Obtenir une adresse IP automatiquement**. 1. Choisissez **OK**. 1. Répétez cette procédure pour tous les adaptateurs réseau du WorkSpace. #### Les services Bureau à distance doivent être activés Le processus de création d'image nécessite l'activation des services Bureau à distance. **Pour activer les services Bureau à distance** 1. Dans la zone de recherche Windows, entrez **services.msc** pour ouvrir le Gestionnaire des services Windows. 1. Dans la colonne **Nom** recherchez **Services Bureau à distance**. 1. Sélectionnez **Services Bureau à distance**, puis choisissez **Action**, **Propriétés**. 1. Sous l'onglet **Général** pour **Type de démarrage**, choisissez **Manuel** ou **Automatique**. 1. Choisissez **OK**. #### Un profil utilisateur doit exister Le WorkSpace fichier que vous utilisez pour créer des images doit avoir un profil utilisateur (`D:\Users\username`). Si ce test échoue, contactez le [Centre AWS Support](https://console.aws.amazon.com/support/home#/) pour obtenir de l'aide. #### Le chemin d'accès de la variable d'environnement doit être correctement configuré Le chemin de la variable d'environnement pour la machine locale ne contient pas d'entrées pour System32 et pour Windows PowerShell. Ces entrées sont requises pour l'exécution du processus de création d'image. **Pour configurer le chemin d'accès de votre variable d'environnement** 1. Dans la zone de recherche Windows, entrez **environment variables** et choisissez **Modifier les variables d'environnement système**. 1. Dans la boîte de dialogue **Propriétés système** ouvrez l'onglet **Avancé** et choisissez **Variables d'environnement**. 1. Dans la boîte de dialogue **Variables d'environnement** sous **Variables système**, sélectionnez l'entrée **Chemin** puis choisissez **Modifier**. 1. Choisissez **Nouveau**, puis ajoutez le chemin d'accès suivant : `C:\Windows\System32` 1. Choisissez de nouveau **Nouveau** puis ajoutez le chemin suivant : `C:\Windows\System32\WindowsPowerShell\v1.0\` 1. Choisissez **OK**. 1. Redémarrez le WorkSpace. **Astuce** L'ordre dans lequel les éléments apparaissent dans le chemin de la variable d'environnement est important. Pour déterminer l'ordre correct, vous pouvez comparer le chemin de votre variable d'environnement WorkSpace avec celui d'une instance Windows nouvellement créée WorkSpace ou nouvelle. #### Le programme d'installation pour les modules Windows doit être activé Le processus de création d'image nécessite l'activation du service Programme d'installation pour les modules Windows. **Pour activer le service Programme d'installation pour les modules Windows** 1. Dans la zone de recherche Windows, entrez **services.msc** pour ouvrir le Gestionnaire des services Windows. 1. Dans la colonne **Nom** recherchez le **Programme d'installation pour les modules Windows**. 1. Sélectionnez le **Programme d'installation pour les modules Windows**, puis choisissez **Action**, **Propriétés**. 1. Sous l'onglet **Général** pour **Type de démarrage**, choisissez **Manuel** ou **Automatique**. 1. Choisissez **OK**. #### L'agent Amazon SSM doit être désactivé Le processus de création d'image nécessite la désactivation du service Amazon SSM Agent. **Pour désactiver le service Amazon SSM Agent** 1. Dans la zone de recherche Windows, entrez **services.msc** pour ouvrir le Gestionnaire des services Windows. 1. Dans la colonne **Nom** recherchez **Amazon SSM Agent**. 1. Sélectionnez **Agent Amazon SSM**, puis choisissez **Action**, **Propriétés**. 1. Sous l'onglet **Général** pour **Type de démarrage**, choisissez **Désactivé**. 1. Choisissez **OK**. #### SSL3 et la version 1.2 du protocole TLS doit être activée Pour configurer SSL/TLS pour Windows, consultez la section [Comment activer le protocole TLS 1.2](https://docs.microsoft.com/configmgr/core/plan-design/security/enable-tls-1-2) dans la documentation Microsoft Windows. #### Il ne peut y avoir qu'un seul profil d'utilisateur sur le WorkSpace Il ne peut y avoir qu'un seul profil WorkSpaces utilisateur (`D:\Users\username`) WorkSpace que vous utilisez pour créer des images. Supprimez tous les profils utilisateur qui n'appartiennent pas à l'utilisateur prévu du WorkSpace. Pour que la création d'images fonctionne, vous ne WorkSpace pouvez avoir que trois profils utilisateur : + Le profil utilisateur de l'utilisateur auquel le WorkSpace (`D:\Users\username`) est destiné + Le profil utilisateur par défaut (également connu sous le nom de Profil par défaut) + Le profil utilisateur Administrateur Si d'autres profils utilisateur sont présents, vous pouvez les supprimer via les propriétés système avancées du Panneau de configuration Windows. **Pour supprimer un profil utilisateur** 1. Pour accéder aux propriétés système avancées, effectuez l'une des opérations suivantes : + Appuyez sur **les touches Windows\$1pause/arrêt**, puis choisissez **Paramètres système avancés** dans le volet gauche de la boîte de dialogue **Panneau de configuration** > **Système et sécurité** > **Système**. + Dans la zone de recherche Windows, entrez **control panel**. Dans le Panneau de configuration, choisissez **Système et sécurité**, puis Système, puis **Paramètres système avancés** dans le volet gauche de la boîte de dialogue **Panneau de configuration** > **Système et sécurité** > **Système**. 1. Dans la boîte de dialogue **Propriétés système** sous l'onglet **Avancé** choisissez **Paramètres** sous **Profils utilisateur**. 1. Si un profil autre que le profil administrateur, le profil par défaut et le profil de l' WorkSpacesutilisateur prévu est répertorié, sélectionnez ce profil supplémentaire et choisissez **Supprimer**. 1. À la question sur la suppression du profil, choisissez **Oui**. 1. Si nécessaire, répétez les étapes 3 et 4 pour supprimer tout autre profil n'appartenant pas au WorkSpace. 1. Cliquez deux fois sur **OK** et fermez le Panneau de configuration. 1. Redémarrez le WorkSpace. #### Aucun package AppX ne peut être dans un état intermédiaire Un ou plusieurs packages AppX sont dans un état intermédiaire. Cela peut provoquer une erreur Sysprep lors de la création d'image. **Pour supprimer tous les packages AppX intermédiaires** 1. Dans la zone de recherche Windows, entrez **powershell**. Choisissez **Exécuter en tant qu'administrateur**. 1. À la question « Voulez-vous autoriser cette application à apporter des modifications à votre appareil ? », choisissez **Oui**. 1. Dans la PowerShell fenêtre Windows, entrez les commandes suivantes pour répertorier tous les packages AppX préparés, puis appuyez sur Entrée après chacun d'eux. ``` $workSpaceUserName = $env:username ``` ``` $allAppxPackages = Get-AppxPackage -AllUsers ``` ``` $packages = $allAppxPackages | Where-Object { ` (($_.PackageUserInformation -like "*S-1-5-18*" -and !($_.PackageUserInformation -like "*$workSpaceUserName*")) -and ` ($_.PackageUserInformation -like "*Staged*" -or $_.PackageUserInformation -like "*Installed*")) -or ` ((!($_.PackageUserInformation -like "*S-1-5-18*") -and $_.PackageUserInformation -like "*$workSpaceUserName*") -and ` $_.PackageUserInformation -like "*Staged*") } ``` 1. Exécutez la commande suivante avec des privilèges SYSTEM élevés pour supprimer toutes les entrées de provisionnement de packages AppX intermédiaires, puis appuyez sur Entrée. ``` $packages | Remove-AppxPackage -ErrorAction SilentlyContinue ``` 1. Exécutez de nouveau l'outil de vérification d'image. Si ce test échoue toujours, entrez les commandes suivantes pour supprimer tous les packages AppX et appuyez sur Entrée après chaque package. ``` Get-AppxProvisionedPackage -Online | Remove-AppxProvisionedPackage -Online -ErrorAction SilentlyContinue ``` ``` Get-AppxPackage -AllUsers | Remove-AppxPackage -ErrorAction SilentlyContinue ``` #### Windows ne doit pas avoir été mis à niveau à partir d'une version précédente La création d'images n'est pas prise en charge sur les systèmes Windows qui ont été mis à niveau d'une version de Windows 10 vers une version plus récente de Windows 10 ( feature/version mise à niveau de Windows). Pour créer des images, utilisez une image WorkSpace qui n'a pas subi de feature/version mise à niveau vers Windows. #### Le nombre de réinitialisations Windows ne doit pas être nul La fonction de réinitialisation vous permet de prolonger la période d'activation de la version d'évaluation de Windows. Le processus de création d'image nécessite que la valeur du nombre de réinitialisations soit différente de 0. **Pour vérifier le nombre de réinitialisations Windows** 1. Dans le menu **Démarrer** de Windows, choisissez **Système Windows**, puis **Invite de commandes**. 1. À l'invite de commande, saisissez la commande suivante, puis appuyez sur Entrée. `cscript C:\Windows\System32\slmgr.vbs /dlv` Pour réinitialiser le nombre de réinitialisations à une valeur différente de 0, veuillez consulter [ Sysprep (Generalize) a Windows installation](https://docs.microsoft.com/windows-hardware/manufacture/desktop/sysprep--generalize--a-windows-installation) dans la documentation Microsoft Windows. #### Autres conseils pour la résolution des problèmes Si vous WorkSpace réussissez tous les tests effectués par le vérificateur d'images, mais que vous ne parvenez toujours pas à créer une image à partir du WorkSpace, vérifiez les problèmes suivants : + Assurez-vous que le WorkSpace n'est pas attribué à un utilisateur au sein d'un groupe d'**invités du domaine**. Pour vérifier s'il existe des comptes de domaine, exécutez la PowerShell commande suivante. ``` Get-WmiObject -Class Win32_Service | Where-Object { $_.StartName -like "*$env:USERDOMAIN*" } ``` + Certains objets de stratégie de groupe (GPOs) limitent l'accès à l'empreinte numérique du certificat RDP lorsque celui-ci est demandé par le service EC2 Config ou les scripts de EC2 lancement lors de la configuration de l'instance Windows. Avant d'essayer de créer une image, déplacez-la WorkSpace vers une nouvelle unité organisationnelle (UO) dont l'héritage est bloqué et non GPOs appliqué. + Assurez-vous que le service Gestion à distance de Windows (WinRM) est configuré de manière à démarrer automatiquement. Procédez comme suit : 1. Dans la zone de recherche Windows, entrez `services.msc` pour ouvrir le Gestionnaire des services Windows. 1. Dans la colonne **Nom** recherchez **Gestion à distance de Windows (Gestion WSM)**. 1. Sélectionnez **Gestion à distance de Windows (Gestion WSM)**, puis choisissez **Action**, **Propriétés**. 1. Sous l'onglet **Général** pour **Type de démarrage**, choisissez **Automatique**. 1. Choisissez **OK**. ## Étape 2 : Création d'une image personnalisée et d'un bundle personnalisé Après avoir validé votre WorkSpace image, suivez la procédure suivante pour créer votre image personnalisée et votre bundle personnalisé à l'aide de la WorkSpaces console. Pour créer une image par programmation, utilisez l'action CreateWorkspaceImage API. Pour plus d'informations, consultez [ CreateWorkspaceImage](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceImage.html)le *Amazon WorkSpaces API Reference*. Pour créer un bundle par programmation, utilisez l'action d'API **CreateWorkspaceBundle**. Pour plus d'informations, consultez [ CreateWorkspaceBundle](https://docs.aws.amazon.com/workspaces/latest/api/API_CreateWorkspaceBundle.html)le *Amazon WorkSpaces API Reference*. **Pour créer une image personnalisée et un bundle personnalisé à l'aide de la WorkSpaces console** 1. Si vous êtes toujours connecté au WorkSpace, déconnectez-vous en choisissant **Amazon WorkSpaces** et **Disconnect** dans l'application WorkSpaces cliente. 1. Ouvrez la WorkSpaces console sur [https://console.aws.amazon.com/workspaces/v2/home](https://console.aws.amazon.com/workspaces/v2/home). 1. Dans le panneau de navigation, sélectionnez **WorkSpaces**. 1. Sélectionnez le WorkSpace pour ouvrir sa page de détails, puis choisissez **Créer une image**. Si le statut du WorkSpace est **Arrêté**, vous devez d'abord le démarrer (choisissez **Actions**, **Démarrer WorkSpaces**) avant de choisir **Actions**, **Créer une image**. 1. Un message s'affiche, vous invitant à redémarrer (redémarrer) votre ordinateur WorkSpace avant de continuer. Le redémarrage WorkSpace met à jour votre WorkSpaces logiciel Amazon vers la dernière version. Redémarrez votre ordinateur WorkSpace en fermant le message et en suivant les étapes indiquées[Redémarrer un WorkSpace dans WorkSpaces Personal](reboot-workspaces.md). Lorsque vous avez terminé, répétez l'étape [Step 4](create-custom-bundle.md#step_create_image) de cette procédure, mais cette fois choisissez **Suivant** lorsque le message de redémarrage apparaît. Pour créer une image, le statut de WorkSpace doit être **Disponible** et son état de modification doit être **Aucun**. 1. Saisissez un nom et une description pour l'image qui vous permettront de l'identifier, puis choisissez **Create Image (Créer une image)**. Pendant la création de l'image, le statut du WorkSpace est **Suspendu** et n' WorkSpace est pas disponible. N'utilisez pas de caractère spécial tiret (`-`) dans la description. Cela provoquera une erreur. 1. Dans le volet de navigation, choisissez **Images**. L'image est complète lorsque le statut WorkSpace passe à **Disponible** (cela peut prendre jusqu'à 45 minutes). 1. Sélectionnez l'image et choisissez **Actions**, **Créer un bundle**. 1. Saisissez un nom et une description pour le bundle, puis effectuez les opérations suivantes : + Pour **le type de matériel du bundle**, choisissez le matériel à utiliser lors WorkSpaces du lancement à partir de ce bundle personnalisé. + Les combinaisons de tailles disponibles par défaut pour le volume racine sont de 200 Go par volume WorkSpace. 1. Pour confirmer que votre bundle est créé, choisissez **Bundles**, et vérifiez qu'il est répertorié. ## Ce qui est inclus dans les images WorkSpaces personnalisées Windows Lorsque vous créez une image à partir d'un système Windows WorkSpace, tout le contenu du `C` lecteur est inclus. + Contacts + Téléchargements + Musique + Images + Jeux enregistrés + Vidéos + Podcasts + Machines virtuelles + .virtualbox + Suivi + appdata\$1local\$1temp + appdata\$1roaming\$1apple computer\$1mobilesync\$1 + appdata\$1roaming\$1apple computer\$1logs\$1 + appdata\$1roaming\$1apple computer\$1itunes\$1iphone software updates\$1 + appdata\$1roaming\$1macromedia\$1flash player\$1macromedia.com\$1support\$1flashplayer\$1sys\$1 + appdata\$1roaming\$1macromedia\$1flash player\$1\$1sharedobjects\$1 + appdata\$1roaming\$1adobe\$1flash player\$1assetcache\$1 + appdata\$1roaming\$1microsoft\$1windows\$1recent\$1 + appdata\$1roaming\$1microsoft\$1office\$1recent\$1 + appdata\$1roaming\$1microsoft office\$1live meeting + appdata\$1roaming\$1microsoft shared\$1livemeeting shared\$1 + appdata\$1roaming\$1mozilla\$1firefox\$1crash reports\$1 + appdata\$1roaming\$1mcafee\$1common framework\$1 + appdata\$1local\$1microsoft\$1feeds cache + appdata\$1local\$1microsoft\$1windows\$1temporary internet files\$1 + appdata\$1local\$1microsoft\$1windows\$1history\$1 + appdata\$1local\$1microsoft\$1internet explorer\$1domstore\$1 + appdata\$1local\$1microsoft\$1internet explorer\$1imagestore\$1 + appdata\$1locallow\$1microsoft\$1internet explorer\$1iconcache\$1 + appdata\$1locallow\$1microsoft\$1internet explorer\$1domstore\$1 + appdata\$1locallow\$1microsoft\$1internet explorer\$1imagestore\$1 + appdata\$1local\$1microsoft\$1internet explorer\$1recovery\$1 + appdata\$1local\$1mozilla\$1firefox\$1profiles\$1 # Gérez des images et des ensembles personnalisés pour les pools WorkSpaces Le processus de gestion des images et des ensembles personnalisés est le même entre WorkSpaces Personal et WorkSpaces Pool. Pour plus d'informations sur la gestion des images et des ensembles, consultez la documentation suivante dans la section WorkSpaces Personnel de ce guide : **Note** La principale différence entre les packs personnalisés que vous pouvez utiliser pour WorkSpaces Personal et ceux que vous pouvez utiliser pour WorkSpaces Pool réside dans le système d'exploitation et le bundle public de base qui peuvent être utilisés. Pour les systèmes d'exploitation et les ensembles pris en charge dans WorkSpaces Pool, consultez[ WorkSpaces Forfaits pour piscinesBundles En savoir plus sur les offres WorkSpaces groupées Pools. Un *WorkSpace bundle* est une combinaison d'un système d'exploitation et de ressources de stockage, de calcul et logicielles. Lorsque vous lancez un WorkSpace, vous sélectionnez le pack qui répond à vos besoins. Les offres groupées par défaut disponibles WorkSpaces sont appelées *offres groupées publiques*. Pour plus d'informations sur les différents forfaits publics disponibles WorkSpaces, consultez [Amazon WorkSpaces Bundles](https://aws.amazon.com/workspaces/details/#Amazon_WorkSpaces_Bundles). Le tableau suivant fournit des informations sur les licences, les protocoles de streaming et les offres groupées pris en charge par chaque système d'exploitation. | Système d’exploitation | Licences | Protocoles de streaming | Offres groupées prises en charge | | --- | --- | --- | --- | | Windows Server 2019 | Inclus | DCV | Valeur, norme, performance, puissance, PowerPro | | Windows Server 2022 | Inclus | DCV | Standard, performance, alimentation, carte PowerPro graphique.G4DN, .G4DN GraphicsPro | Les versions du système d'exploitation qui ne sont plus prises en charge par le fournisseur ne sont pas garanties de fonctionner et ne sont pas prises en charge par le AWS support. ](instance-types.md#instance-types.title). + [Mettre à jour un pack personnalisé pour WorkSpaces Personal](update-custom-bundle.md). + [Copier une image personnalisée dans WorkSpaces Personal](copy-custom-image.md). + [Partager ou annuler le partage d'une image personnalisée dans Personal WorkSpaces](share-custom-image.md). + [Supprimer un ensemble ou une image personnalisé dans WorkSpaces Personal](delete_bundle.md). # Utilisez des scripts de session pour gérer l'expérience de streaming de vos utilisateurs WorkSpaces Pool fournit 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 votre environnement WorkSpaces Pools 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 WorkSpace image. 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) + [Exécution de scripts une fois les sessions de streaming terminées](#run-scripts-after-streaming-sessions-end) + [Création et spécification de scripts de session](#create-specify-session-scripts) + [Fichier de configuration des scripts de session](#session-script-configuration-file) + [Utilisation de PowerShell fichiers Windows](#using-powershell-files-with-session-scripts) + [Journalisation de la sortie du script de session](#logging-session-output) + [Utiliser le stockage persistant avec des scripts de session](#use-storage-connectors-with-session-scripts) + [Activation du stockage des journaux de script de session dans un compartiment Amazon S3](#enable-S3-bucket-storage-session-script-logs) ## 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 WorkSpaces Pools 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:\\Scripts\\Myscript.bat ``` Si vous n'utilisez pas de double barre oblique inverse, un message d'erreur s'affiche pour vous informer que le `.json` fichier est mal 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 affiche le message d'erreur à l'attention de l'utilisateur. Lorsque vous exécutez des scripts avant le début des sessions de streaming, le processus suivant se produit : 1. Vos utilisateurs se connectent WorkSpace à un WorkSpaces pool qui n'est pas joint à un domaine. Ils se connectent à l'aide de SAML 2.0. 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 [Activez la persistance des paramètres de l'application pour les utilisateurs de vos WorkSpaces pools](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 [Activer et administrer le stockage persistant pour les WorkSpaces pools](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 [Utiliser le stockage persistant avec des scripts de session](#use-storage-connectors-with-session-scripts). 1. L’exécution de vos scripts de session est terminée ou expire. 1. La session de streaming des utilisateurs démarre. ## 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 du WorkSpaces client ou lorsqu'ils atteignent la durée maximale autorisée pour la session. Vous pouvez aussi utiliser ces scripts de session pour nettoyer votre environnement WorkSpaces avant que la session de streaming se termine. 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 : 1. La session de WorkSpaces streaming 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. Le WorkSpace est terminé. ## Création et spécification de scripts de session Suivez la procédure ci-dessous pour créer et spécifier des scripts de session pour votre WorkSpaces compte dans un WorkSpaces pool. 1. Connectez-vous à la fenêtre WorkSpaces à partir de laquelle vous créez une image personnalisée. 1. Créez le répertoire `/AWSEUC/SessionScripts` s'il n'existe pas déjà. 1. Créez un fichier de configuration `/AWSEUC/SessionScripts/config.json` s'il n'existe pas déjà, à l'aide du [modèle de configuration de script de session](https://docs.aws.amazon.com/workspaces/latest/adminguide/pools-images-session-scripts.html#session-script-configuration-file). 1. Accédez à `C:\AWSEUC\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). 1. Une fois que vous avez terminé d’effectuer vos modifications, enregistrez puis fermez le fichier `config.json`. 1. Suivez les étapes pour créer une image à partir du WorkSpace. Pour de plus amples informations, veuillez consulter [Création d'une image personnalisée et d'un bundle pour WorkSpaces Pools](pools-images-custom-image.md). ## Fichier de configuration des scripts de session Pour localiser le fichier de configuration des scripts de session dans une instance Windows, accédez à`C:\AWSEUC\SessionScripts\config.json`. Le format du fichier est le suivant. **Note** Le fichier de configuration est au format JSON. Vérifiez que 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). **`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 Pool 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. ## Utiliser le stockage persistant avec des scripts de session Lorsque le stockage WorkSpaces persistant est activé, le stockage commence à monter lorsque les scripts de démarrage de session s'exécutent. Si votre script repose sur le montage d'un stockage persistant, vous pouvez attendre que les connecteurs soient disponibles. WorkSpaces conserve l'état de montage des connecteurs de stockage dans le registre Windows sous Windows WorkSpaces, à l'aide de la clé suivante : ``` HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\AWSEUC\Storage\\ ``` 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 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é | ## 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 Pool 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 Pool crée un compartiment dans votre compte qui est unique à 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 WorkSpaces service. 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 : ``` wspool-logs---random-identifier ``` **``** Il s'agit du code de AWS région dans lequel le WorkSpaces pool est créé avec le stockage par compartiment Amazon S3 activé pour les journaux de script de session. **``** 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, `wspool-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`) sur le numéro de compte`123456789012`, WorkSpaces Pool crée un compartiment Amazon S3 au sein de votre compte dans cette région avec le nom affiché. Seul un administrateur disposant d’autorisations suffisantes peut supprimer ce compartiment. ``` wspool-logs-us-west-2-1234567890123-abcdefg ``` La désactivation des scripts de session ne supprime pas les fichiers journaux stockés 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 Pools ajoute une politique de compartiment qui empêche la suppression accidentelle du compartiment. 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 : ``` //////SessionScriptsLogs/ ``` ****** 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. ****** Le nom de la pile d'où est issue la session. ****** Nom du WorkSpaces pool sur lequel le script de session est exécuté. ****** La méthode d'identification de l'utilisateur : `custom` pour l' WorkSpaces API ou la CLI, `federated` pour SAML et `userpool` pour les utilisateurs du groupe d'utilisateurs. ****** 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. ****** L'identifiant de la session de streaming de l'utilisateur. Chaque session de streaming utilisateur génère un ID unique. ****** 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`) : ``` wspool-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.