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.
# Utiliser l’agent EC2Launch v2 pour effectuer des tâches lors du lancement d’une instance EC2 Windows
Toutes les instances prises en charge d'Amazon EC2 lancées à partir de AWS Windows Server 2022 et Windows Server 2025 AMIs incluent l'agent de EC2 lancement Launch v2 (`EC2Launch.exe`) par défaut. Nous fournissons également Windows Server 2016 et 2019 AMIs avec EC2 Launch v2 installé comme agent de lancement par défaut. Ils AMIs sont fournis en plus des versions Windows Server 2016 et 2019 AMIs qui incluent EC2 Launch v1. Vous pouvez rechercher des Windows AMIs qui incluent EC2 Launch v2 par défaut en saisissant le préfixe suivant dans votre recherche **AMIs**sur la page de la console Amazon EC2 :. `EC2LaunchV2-Windows_Server-*`
Pour comparer les caractéristiques des versions de l’agent de lancement, consultez [Comparez les agents EC2 de lancement Amazon](configure-launch-agents.md#ec2launch-agent-compare).
EC2Launch v2 exécute des tâches lors du démarrage de l'instance et s'exécute si une instance est arrêtée puis redémarrée ultérieurement, ou redémarrée. EC2Launch v2 peut également effectuer des tâches à la demande. Certaines de ces tâches sont automatiquement activées, alors que d’autres doivent être activées manuellement. Le service EC2 Launch v2 prend en charge toutes les fonctionnalités de EC2 configuration et de EC2 lancement.
Ce service utilise un fichier de configuration pour contrôler son fonctionnement. Vous pouvez mettre à jour le fichier de configuration à l’aide d’un outil graphique ou en le modifiant directement en tant que fichier .yml unique (`agent-config.yml`). Pour plus d’informations sur les emplacements des fichiers, consultez la section [EC2Lancer la structure du répertoire v2](#ec2launch-v2-directory).
EC2Launch v2 publie des journaux d'événements Windows pour vous aider à résoudre les erreurs et à définir des déclencheurs. Pour de plus amples informations, veuillez consulter [Journaux d’événements Windows](ec2launchv2-troubleshooting.md#ec2launchv2-windows-event-logs).
**Versions du système d’exploitation (OS) prises en charge**
L'agent EC2 Launch v2 prend en charge les versions suivantes du système d'exploitation Windows Server :
+ Windows Server 2025
+ Windows Server 2022
+ Windows Server 2019 (canal de maintenance à long terme et canal semestriel)
+ Windows Server 2016
**Tâches exécutées par défaut**
L'agent EC2 Launch v2 exécute les tâches suivantes une seule fois par défaut lors du lancement initial de l'instance. Les tâches sont organisées en fonction de l’ordre dans lequel elles s’exécutent pendant la phase de lancement.
Étape `Boot`
+ extendRootPartition
Étape `PreReady`
+ activateWindows
+ setDnsSuffix
+ setAdminAccount
+ setWallpaper
Étape `PostReady`
+ startSsm
## EC2Lancez les concepts de la v2
Il est utile de comprendre les concepts suivants lorsque vous envisagez de EC2 lancer Launch v2.
**configuration de l'agent**
`agent-config`est un fichier situé dans le dossier de configuration de EC2 Launch v2. Il inclut la configuration du démarragePreReady, du réseau et des PostReady stages. Ce fichier est utilisé pour spécifier la configuration de l’instance pour les tâches qui doivent s’exécuter lorsque l’AMI est démarrée pour la première fois ou pour les fois suivantes.
Par défaut, l'installation de EC2 Launch v2 installe un `agent-config` fichier qui inclut les configurations recommandées utilisées dans Amazon Windows AMIs standard. Vous pouvez mettre à jour le fichier de configuration pour modifier l'expérience de démarrage par défaut de votre AMI spécifiée par EC2 Launch v2. Pour plus d’informations sur les emplacements des fichiers, consultez la section [EC2Lancer la structure du répertoire v2](#ec2launch-v2-directory).
**Frequency (Fréquence)**
La fréquence des tâches détermine le moment où les tâches doivent être exécutées, en fonction du contexte de démarrage. La plupart des tâches n’ont qu’une seule fréquence autorisée. Vous pouvez spécifier une fréquence pour les tâches `executeScript`.
Vous verrez les fréquences suivantes dans la [EC2Configuration des tâches de lancement de la version 2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Une fois : la tâche s’exécute une fois, lorsque l’AMI démarre pour la première fois (Sysprep terminé).
+ Toujours : la tâche s’exécute chaque fois que l’agent de lancement s’exécute. L’agent de lancement s’exécute lorsque :
+ une instance démarre ou redémarre
+ le service EC2 Launch s'exécute
+ `EC2Launch.exe run` est invoqué
**Étape**
Une étape est un regroupement logique de tâches exécutées par l'agent EC2 Launch v2. Certaines tâches ne peuvent s’exécuter qu’à un stade spécifique. D’autres peuvent fonctionner en plusieurs étapes. Lors de l’utilisation de `agent-config.yml`, vous devez spécifier une liste d’étapes et une liste de tâches à exécuter au sein de chaque étape.
Le service exécute les étapes dans l’ordre suivant :
Étape 1 : Démarrage
Étape 2 : Réseau
Étape 3 : PreReady
Windows est prêt
Une fois l' PreReady étape terminée, le service envoie le `Windows is ready` message à la console Amazon EC2.
Étape 4 : PostReady
Les données utilisateur sont exécutées pendant la *PostReady*phase. Certaines versions de script s'exécutent avant le *PostReady*stade du `agent-config.yml` fichier, tandis que d'autres s'exécutent après, comme suit :
Avant `agent-config.yml`
+ Données utilisateur YAML version 1.1
+ Données utilisateur XML
Après `agent-config.yml`
+ Données utilisateur YAML version 1.0 (ancienne version pour la rétrocompatibilité)
Pour des exemples d’étapes et de tâches, consultez [Exemple : `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config).
Lorsque vous utilisez des données utilisateur, vous devez spécifier une liste de tâches que l’agent de lancement doit exécuter. L’étape est implicite. Pour des exemples de tâches, consultez [Exemple : données utilisateur](ec2launch-v2-settings.md#ec2launch-v2-example-user-data).
EC2Launch v2 exécute la liste des tâches dans l'ordre que vous spécifiez dans `agent-config.yml` et dans les données utilisateur. Les étapes s’exécutent de manière séquentielle. L’étape suivante commence lorsque l’étape précédente est terminée. Les tâches sont également exécutées de manière séquentielle.
**Tâche**
Vous pouvez invoquer une tâche pour effectuer une action sur une instance. Vous pouvez configurer les tâches dans le fichier `agent-config.yml` ou via les données utilisateur. Pour obtenir la liste des tâches disponibles pour EC2 Launch v2, voir [Tâches EC2 Launch v2](#ec2launch-v2-tasks). Pour le schéma de configuration des tâches et les détails, consultez [EC2Configuration des tâches de lancement de la version 2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
**Données de l’utilisateur**
Les données utilisateur sont des données configurables lorsque vous lancez une instance. Vous pouvez mettre à jour les données utilisateur pour modifier de manière dynamique le mode de configuration personnalisé AMIs ou de démarrage rapideAMIs . EC2Launch v2 prend en charge une longueur de saisie de données utilisateur de 60 kB. Les données utilisateur incluent uniquement l' UserData étape et s'exécutent donc après le `agent-config` fichier. Vous pouvez entrer des données utilisateur lorsque vous lancez une instance à l’aide de l’assistant de lancement d’instance, ou vous pouvez modifier les données utilisateur à partir de la console EC2. Pour plus d’informations sur l’utilisation des données d’utlisateur, consultez [Comment Amazon EC2 gère les données utilisateur pour les instances Windows](user-data.md#ec2-windows-user-data).
## EC2Présentation des tâches Launch v2
EC2Launch v2 peut effectuer les tâches suivantes à chaque démarrage :
+ Configurez un nouveau fond d’écran personnalisé qui rend des informations sur l’instance.
+ Définissez les attributs du compte d’administrateur créé sur la machine locale.
+ Ajoutez des suffixes DNS à la liste des suffixes de recherche. Seuls les suffixes qui n’existent pas déjà sont ajoutés à la liste.
+ Définissez les lettres de lecteur pour les volumes supplémentaires et étendez-les pour utiliser l’espace disponible.
+ Écrivez les fichiers de la configuration sur le disque.
+ Exécutez les scripts spécifiés dans le fichier de configuration de EC2 Launch v2 ou à partir de`user-data`. Les scripts provenant de `user-data` peuvent être en texte brut ou compressés et fournis au format base64.
+ Exécutez un programme avec des arguments donnés.
+ Définir le nom d’ordinateur
+ Envoyez des informations d’instance à la console Amazon EC2.
+ Envoyez l’empreinte numérique du certificat RDP à la console Amazon EC2.
+ Etendez de manière dynamique la partition du système d’exploitation pour inclure l’espace non partitionné.
+ Exécutez des données utilisateur. Pour plus d’informations sur la spécification de données utilisateur, consultez [EC2Configuration des tâches de lancement de la version 2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Définissez des routes non statiques permanentes pour atteindre le service de métadonnées et les serveurs AWS KMS .
+ Définissez les partitions autres que celles de démarrage sur `mbr` ou `gpt`.
+ Démarrez le service Systems Manager après Sysprep.
+ Optimisez les paramètres ENA.
+ Activez OpenSSH pour les versions ultérieures de Windows.
+ Activez les trames Jumbo.
+ Configurez Sysprep pour qu'il s'exécute avec EC2 Launch v2.
+ Publiez les journaux des événements Windows.
## EC2Lancer la structure du répertoire v2
EC2Launch v2 doit être installé dans les répertoires suivants :
+ Binaires de service : `%ProgramFiles%\Amazon\EC2Launch`
+ Données de service (paramètres, fichiers journaux et fichiers d’état) : `%ProgramData%\Amazon\EC2Launch`
**Note**
Par défaut, Windows masque les fichiers et les dossiers qui se trouvent sous `C:\ProgramData`. Pour afficher les répertoires et les fichiers de EC2 Launch v2, vous devez soit entrer le chemin dans l'Explorateur Windows, soit modifier les propriétés du dossier pour afficher les fichiers et dossiers cachés.
Le répertoire `%ProgramFiles%\Amazon\EC2Launch` contient des binaires et des bibliothèques de support. Il comprend les sous-répertoires suivants :
+ `settings`
+ `EC2LaunchSettingsUI.exe` : interface utilisateur pour modifier le fichier `agent-config.yml`
+ `YamlDotNet.dll` : DLL permettant de prendre en charge de certaines opérations dans l’interface utilisateur
+ `tools`
+ `ebsnvme-id.exe` : outil permettant d’examiner les métadonnées des volumes EBS sur l’instance
+ `AWSAcpiSpcrReader.exe` : outil permettant de déterminer le port COM correct à utiliser
+ `EC2LaunchEventMessage.dll`— DLL pour prendre en charge la journalisation des événements Windows pour EC2 Launch
+ `service`
+ `EC2LaunchService.exe` : exécutable de service Windows qui est lancé lorsque l’agent de lancement s’exécute en tant que service
+ `EC2AgentTelemetry.dll` : DLL permettant de prendre en charge la télémétrie des agents EC2
+ `EC2Launch.exe`— Exécutable EC2 de lancement principal
+ `EC2LaunchAgentAttribution.txt` : attribution pour le code utilisé dans EC2 Launch
Le répertoire `%ProgramData%\Amazon\EC2Launch` contient les sous-répertoires suivants. Toutes les données produites par le service, y compris les journaux, la configuration et l’état, sont stockées dans ce répertoire.
+ `config` – Configuration
Le fichier de configuration du service est stocké dans ce répertoire sous la forme de `agent-config.yml`. Ce fichier peut être mis à jour pour modifier, ajouter ou supprimer des tâches exécutées par le service par défaut. L’autorisation de créer des fichiers dans ce répertoire est limitée au compte administrateur pour empêcher l’escalade des privilèges.
+ `log` – Journaux d’instance
Les journaux du service (`agent.log`), des performances (`bench.log`) et de la télémétrie (`telemetry.log`) sont stockés dans ce répertoire. Lorsque `agent.log` sa taille atteint 1 Mo, il est automatiquement pivoté et un fichier de sauvegarde est créé au format d'horodatage (par exemple,). `agent-2026-03-02T18-56-39.188.log` Un seul fichier journal de sauvegarde est conservé à la fois.
+ `state` – Données sur l’état du service
L’état utilisé par le service pour déterminer les tâches à exécuter est stocké ici. Il existe un fichier `.run-once` qui indique si le service a déjà été exécuté après Sysprep (donc les tâches avec une fréquence d’une fois seront ignorées lors de la prochaine exécution). Ce sous-répertoire inclut un `state.json` et `previous-state.json` pour suivre l’état de chaque tâche.
+ `sysprep` – Sysprep
Ce répertoire contient des fichiers qui sont utilisés pour déterminer les opérations à effectuer par Sysprep lorsqu’il crée une AMI Windows personnalisée qui peut être réutilisée.
+ `wallpaper` – Fond d’écran
Les images de ce fond d’écran sont stockées dans ce répertoire.
## Télémétrie
La télémétrie est une information supplémentaire qui permet de mieux AWS comprendre vos besoins, de diagnostiquer les problèmes et de fournir des fonctionnalités pour améliorer votre expérience avec. Services AWS
EC2Lancez la version v2 `2.1.592` et collectez ultérieurement des données télémétriques, telles que les métriques d'utilisation et les erreurs. Ces données sont collectées à partir de l'instance Amazon EC2 sur laquelle EC2 Launch v2 s'exécute. Cela inclut tous les appareils Windows AMIs détenus par AWS.
Les types de télémétrie suivants sont collectés par EC2 Launch v2 :
+ **Usage information** (Informations d’utilisation) : commandes de l’agent, méthode d’installation et fréquence d’exécution planifiée.
+ **Erreurs et informations de diagnostic** — codes d’erreur d’installation de l’agent, codes d’erreur d’exécution et piles d’appels d’erreur.
Exemples de données collectées de la version 2.0.592 et à la version 2.1.1 :
```
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentCommandErrorCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentErrorLocation=addroutes.go:49
```
À partir de la version 2.2.63, les données de télémétrie de l’agent EC2 sont formatées sous forme d’objet JSON :
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
La télémétrie est activée par défaut. Vous pouvez désactiver la collecte de données de télémétrie à tout moment.
**Désactiver la télémétrie sur une instance**
Pour désactiver la télémétrie pour une seule instance, vous pouvez définir une variable d’environnement système ou utiliser le MSI pour modifier l’installation.
Pour désactiver la télémétrie en paramétrant une variable d’environnement système, exécutez la commande suivante en tant qu’administrateur.
```
setx /M EC2LAUNCH_TELEMETRY 0
```
Pour désactiver la télémétrie à l’aide du MSI, exécutez la commande suivante après avoir [téléchargé le MSI](ec2launch-v2-install.md).
```
msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
```
**Topics**
+ [EC2Lancez les concepts de la v2](#ec2launch-v2-concepts)
+ [EC2Présentation des tâches Launch v2](#ec2launch-v2-tasks)
+ [EC2Lancer la structure du répertoire v2](#ec2launch-v2-directory)
+ [Télémétrie](#ec2launch-v2-telemetry)
+ [Installez la dernière version de EC2 Launch v2](ec2launch-v2-install.md)
+ [Configuration des paramètres de EC2 Launch v2 pour les instances Windows](ec2launch-v2-settings.md)
+ [Définitions de tâches pour les tâches de démarrage de EC2 Launch v2](ec2launch-v2-task-definitions.md)
+ [Résoudre les problèmes liés à l'agent EC2 Launch v2](ec2launchv2-troubleshooting.md)
+ [EC2Historique des versions de Launch v2](ec2launchv2-versions.md)
# Installez la dernière version de EC2 Launch v2
Vous pouvez utiliser l’une des méthodes suivantes pour installer l’agent EC2Launch v2 sur votre instance EC2 :
+ Téléchargez l'agent depuis Amazon S3 et installez-le avec Windows PowerShell. Pour le téléchargement URLs, voir[EC2Lancer les téléchargements de la version 2 sur Amazon S3](#lv2-download-s3).
+ Installez à partir d’un distributeur SSM.
+ Installez à partir d'un composant EC2 Image Builder lors de la création d'une image personnalisée.
+ Lancez votre instance depuis une AMI sur laquelle EC2 Launch v2 est préinstallé.
**Avertissement**
AmazonEC2Launch.msi désinstalle les versions précédentes des services de lancement EC2, tels que EC2 Launch (v1) et Config. EC2
Pour les étapes d’installation, sélectionnez l’onglet correspondant à votre méthode préférée.
------
#### [ PowerShell ]
Pour installer la dernière version de l'agent EC2 Launch v2 sous Windows PowerShell, procédez comme suit.
1. Créez votre répertoire local.
```
New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
```
1. Définissez l’URL de votre emplacement de téléchargement. Exécutez la commande suivante avec l’URL Amazon S3 que vous allez utiliser. Pour le téléchargement URLs, voir [EC2Lancer les téléchargements de la version 2 sur Amazon S3](#lv2-download-s3)
```
$Url = "Amazon S3 URL/AmazonEC2Launch.msi"
```
1. Utilisation de la commande combinée suivante pour télécharger et installer l’agent
```
$DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
msiexec /i "$DownloadFile"
```
**Note**
Si un message d'erreur s'affiche lors du téléchargement du fichier et que vous utilisez Windows Server 2016 ou une version antérieure, il est possible que le protocole TLS 1.2 doive être activé sur votre PowerShell terminal. Vous pouvez activer le protocole TLS 1.2 pour la PowerShell session en cours à l'aide de la commande suivante, puis réessayer :
```
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
```
1. La **msiexec** commande installe EC2 Launch v2 à l'emplacement suivant sur les instances de Windows Server :`%ProgramFiles%\Amazon\EC2Launch`. Pour vérifier que l'installation s'est bien déroulée, vous pouvez vérifier le système de fichiers local de votre instance.
------
#### [ AWS Systems Manager Distributor ]
Pour configurer les mises à jour automatiques pour EC2 Launch v2 avec AWS Systems Manager Quick Setup, voir[Installez et mettez à jour automatiquement avec la configuration rapide du distributeur](#lv2-distributor-quick-setup).
Vous pouvez également procéder à une installation unique du `AWSEC2Launch-Agent` package depuis le AWS Systems Manager distributeur. Pour obtenir des instructions sur l’installation d’un package à partir d’un distributeur Systems Manager, veuillez consulter la rubrique [Installer ou mettre à jour des packages](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) dans le *Guide de l’utilisateur AWS Systems Manager *.
------
#### [ EC2 Image Builder component ]
Vous pouvez installer le composant `ec2launch-v2-windows` lorsque vous créez une image personnalisée avec EC2 Image Builder. Pour obtenir des instructions sur la création d’une image personnalisée avec EC2 Image Builder, consultez [Création d’un pipeline d’images à l’aide de l’assistant de la console EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) dans le *Guide de l’utilisateur EC2 Image Builder*.
------
#### [ AMI ]
EC2Launch v2 est préinstallé par défaut AMIs pour les systèmes d'exploitation Windows Server 2022 et versions ultérieures :
+ Windows\$1Server- -Version intégrale en anglais *version*
+ Windows\$1Server- -Anglais-Core-Base *version*
+ Windows\$1Server- -English-Core-EKS\$1Optimized *version*
+ Windows Server *version* AMIs avec toutes les autres langues
+ Windows Server *version* AMIs avec SQL installé
EC2Launch v2 est également préinstallé sur les AMI Windows Server suivants. Vous pouvez trouver ces AMI à partir de la console Amazon EC2, ou en utilisant le préfixe de recherche suivant : `EC2LaunchV2-` dans l’ AWS CLI.
+ EC2LaunchV2-Windows\$1Server-2019-Englis-Core-Base
+ EC2LaunchV2-Windows\$1Server-2019-Anglais-Full-Base
+ EC2LaunchV2-Windows\$1Server-2016-English-Core-Base
+ EC2LaunchV2-Windows\$1Server-2016-Anglais-Full-Base
------
## Installation et mise à jour automatiques de EC2 Launch v2 avec AWS Systems Manager Distributor Quick Setup
Avec AWS Systems Manager Distributor Quick Setup, vous pouvez configurer des mises à jour automatiques pour EC2 Launch v2. Le processus suivant permet de configurer une association Systems Manager sur votre instance qui met automatiquement à jour l'agent EC2 Launch v2 à une fréquence que vous spécifiez. L'association créée par le programme de configuration rapide du distributeur peut inclure des instances au sein d'une région Compte AWS et, ou des instances au sein d'une AWS organisation. Pour plus d'informations sur la création d'une organisation, consultez [le Tutoriel : créer et configurer une organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html) dans le *AWS Organizations Guide de l'utilisateur*.
Avant de commencer, assurez-vous que vos instances remplissent toutes les conditions requises.
### Conditions préalables
Pour configurer les mises à jour automatiques avec la configuration rapide du distributeur, vos instances doivent remplir les conditions préalables suivantes.
+ Vous avez au moins une instance en cours d'exécution qui prend en charge EC2 Launch v2. Consultez les systèmes d'exploitation pris en charge pour [EC2Lancer la v2](ec2launch-v2.md).
+ Vous avez effectué les tâches d'installation du gestionnaire de systèmes sur vos instances. Pour plus d'informations, consultez [Configuration du gestionnaire de systèmes](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html) dans le *AWS Systems Manager Guide de l'utilisateur*.
+ EC2Launch v2 doit être le seul agent de lancement installé sur votre instance. Si plus d'un agent de lancement est installé, la configuration de la configuration rapide du distributeur échouera. Avant de configurer EC2 Launch v2 à l'aide d'un distributeur Quick Setup, désinstallez les agents de EC2 lancement EC2 Config ou Launch v1, s'ils existent.
### Configurer la configuration rapide du distributeur pour EC2 Launch v2
Pour créer une configuration pour EC2 Launch v2 avec Distributor Quick Setup, utilisez les paramètres suivants lorsque vous terminez les étapes de [déploiement du package Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html) :
+ **Packages logiciels :** agent Amazon EC2 Launch v2.
+ **Fréquence de mise à jour :** sélectionnez une fréquence dans la liste.
+ **Cibles :** choisissez parmi les options de déploiement disponibles.
Pour vérifier l'état de votre configuration, accédez à l'onglet **Configurations** de la configuration rapide du gestionnaire de systèmes dans l'onglet AWS Management Console.
1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Dans le panneau de navigation, choisissez **Configuration rapide**.
1. Dans l'onglet **Configurations**, sélectionnez la ligne associée à la configuration que vous avez créée. L'onglet **Configurations** répertorie vos configurations et inclut un résumé des principaux détails, tels que **Région**, **Statut du déploiement**, et **Statut de l'association**.
**Note**
Le nom de l'association pour chaque configuration du distributeur EC2 Launch v2 commence par le préfixe suivant :`AWS-QuickSetup-Distributor-EC2Launch-Agent-`.
1. Pour afficher les détails, sélectionnez la configuration et choisissez **Afficher les détails**.
Pour plus d'informations et pour connaître les étapes de résolution des problèmes, consultez [Résolution des problèmes liés aux résultats de la configuration rapide](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-results-troubleshooting.html) dans le *Guide de l'utilisateur AWS Systems Manager *.
## EC2Lancer les téléchargements de la version 2 sur Amazon S3
Pour installer la dernière version de EC2 Launch v2, téléchargez le programme d'installation depuis l'emplacement suivant :
+ [https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi](https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi)
## Configuration des options d’installation
Lorsque vous installez ou mettez à niveau EC2 Launch v2, vous pouvez configurer les options d'installation à l'aide de la boîte de dialogue d'installation de EC2 Launch v2 ou à l'aide de la **msiexec** commande dans un shell de ligne de commande.
La première fois que le programme d'installation de EC2 Launch v2 s'exécute sur une instance, il initialise les paramètres de l'agent de lancement sur votre instance comme suit :
+ Il crée le chemin local et y écrit le fichier de l’agent de lancement. C’est ce que l’on appelle parfois l’*installation propre*.
+ Il crée la variable d’environnement `EC2LAUNCH_TELEMETRY` si elle n’existe pas déjà, et la définit en fonction de votre configuration.
Pour les détails de configuration, sélectionnez l’onglet correspondant à la méthode de configuration que vous allez utiliser.
------
#### [ Amazon EC2Launch Setup dialog ]
Lorsque vous installez ou mettez à niveau EC2 Launch v2, vous pouvez configurer les options d'installation suivantes via la boîte de dialogue d'installation de EC2 Launch v2.Options d’**installation de base**
**Envoyer des données de télémétrie**
Lorsque vous incluez cette fonctionnalité dans la boîte de dialogue de configuration, le programme d’installation définit la variable d’environnement `EC2LAUNCH_TELEMETRY` sur une valeur de `1`. Si vous désactivez **Envoyer des données de télémétrie**, le programme d’installation définit la valeur de la variable d’environnement sur `0`.
Lorsque l'agent EC2 Launch v2 s'exécute, il lit la variable d'`EC2LAUNCH_TELEMETRY`environnement pour déterminer s'il convient de télécharger des données de télémétrie. Si la valeur est égale à `1`, il charge les données. Dans le cas contraire, il ne les charge pas.
**Configuration par défaut**
La configuration par défaut pour EC2 Launch v2 consiste à remplacer l'agent de lancement local s'il existe déjà. La première fois que vous exécutez une installation sur une instance, la configuration par défaut effectue une installation propre. Si vous désactivez la configuration par défaut lors de l’installation initiale, l’installation échoue.
Si vous réexécutez l’installation sur l’instance, vous pouvez désactiver la configuration par défaut afin d’effectuer une mise à niveau qui ne remplace pas le fichier `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`.
**Exemple : mise à niveau de EC2 Launch v2 avec la télémétrie**
L'exemple suivant montre la boîte de dialogue de configuration de EC2 Launch v2 configurée pour mettre à niveau l'installation actuelle et activer la télémétrie. Cette configuration effectue une installation sans remplacer le fichier de configuration de l’agent et définit la valeur de la variable d’environnement `EC2LAUNCH_TELEMETRY` sur `1`.
![\[EC2Lancez la configuration de mise à niveau v2.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png)
------
#### [ Command line ]
Lorsque vous installez ou mettez à niveau EC2 Launch v2, vous pouvez configurer les options d'installation suivantes à l'aide de la **msiexec** commande dans un shell de ligne de commande.Valeurs de paramètres `ADDLOCAL`
**De base** (obligatoire)
Installez l’agent de lancement. Si cette valeur n’est pas présente dans le paramètre `ADDLOCAL`, l’installation se termine.
**Propre**
Lorsque vous incluez la valeur `Clean` dans le paramètre `ADDLOCAL`, le programme d’installation écrit le fichier de configuration de l’agent à l’emplacement suivant : `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`. Si le fichier de configuration de l’agent existe déjà, il le remplace.
Lorsque vous enlevez la valeur `Clean` du paramètre `ADDLOCAL`, le programme d’installation effectue une mise à niveau qui ne remplace pas le fichier de configuration de l’agent.
**Télémétrie**
Lorsque vous incluez la valeur `Telemetry` dans le paramètre `ADDLOCAL`, le programme d’installation définit la valeur de la variable d’environnement `EC2LAUNCH_TELEMETRY` sur `1`.
Lorsque vous enlevez la valeur `Telemetry` du paramètre `ADDLOCAL`, le programme d’installation définit la valeur de la variable d’environnement sur `0`.
Lorsque l'agent EC2 Launch v2 s'exécute, il lit la variable d'`EC2LAUNCH_TELEMETRY`environnement pour déterminer s'il convient de télécharger des données de télémétrie. Si la valeur est égale à `1`, il charge les données. Dans le cas contraire, il ne les charge pas.
**Exemple : installation de EC2 Launch v2 avec télémétrie**
```
& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q
```
------
## Vérifiez la version EC2 Launch v2
Utilisez l'une des procédures suivantes pour vérifier la version de EC2 Launch v2 installée sur vos instances.
------
#### [ PowerShell ]
Vérifiez la version installée de EC2 Launch v2 avec Windows PowerShell, comme suit.
1. Lancez une instance depuis votre AMI et connectez-vous à celle-ci.
1. Exécutez la commande suivante PowerShell pour vérifier la version installée de EC2 Launch v2 :
```
& "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
```
------
#### [ Windows Control Panel ]
Vérifiez la version installée de EC2 Launch v2 dans le panneau de configuration Windows, comme suit.
1. Lancez une instance depuis votre AMI et connectez-vous à celle-ci.
1. Ouvrez le panneau de configuration Windows, puis choisissez **Programmes et fonctionnalités**.
1. Recherchez `Amazon EC2Launch` dans la liste des programmes installés. Son numéro de version s’affiche dans la colonne **Version**.
------
Pour consulter les dernières mises à jour pour AWS Windows AMIs, consultez l'[historique des versions de l'AMI Windows](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html) dans le manuel *AWS Windows AMI Reference*.
Pour la dernière version de EC2 Launch v2, voir[EC2Historique des versions de Launch v2](ec2launchv2-versions.md#ec2launchv2-version-history).
Vous pouvez recevoir des notifications lorsque de nouvelles versions du service EC2 Launch v2 sont publiées. Pour de plus amples informations, veuillez consulter [Abonnez-vous aux notifications de l'agent de lancement EC2 Windows](launch-agents-subscribe-notifications.md).
# Configuration des paramètres de EC2 Launch v2 pour les instances Windows
Cette section contient des informations sur la configuration des paramètres de EC2 Launch v2.
**Topics**
+ [Modifier les paramètres à l'aide de la boîte de dialogue des paramètres de EC2 Launch v2](#ec2launch-v2-ui)
+ [Configurer EC2 Launch v2 à l'aide de la CLI](#ec2launch-v2-cli)
+ [EC2Configuration des tâches de lancement de la version 2](#ec2launch-v2-task-configuration)
+ [EC2Lancez les codes de sortie de la v2 et redémarrez](#ec2launch-v2-exit-codes-reboots)
+ [EC2Lancez la v2 et Sysprep](#ec2launch-v2-sysprep)
## Modifier les paramètres à l'aide de la boîte de dialogue des paramètres de EC2 Launch v2
La procédure suivante décrit comment utiliser la boîte de dialogue des paramètres de EC2 Launch v2 pour activer ou désactiver les paramètres.
**Note**
Si vous configurez des tâches personnalisées de manière incorrecte dans le fichier agent-config.yml et que vous tentez d'ouvrir la boîte de dialogue des paramètres d'Amazon EC2 Launch, vous recevrez un message d'erreur. Pour un exemple de schéma, consultez [Exemple : `agent-config.yml`](#ec2launch-v2-example-agent-config).
1. Lancez et connectez-vous à votre instance Windows.
1. Dans le menu Démarrer, choisissez **Tous les programmes**, puis accédez aux **paramètres de EC2 lancement**. Avant de choisir **Arrêter avec Sysprep** ou **Arrêter sans Sysprep**, assurez-vous d’enregistrer les modifications que vous souhaitez appliquer lors de l’exécution de l’arrêt.
![\[Application des paramètres de lancement EC2.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/ec2launchv2-settings.png)
1. Dans l'onglet **Général** de la boîte de dialogue **Paramètres de EC2 lancement**, vous pouvez activer ou désactiver les paramètres suivants.
1. **Set Computer Name (Définir le nom de l’ordinateur)**
Si ce paramètre est activé (il est désactivé par défaut), le nom d’hôte actuel est comparé au nom d’hôte souhaité à chaque démarrage. Si les noms d’hôte ne correspondent pas, le nom d’hôte est réinitialisé et le système redémarre éventuellement pour récupérer le nouveau nom d’hôte. Si aucun nom d'hôte personnalisé n'est spécifié, il est généré à l'aide de l' IPv4 adresse privée au format hexadécimal, par exemple,. `ip-AC1F4E6` Pour empêcher que votre nom d’hôte existant ne soit modifié, n’activez pas ce paramètre.
1. **Étendre le volume de démarrage**
Ce paramètre étend de manière dynamique `Disk 0`/`Volume 0` pour inclure l’espace non partitionné. Cela peut être utile lorsque l’instance est démarrée à partir d’un volume racine doté d’une taille personnalisée.
1. **Définir le compte administrateur**
Lorsque cette option est activée, vous pouvez définir les attributs de nom d’utilisateur et de mot de passe pour le compte d’administrateur créé sur votre ordinateur local. Si cette fonctionnalité n’est pas activée, un compte d’administrateur n’est pas créé sur le système après Sysprep. Indiquez un mot de passe dans `adminPassword` uniquement si `adminPasswordtype` est `Specify`.
Les types de mots de passe sont définis comme suit :
1. `Random`
EC2Launch génère un mot de passe et le chiffre à l'aide de la clé de l'utilisateur. Le système désactive ce paramètre après le lancement de l’instance afin que ce mot de passe persiste si l’instance est redémarrée, arrêtée ou démarrée.
1. `Specify`
EC2Launch utilise le mot de passe que vous spécifiez dans`adminPassword`. Si le mot de passe ne répond pas aux exigences du système, EC2 Launch génère un mot de passe aléatoire à la place. Le mot de passe est stocké dans le fichier `agent-config.yml` sous forme de texte clair et est supprimé une fois que le mot de passe est défini par Sysprep. EC2Launch chiffre le mot de passe à l'aide de la clé de l'utilisateur.
1. `Do not set`
EC2Launch utilise le mot de passe que vous spécifiez dans le fichier unattend.xml. Si vous ne spécifiez pas de mot de passe dans unattend.xml, le compte d’administrateur est désactivé.
1. **Démarrer le service SSM**
Lorsque cette option est sélectionnée, le service Systems Manager est activé pour démarrer après Sysprep. EC2Launch v2 exécute toutes les tâches décrites [précédemment](ec2launch-v2.md#ec2launch-v2-tasks), et l'agent SSM traite les demandes relatives aux fonctionnalités de Systems Manager, telles que Run Command et State Manager.
Vous pouvez utiliser Run Command pour mettre à niveau vos instances existantes afin d'utiliser la dernière version du service EC2 Launch v2 et de l'agent SSM. Pour plus d’informations, consultez la section [Mise à jour de l’agent SSM à l’aide de la fonctionnalité Exécuter la commande](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command-tutorial-update-software.html) dans le *Guide de l’utilisateur AWS Systems Manager*.
1. **Optimiser ENA**
Lorsqu'ils sont sélectionnés, les paramètres ENA sont configurés pour garantir que les paramètres ENA de dimensionnement côté réception et de profondeur de file d'attente de réception sont optimisés pour AWS. Pour de plus amples informations, veuillez consulter [Configurer l’affinité du processeur de mise à l’échelle côté réception](enhanced-networking-os.md#windows-rss-cpu-affinity).
1. **Activer SSH**
Ce paramètre permet à OpenSSH pour les versions ultérieures de Windows d’autoriser l’administration du système à distance.
1. **Activer les trames Jumbo**
Sélectionnez cette option pour activer les trames Jumbo. Les trames Jumbo peuvent avoir des effets inattendus sur vos communications réseau. Assurez-vous donc de comprendre comment les trames Jumbo auront un impact sur votre système avant de les activer. Pour plus d’informations sur les trames jumbo, consultez [Trames jumbo (MTU de 9001)](network_mtu.md#jumbo_frame_instances).
1. **Préparer l’imagerie**
Indiquez si vous souhaitez que votre instance EC2 s’arrête avec ou sans Sysprep. Lorsque vous souhaitez exécuter Sysprep avec EC2 Launch v2, choisissez **Shutdown** with Sysprep.
1. Dans l’onglet **Suffixe DNS** vous pouvez sélectionner si vous souhaitez ajouter une liste de suffixe DNS pour la résolution DNS des serveurs exécutés dans EC2, sans fournir le nom de domaine complet. Les suffixes DNS peuvent contenir les variables `$REGION` et `$AZ`. Seuls les suffixes qui n’existent pas déjà seront ajoutés à la liste.
![\[Application des paramètres de lancement EC2.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/ec2launchv2-dns.png)
1. Dans l’onglet **Fond d’écran**, vous pouvez configurer le fond d’écran de votre instance avec une image d’arrière-plan et spécifier les détails de l’instance à afficher dans le fond d’écran. Amazon EC2 génère les détails à chaque fois que vous vous connectez.
Vous pouvez configurer votre fond d’écran à l’aide des commandes suivantes.
+ **Afficher les détails de l’instance sur le fond d’écran** – Cette case à cocher active ou désactive l’affichage des détails de l’instance sur le fond d’écran.
+ **Chemin de l’image (.jpg)** – Spécifiez le chemin d’accès à l’image à utiliser comme fond d’écran.
+ **Sélectionner les attributs à afficher sur le fond d’écran** – Cochez les cases correspondant aux détails de l’instance que vous voulez voir apparaître sur le fond d’écran. Décochez les cases des détails d’instance précédemment sélectionnés que vous voulez supprimer du fond d’écran.
+ **Afficher les balises d’instance sur le fond d’écran** – Sélectionnez l’un des paramètres suivants pour afficher les balises d’instance sur le fond d’écran :
+ **Aucun** : n’affichez aucune balise d’instance sur le fond d’écran.
+ **Afficher tout** : affiche toutes les balises d’instance sur le fond d’écran.
+ **Afficher avec filtre** : affiche les balises d’instance spécifiées sur le fond d’écran. Lorsque vous sélectionnez ce paramètre, vous pouvez ajouter les balises d’instance que vous souhaitez voir s’afficher sur votre fond d’écran dans la zone **Filtre de balise d’instance**.
**Note**
Vous devez activer les balises dans les métadonnées pour afficher les balises sur le fond d’écran. Pour plus d’informations sur les balises et métadonnées d’instance, consultez [Affichez les balises pour vos instances EC2 à l'aide des métadonnées d'instance](work-with-tags-in-IMDS.md).
![\[Onglet Fond d’écran des paramètres de lancement d’EC2.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/ec2launchv2-wallpaper-02.png)
1. Sous l’onglet **Volumes**, indiquez si vous souhaitez initialiser les volumes attachés à l’instance. L’activation définit les lettres de lecteur pour tous les volumes supplémentaires et les étend pour utiliser l’espace disponible. Si vous sélectionnez **Tous**, tous les volumes de stockage sont initialisés. Si vous sélectionnez **Appareils**, seuls les appareils spécifiés dans la liste sont initialisés. Vous devez entrer l’appareil pour chaque appareil à initialiser. Utilisez les appareils répertoriés sur la console EC2, par exemple, `xvdb` ou `/dev/nvme0n1`. La liste déroulante affiche les volumes de stockage attachés à l’instance. Pour entrer un appareil qui n’est pas attaché à l’instance, saisissez-le dans le champ de texte.
**Nom**, **Lettre** et **Partition** sont des champs facultatifs. Si aucune valeur n’est spécifiée pour **Partition**, les volumes de stockage de plus de 2 To sont initialisés avec le type de partition `gpt` et ceux de moins de 2 To sont initialisés avec le type de partition `mbr`. Si des appareils sont configurés et qu’un appareil non NTFS contient une table de partitions ou que les 4 premiers Ko du disque contiennent des données, le disque est ignoré et l’action est consignée.
![\[Application des paramètres de lancement EC2.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/ec2launchv2-volumes.png)
## Configurer EC2 Launch v2 à l'aide de la CLI
Vous pouvez utiliser l'interface de ligne de commande (CLI) pour configurer vos paramètres de EC2 lancement et gérer le service. La section suivante contient des descriptions et des informations d'utilisation des commandes CLI que vous pouvez utiliser pour gérer EC2 Launch v2.
**Topics**
+ [collect-logs](#ec2launch-v2-collect-logs)
+ [get-agent-config](#ec2launch-v2-get-agent-config)
+ [list-volumes](#ec2launch-v2-list-volumes)
+ [reset](#ec2launch-v2-reset)
+ [run](#ec2launch-v2-run)
+ [status](#ec2launch-v2-settings-status)
+ [sysprep](#ec2launch-v2-settings-sysprep)
+ [valider](#ec2launch-v2-validate)
+ [version](#ec2launch-v2-version)
+ [fond d’écran](#ec2launch-v2-wallpaper)
### collect-logs
Collecte les fichiers journaux pour EC2 Launch, les compresse et les place dans un répertoire spécifié.
**Exemple**
```
ec2launch collect-logs -o C:\Mylogs.zip
```
**Utilisation**
`ec2launch collect-logs [flags]`
**Indicateurs**
`-h`, `--help`
aide pour `collect-logs`
`-o`, `--output string`
chemin d’accès aux fichiers journaux de sortie compressés
### get-agent-config
Imprime `agent-config.yml` au format spécifié (JSON ou YAML). Si aucun format n’est spécifié, `agent-config.yml` est imprimé dans le format précédemment spécifié.
**Exemple**
```
ec2launch get-agent-config -f json
```
**Utilisation**
`ec2launch get-agent-config [flags]`
**Indicateurs**
`-h`, `--help`
aide pour `get-agent-config`
`-f`, `--format string`
format de sortie du fichier `agent-config` : `json`, `yaml`
### list-volumes
Répertorie tous les volumes de stockage attachés à l’instance, y compris les volumes éphémères et EBS.
**Exemple**
```
ec2launch list-volumes
```
**Utilisation**
`ec2launch list-volumes`
**Indicateurs**
`-h`, `--help`
aide pour `list-volumes`
### reset
L’objectif principal de cette tâche est de réinitialiser l’agent pour sa prochaine exécution. Pour ce faire, la **reset** commande supprime toutes les données d'état de l'agent pour EC2 Launch v2 du `EC2Launch` répertoire local (voir[EC2Lancer la structure du répertoire v2](ec2launch-v2.md#ec2launch-v2-directory)). Reset supprime éventuellement le service et les journaux Sysprep.
Le comportement des scripts dépend du mode dans lequel l’agent exécute les scripts : en ligne ou détaché.
En ligne (par défaut)
L'agent EC2 Launch v2 exécute les scripts un par un (`detach: false`). Il s’agit du paramètre par défaut.
Lorsque votre script en ligne émet une commande **reset** ou **sysprep**, il s’exécute immédiatement et réinitialise l’agent. La tâche en cours se termine, puis l’agent s’arrête sans exécuter d’autres tâches.
Par exemple, si la tâche qui émet la commande aurait été suivie d’une tâche `startSsm` (incluse par défaut après l’exécution des données utilisateur), la tâche ne s’exécute pas et le service Systems Manager ne démarre jamais.
Detached
L'agent EC2 Launch v2 exécute des scripts simultanément avec d'autres tâches (`detach: true`).
Lorsque votre script détaché émet une commande **reset** ou **sysprep**, ces commandes attendent que l’agent ait terminé leur exécution avant de s’exécuter. Les tâches exécutées après executeScript se poursuivront.
**Exemple**
```
ec2launch reset -c
```
**Utilisation**
`ec2launch reset [flags]`
**Indicateurs**
`-c`, `--clean`
nettoie les journaux d’instance avant la `reset`
`-h`, `--help`
aide pour `reset`
### run
Exécute EC2 Launch v2.
**Exemple**
```
ec2launch run
```
**Utilisation**
`ec2launch run [flags]`
**Indicateurs**
`-h`, `--help`
aide pour `run`
### status
Obtient le statut de l'agent EC2 Launch v2. Il est possible de bloquer le processus jusqu’à ce que l’agent soit terminé. Le code de sortie du processus détermine l’état de l’agent :
+ `0` : l’agent a été exécuté avec succès.
+ `1` : l’agent a été exécuté et a échoué.
+ `2` : l’agent est toujours en cours d’exécution.
+ `3` : l’agent est dans un état inconnu. L’état de l’agent n’est pas en cours d’exécution ou arrêté.
+ `4` : une erreur s’est produite lors de la tentative de récupération de l’état de l’agent.
+ `5` : l’agent n’est pas en cours d’exécution et l’état de la dernière exécution connue est inconnu. Cela peut signifier :
+ qu’à la fois `state.json` et `previous-state.json` sont supprimés.
+ que `previous-state.json` est corrompu.
Il s’agit de l’état de l’agent après l’exécution de la commande [`reset`](#ec2launch-v2-reset).
**Exemple :**
```
ec2launch status -b
```
**Utilisation**
`ec2launch status [flags]`
**Indicateurs**
`-b`,`--block`
bloque le processus jusqu’à la fin de l’exécution de l’agent
`-h`,`--help`
aide pour `status`
### sysprep
L’objectif principal de cette tâche est de réinitialiser l’agent pour sa prochaine exécution. Pour ce faire, la commande **sysprep** réinitialise l’état de l’agent, met à jour le fichier `unattend.xml`, désactive RDP et exécute Sysprep.
Le comportement des scripts dépend du mode dans lequel l’agent exécute les scripts : en ligne ou détaché.
En ligne (par défaut)
L'agent EC2 Launch v2 exécute les scripts un par un (`detach: false`). Il s’agit du paramètre par défaut.
Lorsque votre script en ligne émet une commande **reset** ou **sysprep**, il s’exécute immédiatement et réinitialise l’agent. La tâche en cours se termine, puis l’agent s’arrête sans exécuter d’autres tâches.
Par exemple, si la tâche qui émet la commande aurait été suivie d’une tâche `startSsm` (incluse par défaut après l’exécution des données utilisateur), la tâche ne s’exécute pas et le service Systems Manager ne démarre jamais.
Detached
L'agent EC2 Launch v2 exécute des scripts simultanément avec d'autres tâches (`detach: true`).
Lorsque votre script détaché émet une commande **reset** ou **sysprep**, ces commandes attendent que l’agent ait terminé leur exécution avant de s’exécuter. Les tâches exécutées après executeScript se poursuivront.
**Exemple :**
```
ec2launch sysprep
```
**Utilisation**
`ec2launch sysprep [flags]`
**Indicateurs**
`-c`,`--clean`
nettoie les journaux d’instance avant la `sysprep`
`-h`,`--help`
aide pour Sysprep
`-s`,`--shutdown`
arrête l’instance après l’exécution de `sysprep`
### valider
Valide le fichier `agent-config` `C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml`.
**Exemple**
```
ec2launch validate
```
**Utilisation**
`ec2launch validate [flags]`
**Indicateurs**
-h` `, `--help`
aide pour `validate`
### version
Obtient la version exécutable.
**Exemple**
```
ec2launch version
```
**Utilisation**
`ec2launch version [flags]`
**Indicateurs**
`-h`, `--help`
aide pour `version`
### fond d’écran
Définit le nouveau fond d’écran sur le chemin d’écran fourni (fichier .jpg) et affiche les détails de l’instance sélectionnée.
#### Syntaxe
```
ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,ipv6Address,instanceSize,availabilityZone,architecture
```
#### Inputs
Parameters
**--balises autorisées [,] *tag-name-1* *tag-name-n***
(Facultatif) Tableau JSON codé en Base64 contenant les noms des balises d’instance à afficher sur le fond d’écran. Vous pouvez utiliser cette balise ou l’option `--all-tags`, mais pas les deux.
**--attributs*attribute-string-1*, *attribute-string-n***
(Facultatif) Une liste de chaînes d’attributs `wallpaper` séparées par des virgules pour appliquer des paramètres au fond d’écran.
**[--chemin \$1 -p] *path-string***
(Obligatoire) Spécifie le chemin du fichier image d’arrière-plan `wallpaper`.Indicateurs
**--all-tags**
(Facultatif) Affiche toutes les balises d’instance sur le fond d’écran. Vous pouvez utiliser cette balise ou l’option `--allowed-tags`, mais pas les deux.
**[--help \$1 -h]**
Affiche l’aide concernant la commande **wallpaper**.
## EC2Configuration des tâches de lancement de la version 2
Cette section inclut les schémas de configuration, les tâches, les détails et les exemples pour `agent-config.yml` et les données utilisateur.
**Topics**
+ [Schéma : `agent-config.yml`](#ec2launch-v2-schema-agent-config)
+ [Configuration des scripts de données utilisateur de EC2 Launch v2 exécutés lors du lancement ou du redémarrage](#ec2launch-v2-schema-user-data)
### Schéma : `agent-config.yml`
La structure du fichier `agent-config.yml` est illustrée ci-dessous. Notez qu’une tâche ne peut pas être répétée dans la même étape. Pour connaître les propriétés des tâches, consultez les descriptions de tâches suivantes.
#### Structure du document : agent-config.yml
**JSON**
```
{
"version": "1.1",
"config": [
{
"stage": "string",
"tasks": [
{
"task": "string",
"inputs": {
...
}
},
...
]
},
...
]
}
```
**YAML**
```
version: 1.1
config:
- stage: string
tasks:
- task: string
inputs:
...
...
...
```
#### Exemple : `agent-config.yml`
L’exemple suivant montre les paramètres du fichier de configuration `agent-config.yml`.
```
version: 1.1
config:
- stage: boot
tasks:
- task: extendRootPartition
- stage: preReady
tasks:
- task: activateWindows
inputs:
activation:
type: amazon
- task: setDnsSuffix
inputs:
suffixes:
- $REGION.ec2-utilities.amazonaws.com
- task: setAdminAccount
inputs:
password:
type: random
- task: setWallpaper
inputs:
path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
attributes:
- hostName
- instanceId
- privateIpAddress
- publicIpAddress
- instanceSize
- availabilityZone
- architecture
- stage: postReady
tasks:
- task: startSsm
```
### Configuration des scripts de données utilisateur de EC2 Launch v2 exécutés lors du lancement ou du redémarrage
Les exemples JSON et YAML suivants illustrent la structure du document pour les données utilisateur. Amazon EC2 analyse chaque tâche nommée du tableau `tasks` que vous spécifiez dans le document. Chaque tâche possède son propre ensemble de propriétés et d’exigences. Pour obtenir des détails, veuillez consulter le [Définitions de tâches pour les tâches de démarrage de EC2 Launch v2](ec2launch-v2-task-definitions.md).
**Note**
Une tâche ne doit apparaître qu’une seule fois dans le tableau des tâches des données de l’utilisateur.
#### Structure du document : données utilisateur
**JSON**
```
{
"version": "1.1",
"tasks": [
{
"task": "string",
"inputs": {
...
},
},
...
]
}
```
**YAML**
```
version: 1.1
tasks:
- task: string
inputs:
...
...
```
#### Exemple : données utilisateur
Pour plus d’informations sur les rôles d’utilisateur, consultez [Comment Amazon EC2 gère les données utilisateur pour les instances Windows](user-data.md#ec2-windows-user-data).
L'exemple de document YAML suivant montre un PowerShell script que EC2 Launch v2 exécute sous forme de données utilisateur pour créer un fichier.
```
version: 1.1
tasks:
- task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |-
New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
```
Vous pouvez utiliser un format XML pour les données utilisateur compatible avec les versions précédentes de l'agent de lancement. EC2Launch v2 exécute le script en tant que `executeScript` tâche dans la `UserData` phase. Pour se conformer au comportement de EC2 Launch v1 et EC2 Config, le script de données utilisateur s'exécute par défaut en tant que attached/inline processus.
Vous pouvez ajouter des balises facultatives pour personnaliser l’exécution de votre script. Par exemple, pour exécuter le script de données utilisateur lors du redémarrage de l’instance et lors du lancement de l’instance, vous pouvez utiliser la balise suivante :
`true`
**Exemple :**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
Vous pouvez spécifier un ou plusieurs PowerShell arguments à l'aide de la `` balise. Si aucun argument n'est transmis, EC2 Launch v2 ajoute l'argument suivant par défaut :`-ExecutionPolicy Unrestricted`.
**Exemple :**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
-ExecutionPolicy Unrestricted -NoProfile -NonInteractive
```
Pour exécuter un script de données utilisateur XML en tant que processus détaché, ajoutez la balise suivante à vos données utilisateur.
`true`
**Exemple :**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
**Note**
La balise detach n’est pas prise en charge sur les agents de lancement précédents.
#### Journal des modifications : données utilisateur
Le tableau suivant répertorie les modifications apportées aux données utilisateur et les référence à la version de l'agent EC2 Launch v2 applicable.
| Version des données utilisateur | Détails | Présenté dans |
| --- | --- | --- |
| 1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Lancez la version v2 2.0.1245 |
| 1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Lancez la version 2.0.0 de la v2 |
\$1 Lorsqu’il est utilisé avec le fichier `agent-config.yml` par défaut.
## EC2Lancez les codes de sortie de la v2 et redémarrez
Vous pouvez utiliser EC2 Launch v2 pour définir la manière dont les codes de sortie sont gérés par vos scripts. Par défaut, le code de sortie de la dernière commande exécutée dans un script est signalé comme le code de sortie pour l’ensemble du script. Par exemple, si un script inclut trois commandes et que la première commande échoue mais que les suivantes réussissent, le statut d’exécution est signalé comme `success` étant donné que la commande finale a réussi.
Si vous souhaitez qu'un script redémarre une instance, vous devez le spécifier `exit 3010` dans votre script, même si le redémarrage est la dernière étape de votre script. `exit 3010`demande à EC2 Launch v2 de redémarrer l'instance et d'appeler à nouveau le script jusqu'à ce qu'il renvoie un code de sortie qui ne l'est pas `3010` ou jusqu'à ce que le nombre maximal de redémarrages soit atteint. EC2Launch v2 autorise un maximum de 5 redémarrages par tâche. Si vous tentez de redémarrer une instance à partir d’un script à l’aide d’un mécanisme différent, tel que `Restart-Computer`, le statut d’exécution du script sera incohérent. Par exemple, il peut être bloqué dans une boucle de redémarrage ou ne pas effectuer le redémarrage.
Si vous utilisez un format de données utilisateur XML qui est compatible avec les anciens agents, les données utilisateur peuvent s’exécuter plus de fois que vous le souhaitez. Pour plus d’informations, consultez [Le service exécute les données utilisateur plus d’une fois](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-user-data-more-than-once) dans la section de résolution des problèmes.
## EC2Lancez la v2 et Sysprep
Le service EC2 Launch v2 exécute Sysprep, un outil Microsoft qui permet de créer une AMI Windows personnalisée qui peut être réutilisée. Lorsque EC2 Launch v2 appelle Sysprep, il utilise les fichiers qu'il contient `%ProgramData%\Amazon\EC2Launch` pour déterminer les opérations à effectuer. Vous pouvez modifier ces fichiers indirectement à l'aide de la boîte de dialogue des **paramètres de EC2 lancement**, ou directement à l'aide d'un éditeur YAML ou d'un éditeur de texte. Cependant, certains paramètres avancés ne sont pas disponibles dans la boîte de dialogue des **paramètres de EC2 lancement**. Vous devez donc modifier ces entrées directement.
Si vous créez une AMI directement dans une instance après avoir mis à jour ses paramètres, ceux-ci sont appliqués à n’importe quelle instance lancée dans la nouvelle AMI. Pour plus d’informations sur la création d’une AMI, consultez [Créer une AMI basée sur Amazon EBS](creating-an-ami-ebs.md).
# Définitions de tâches pour les tâches de démarrage de EC2 Launch v2
Chaque tâche exécutée par EC2 Launch v2 lors du lancement ou du démarrage possède son propre ensemble de propriétés et d'exigences. Les détails des tâches comprennent les paramètres relatifs à la fréquence d'exécution d'une tâche : une fois ou toujours, l'étape du processus de démarrage de l'agent dans laquelle elle s'exécute, la syntaxe et des exemples de documents YAML. Pour plus d'informations, consultez les détails de la tâche présentés dans cette référence.
**Topics**
+ [activateWindows](#ec2launch-v2-activatewindows)
+ [enableJumboFrames](#ec2launch-v2-enablejumboframes)
+ [enableOpenSsh](#ec2launch-v2-enableopenssh)
+ [executeProgram](#ec2launch-v2-executeprogram)
+ [executeScript](#ec2launch-v2-executescript)
+ [extendRootPartition](#ec2launch-v2-extendrootpartition)
+ [initializeVolume](#ec2launch-v2-initializevolume)
+ [optimizeEna](#ec2launch-v2-optimizeena)
+ [setAdminAccount](#ec2launch-v2-setadminaccount)
+ [setDnsSuffix](#ec2launch-v2-setdnssuffix)
+ [setHostName](#ec2launch-v2-sethostname)
+ [setWallpaper](#ec2launch-v2-setwallpaper)
+ [startSsm](#ec2launch-v2-startssm)
+ [sysprep](#ec2launch-v2-task-sysprep)
+ [writeFile](#ec2-launch-v2-writefile)
## activateWindows
Active Windows sur un ensemble de AWS KMS serveurs. L'activation est ignorée si l'instance est détectée comme Bring-Your-Own-License (BYOL).
*Fréquence* — Une fois
*AllowedStages* — `[PreReady]`
*Entrées* —
`activation` : (carte)
`type` : type d’activation (string) à utiliser, défini sur `amazon`
*Exemple*
```
task: activateWindows
inputs:
activation:
type: amazon
```
## enableJumboFrames
Active les trames Jumbo, qui augmentent l’unité de transmission maximale (MTU) de la carte réseau. Pour plus d’informations, consultez [Trames jumbo (MTU de 9001)](network_mtu.md#jumbo_frame_instances).
*Fréquence* — Toujours
*AllowedStages* — `[PostReady, UserData]`
*Entrées* — Aucune
*Exemple*
```
task: enableJumboFrames
```
## enableOpenSsh
Active Windows OpenSSH et ajoute la clé publique de l’instance au dossier des clés autorisées.
*Fréquence* — Une fois
*AllowedStages* — `[PreReady, UserData]`
*Entrées* — Aucune
*Exemple*
L’exemple suivant montre comment activer OpenSSH sur une instance et ajouter la clé publique de l’instance au dossier des clés autorisées. Cette configuration fonctionne uniquement sur les instances exécutant Windows Server 2019 et versions ultérieures.
```
task: enableOpenSsh
```
## executeProgram
Exécute un programme avec des arguments facultatifs et une fréquence spécifiée.
**Étapes :** vous pouvez exécuter la tâche `executeProgram` pendant les étapes `PreReady`, `PostReady` et `UserData`.
**Fréquence :** configurable, voir *Entrées*.
**Inputs**
Cette section contient un ou plusieurs programmes à exécuter pour **executeProgram** la tâche (entrées). Chaque entrée peut inclure les paramètres configurables suivants :
**fréquence (chaîne)**
(Obligatoire) Spécifiez exactement l’une des valeurs suivantes :
+ `once`
+ `always`
**chemin (chaîne)**
(Obligatoire) Le chemin d’accès au fichier de l’exécutable à exécuter.
**arguments (liste de chaînes)**
(Facultatif) Liste d’arguments séparés par des virgules à fournir au programme en entrée.
**runAs (chaîne)**
(Obligatoire) Doit être défini sur `localSystem`
**Output**
Toutes les tâches écrivent des entrées du fichier journal dans le fichier `agent.log`. Les résultats supplémentaires de la tâche `executeProgram` sont stockés séparément dans un dossier nommé dynamiquement, comme suit :
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.tmp`
Le chemin exact vers les fichiers de sortie est inclus dans le fichier `agent.log`, par exemple :
```
Program file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\ExecuteProgramInputs.tmp
Output file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Output.tmp
Error file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Err.tmp
```
**Fichiers de sortie pour la tâche `executeProgram`**
`ExecuteProgramInputs.tmp`
Contient le chemin de l’exécutable et tous les paramètres d’entrée que la tâche `executeProgram` lui transmet lors de son exécution.
`Output.tmp`
Contient la sortie d’exécution du programme exécuté par la tâche `executeProgram`.
`Err.tmp`
Contient les messages d’erreur d’exécution du programme exécuté par la tâche `executeProgram`.
**Exemples**
Les exemples suivants montrent comment exécuter un fichier exécutable à partir d’un répertoire local sur une instance avec la tâche `executeProgram`.
**Exemple 1 : configuration d’un exécutable avec un seul argument**
Cet exemple montre une tâche `executeProgram` qui exécute un exécutable d’installation en mode silencieux.
```
task: executeProgram
inputs:
- frequency: always
path: C:\Users\Administrator\Desktop\setup.exe
arguments: ['-quiet']
```
**Exemple 2 : exécutable VLC avec deux arguments**
Cet exemple montre une tâche `executeProgram` qui exécute un fichier exécutable VLC avec deux arguments transmis en tant que paramètres d’entrée.
```
task: executeProgram
inputs:
- frequency: always
path: C:\vlc-3.0.11-win64.exe
arguments: ['/L=1033','/S']
runAs: localSystem
```
## executeScript
Exécute un script avec des arguments facultatifs et une fréquence spécifiée. Le comportement des scripts dépend du mode dans lequel l’agent exécute les scripts : en ligne ou détaché.
En ligne (par défaut)
L'agent EC2 Launch v2 exécute les scripts un par un (`detach: false`). Il s’agit du paramètre par défaut.
Lorsque votre script en ligne émet une commande **reset** ou **sysprep**, il s’exécute immédiatement et réinitialise l’agent. La tâche en cours se termine, puis l’agent s’arrête sans exécuter d’autres tâches.
Par exemple, si la tâche qui émet la commande aurait été suivie d’une tâche `startSsm` (incluse par défaut après l’exécution des données utilisateur), la tâche ne s’exécute pas et le service Systems Manager ne démarre jamais.
Detached
L'agent EC2 Launch v2 exécute des scripts simultanément avec d'autres tâches (`detach: true`).
Lorsque votre script détaché émet une commande **reset** ou **sysprep**, ces commandes attendent que l’agent ait terminé leur exécution avant de s’exécuter. Les tâches exécutées après executeScript se poursuivront.
**Étapes :** vous pouvez exécuter la tâche `executeScript` pendant les étapes `PreReady`, `PostReady` et `UserData`.
**Fréquence :** configurable, voir *Entrées*.
**Inputs**
Cette section contient un ou plusieurs scripts pour la **executeScript** tâche à exécuter (entrées). Chaque entrée peut inclure les paramètres configurables suivants :
**fréquence (chaîne)**
(Obligatoire) Spécifiez exactement l’une des valeurs suivantes :
+ `once`
+ `always`
**type (chaîne)**
(Obligatoire) Spécifiez exactement l’une des valeurs suivantes :
+ `batch`
+ `powershell`
**arguments (liste de chaînes)**
(Facultatif) Une liste d'arguments de chaîne à transmettre au shell (et non au PowerShell script). Ce paramètre n’est pas pris en charge pour `type: batch`. Si aucun argument n'est transmis, EC2 Launch v2 ajoute l'argument suivant par défaut : `-ExecutionPolicy Unrestricted`
**contenu (chaîne)**
(Obligatoire) Contenu du script.
**runAs (chaîne)**
(Obligatoire) Spécifiez exactement l’une des valeurs suivantes :
+ `admin`
+ `localSystem`
**detach (booléen)**
(Facultatif) L'agent EC2 Launch v2 exécute par défaut les scripts un par un (`detach: false`). Pour exécuter le script en même temps que d’autres tâches, définissez la valeur sur `true` (`detach: true`).
Codes de sortie de script (y compris `3010`) n’ont aucun effet lorsque `detach` a la valeur `true`.
**Output**
Toutes les tâches écrivent des entrées du fichier journal dans le fichier `agent.log`. Les résultats supplémentaires du script exécuté par la tâche `executeScript` sont stockés séparément dans un dossier nommé dynamiquement, comme suit :
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.ext`
Le chemin exact vers les fichiers de sortie est inclus dans le fichier `agent.log`, par exemple :
```
Program file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\UserScript.ps1
Output file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Output.tmp
Error file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Err.tmp
```
**Fichiers de sortie pour la tâche `executeScript`**
`UserScript.ext`
Contient le script exécuté par la tâche `executeScript`. L’extension de fichier dépend du type de script que vous avez spécifié dans le paramètre `type` de la tâche `executeScript`, comme suit :
+ Si le type est `batch`, l’extension du fichier est `.bat`.
+ Si le type est `powershell`, l’extension du fichier est `.ps1`.
`Output.tmp`
Contient la sortie d’exécution du script exécuté par la tâche `executeScript`.
`Err.tmp`
Contient les messages d’erreur d’exécution du script exécuté par la tâche `executeScript`.
**Exemples**
Les exemples suivants montrent comment exécuter un script en ligne avec la tâche `executeScript`.
**Exemple 1 : fichier texte de sortie Hello World**
Cet exemple montre une `executeScript` tâche qui exécute un PowerShell script pour créer un fichier texte « Hello world » sur le `C:` lecteur.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: admin
content: |-
New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
Set-Content 'C:\PowerShellTest.txt' "Hello world"
```
**Exemple 2 : exécuter deux scripts**
Cet exemple montre que la tâche `executeScript` peut exécuter plusieurs scripts et que le type de script ne doit pas nécessairement correspondre.
Le premier script (`type: powershell`) écrit un résumé des processus en cours d’exécution sur l’instance dans un fichier texte situé sur le lecteur `C:`.
Le second script (`batch`) écrit les informations système dans le fichier `Output.tmp`.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |
Get-Process | Out-File -FilePath C:\Process.txt
- frequency: always
type: batch
runAs: localSystem
content: |
systeminfo
```
**Exemple 3 : configuration d’un système idempotent avec redémarrages**
Cet exemple montre une tâche `executeScript` qui exécute un script idempotent pour effectuer la configuration système suivante avec un redémarrage entre chaque étape :
+ Renommer l’ordinateur.
+ Joindre l’ordinateur au domaine.
+ Activer Telnet.
Le script garantit que chaque opération ne s’exécute qu’une seule fois. Cela empêche une boucle de redémarrage et rend le script idempotent.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |-
$name = $env:ComputerName
if ($name -ne $desiredName) {
Rename-Computer -NewName $desiredName
exit 3010
}
$domain = Get-ADDomain
if ($domain -ne $desiredDomain)
{
Add-Computer -DomainName $desiredDomain
exit 3010
}
$telnet = Get-WindowsFeature -Name Telnet-Client
if (-not $telnet.Installed)
{
Install-WindowsFeature -Name "Telnet-Client"
exit 3010
}
```
## extendRootPartition
Étend le volume racine pour utiliser tout l’espace disponible sur le disque.
*Fréquence* — Une fois
*AllowedStages* — `[Boot]`
*Entrées* — Aucune
*Exemple*
```
task: extendRootPartition
```
## initializeVolume
Initialise les volumes vides attachés à l’instance afin qu’ils soient activés et partitionnés. L’agent de lancement ignore l’initialisation s’il détecte que le volume n’est pas vide. Un volume est considéré comme vide si les 4 premiers Kio d’un volume sont vides ou si un volume n’a pas de [disposition de lecteur reconnaissable par Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex).
Le paramètre d’entrée `letter` est toujours appliqué lors de l’exécution de cette tâche, que le lecteur soit déjà initialisé ou non.
La tâche `initializeVolume` effectue ensuite les actions suivantes.
+ Définissez les attributs de disque `offline` et `readonly` sur False.
+ Créez une partition. Si aucun type de partition n’est spécifié dans le paramètre d’entrée `partition`, les valeurs par défaut suivantes s’appliquent :
+ Si la taille de disque est inférieure à 2 To, définissez le type de partition sur `mbr`.
+ Si la taille de disque est supérieure ou égale à 2 To, définissez le type de partition sur `gpt`.
+ Formatez le volume au format NTFS.
+ Définissez l’étiquette du volume comme suit :
+ Utilisez la valeur du paramètre d’entrée `name`, le cas échéant.
+ Si le volume est éphémère et qu’aucun nom n’a été spécifié, définissez l’étiquette du volume sur `Temporary Storage Z`.
+ Si le volume est éphémère (SSD ou HDD, pas Amazon EBS), créez un fichier `Important.txt` à la racine du volume avec le contenu suivant :
```
This is an 'Instance Store' disk and is provided at no additional charge.
*This disk offers increased performance since it is local to the host
*The number of Instance Store disks available to an instance vary by instance type
*DATA ON THIS DRIVE WILL BE LOST IN CASES OF IMPAIRMENT OR STOPPING THE INSTANCE. PLEASE ENSURE THAT ANY IMPORTANT DATA IS BACKED UP FREQUENTLY
For more information, please refer to: Stockage de blocs temporaires pour les instances EC2.
```
+ Réglez la lettre de lecteur sur la valeur spécifiée dans le paramètre d’entrée `letter`.
**Étapes :** vous pouvez exécuter la tâche `initializeVolume` pendant les étapes `PostReady` et `UserData`.
**Fréquence :** toujours.
**Inputs**
Vous pouvez configurer les paramètres d’exécution comme suit :
**appareils (liste de cartes)**
(Condition) Configuration pour chaque appareil initialisé par l’agent de lancement. Ceci est obligatoire si le paramètre d’entrée `initialize` est défini sur `devices`.
+ **appareil (chaîne, obligatoire)** : identifie l’appareil lors de la création de l’instance. Par exemple, `xvdb`, `xvdf` ou `\dev\nvme0n1`.
+ **lettre (chaîne, facultatif)** : un caractère. La lettre de lecteur à attribuer.
+ **nom (chaîne, facultatif)** : le nom de volume à attribuer.
+ **partition (chaîne, facultatif)** : spécifiez l’une des valeurs suivantes pour le type de partition à créer, ou laissez l’agent de lancement par défaut en fonction de la taille du volume :
+ mbr
+ gpt
**initialiser (chaîne)**
(Obligatoire) Spécifiez exactement l’une des valeurs suivantes :
+ `all`
+ `devices`
**Exemples**
Voici des exemples de configurations d’entrée pour la tâche `initializeVolume`.
**Exemple 1 : Initialiser deux volumes sur une instance**
Cet exemple montre une tâche `initializeVolume` qui initialise deux volumes secondaires sur une instance. L’appareil nommé `DataVolume2` dans l’exemple est éphémère.
```
task: initializeVolume
inputs:
initialize: devices
devices:
- device: xvdb
name: DataVolume1
letter: D
partition: mbr
- device: /dev/nvme0n1
name: DataVolume2
letter: E
partition: gpt
```
**Exemple 2 : Initialiser des volumes EBS attachés à une instance**
Cet exemple montre une tâche `initializeVolume` qui initialise tous les volumes EBS vides qui sont attachés à l’instance.
```
task: initializeVolume
inputs:
initialize: all
```
## optimizeEna
Optimise les paramètres ENA en fonction du type d’instance actuel ; peut redémarrer l’instance.
*Fréquence* — Toujours
*AllowedStages* — `[PostReady, UserData]`
*Entrées* — Aucune
*Exemple*
```
task: optimizeEna
```
## setAdminAccount
Définit les attributs du compte d’administrateur par défaut créé sur la machine locale.
*Fréquence* — Une fois
*AllowedStages* — `[PreReady]`
*Entrées* —
`name` : nom (chaîne) du compte administrateur
`password` : (carte)
`type` : stratégie (chaîne) pour définir le mot de passe, comme `static`, `random` ou `doNothing`
`data` : (chaîne) stocke les données si le champ `type` est statique
*Exemple*
```
task: setAdminAccount
inputs:
name: Administrator
password:
type: random
```
## setDnsSuffix
Ajoute les suffixes DNS à la liste des suffixes de recherche. Seuls les suffixes qui n’existent pas déjà sont ajoutés à la liste. Pour plus d'informations sur la manière dont les agents de lancement définissent les suffixes DNS, consultez [Configurer le suffixe DNS pour les agents de lancement EC2 Windows](launch-agents-set-dns.md).
*Fréquence* — Toujours
*AllowedStages* — `[PreReady]`
*Entrées* —
`suffixes` : (liste de chaînes) liste d’un ou plusieurs suffixes DNS valides ; les variables de substitution valides sont `$REGION` et `$AZ`
*Exemple*
```
task: setDnsSuffix
inputs:
suffixes:
- $REGION.ec2-utilities.amazonaws.com
```
## setHostName
Définit le nom d'hôte de l'ordinateur sur une chaîne personnalisée ou, si elle n'`hostName`est pas spécifiée, sur l' IPv4 adresse privée.
*Fréquence* — Toujours
*AllowedStages* — `[PostReady, UserData]`
*Entrées* —
`hostName` : (chaîne) nom d’hôte facultatif, qui doit être formaté comme suit.
+ Doit contenir 15 caractères ou moins
+ Doit contenir uniquement des caractères alphanumériques (a-z, A-Z, 0-9) et tiret (-).
+ Ne doit pas être entièrement composé de caractères numériques.
`reboot` : (booléen) indique si un redémarrage est autorisé lorsque le nom d’hôte est modifié
*Exemple*
```
task: setHostName
inputs:
reboot: true
```
## setWallpaper
Crée le fichier de raccourci `setwallpaper.lnk` dans le dossier de démarrage de chaque utilisateur existant, sauf pour `Default User`. Ce fichier de raccourci s’exécute lorsque l’utilisateur se connecte pour la première fois après le démarrage de l’instance. Il configure l’instance avec un fond d’écran personnalisé qui affiche les attributs de l’instance.
Le chemin du fichier de raccourci est le suivant :
```
$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk
```
**Note**
Lorsque vous supprimez la tâche `setWallpaper`, ce fichier de raccourci n’est pas supprimé. Pour de plus amples informations, veuillez consulter [La tâche `setWallpaper` n’est pas activée, mais le fond d’écran se réinitialise au redémarrage](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-wallpaper-resets).
**Étapes :** vous pouvez configurer le fond d’écran au cours des étapes `PreReady` et `UserData`.
**Fréquence :** `always`
**Configuration du fond d’écran**
Vous pouvez utiliser les paramètres suivants pour configurer votre fond d’écran.
**Inputs**
Paramètres d’entrée que vous fournissez et attributs que vous pouvez définir pour configurer votre fond d’écran :
**chemin (chaîne)**
(Obligatoire) Le chemin du nom du fichier image au format .jpg local à utiliser pour votre image de fond d’écran.
**attributs (liste de chaînes)**
(Facultatif) Vous pouvez ajouter un ou plusieurs des attributs suivants à votre fond d’écran :
+ `architecture`
+ `availabilityZone`
+ `hostName`
+ `instanceId`
+ `instanceSize`
+ `privateIpAddress`
+ `publicIpAddress`
+ `ipv6Address`
**instanceTags**
(Facultatif) Vous pouvez utiliser exactement l’une des options suivantes pour ce paramètre.
+ **AllTags**(string) — Ajoutez toutes les balises d'instance à votre fond d'écran.
```
instanceTags: AllTags
```
+ **instanceTags** (liste de chaînes) – Spécifiez une liste de noms de balises d’instance à ajouter à votre fond d’écran. Par exemple :
```
instanceTags:
- Tag 1
- Tag 2
```
**Exemple**
L’exemple suivant montre les entrées de configuration du fond d’écran qui définissent le chemin du fichier pour l’image d’arrière-plan du fond d’écran, ainsi que les balises d’instance nommées `Tag 1` et `Tag 2`, ainsi que les attributs qui incluent le nom d’hôte, l’ID d’instance et les adresses IP privées et publiques de l’instance.
```
task: setWallpaper
inputs:
path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
attributes:
- hostName
- instanceId
- privateIpAddress
- publicIpAddress
instanceTags:
- Tag 1
- Tag 2
```
**Note**
Vous devez activer les balises dans les métadonnées pour afficher les balises sur le fond d’écran. Pour plus d’informations sur les balises et métadonnées d’instance, consultez [Affichez les balises pour vos instances EC2 à l'aide des métadonnées d'instance](work-with-tags-in-IMDS.md).
## startSsm
Démarrez le service Systems Manager (SSM) après Sysprep.
*Fréquence* — Toujours
*AllowedStages* — `[PostReady, UserData]`
*Entrées* — Aucune
*Exemple*
```
task: startSsm
```
## sysprep
Réinitialise l’état du service, met à jour `unattend.xml`, désactive RDP et exécute Sysprep. Cette tâche s’exécute uniquement une fois que toutes les autres tâches sont terminées.
*Fréquence* — Une fois
*AllowedStages* — `[UserData]`
*Entrées* —
`clean` : (booléen) nettoie les journaux d’instance avant d’exécuter Sysprep
`shutdown` : (booléen) arrête l’instance après avoir exécuté Sysprep
*Exemple*
```
task: sysprep
inputs:
clean: true
shutdown: true
```
## writeFile
Écrit un fichier vers une destination.
*Fréquence* — voir *Entrées*
*AllowedStages* — `[PostReady, UserData]`
*Entrées* —
`frequency` : (chaîne) `once` ou `always`
`destination` : (chaîne) chemin vers lequel écrire le contenu
`content` : (chaîne) texte à écrire dans la destination
*Exemple*
```
task: writeFile
inputs:
- frequency: once
destination: C:\Users\Administrator\Desktop\booted.txt
content: Windows Has Booted
```
# Résoudre les problèmes liés à l'agent EC2 Launch v2
Cette section présente des scénarios de résolution des problèmes courants pour EC2 Launch v2, des informations sur l'affichage des journaux d'événements Windows, ainsi que les résultats et les messages des journaux de console.
**Topics**
+ [Scénarios courants](#ec2launchv2-troubleshooting-scenarios)
+ [Journaux d’événements Windows](#ec2launchv2-windows-event-logs)
+ [EC2Sortie du journal de la console Launch v2](#ec2launchv2-console-output)
## Scénarios courants de résolution des problèmes
Cette section présente les scénarios de dépannage courants et les étapes de résolution.
**Topics**
+ [Le service ne parvient pas à définir le fond d’écran](#ec2launchv2-troubleshooting-wallpaper)
+ [Le service ne parvient pas à exécuter les données utilisateur](#ec2launchv2-troubleshooting-user-data)
+ [Le service exécute une tâche une seule fois](#ec2launchv2-troubleshooting-task-once)
+ [Le service ne parvient pas à exécuter une tâche](#ec2launchv2-troubleshooting-task-failed)
+ [Le service exécute les données utilisateur plus d’une fois](#ec2launchv2-troubleshooting-user-data-more-than-once)
+ [Les tâches planifiées de EC2 Launch v1 ne s'exécutent pas après la migration vers EC2 Launch v2](#ec2launchv2-troubleshooting-scheduled-tasks-migration)
+ [Le service initialise un volume EBS qui n’est pas vide](#ec2launchv2-troubleshooting-ebs-initialize)
+ [La tâche `setWallpaper` n’est pas activée, mais le fond d’écran se réinitialise au redémarrage](#ec2launchv2-troubleshooting-wallpaper-resets)
+ [Service bloqué en mode d’exécution](#ec2launchv2-troubleshooting-service-stuck-running)
+ [Non valide `agent-config.yml` empêche l'ouverture de la boîte de dialogue des paramètres de EC2 Launch v2](#ec2launchv2-troubleshooting-invalid-agent-config)
+ [`task:executeScript should be unique and only invoked once`](#ec2launchv2-troubleshooting-executescript)
### Le service ne parvient pas à définir le fond d’écran
**Résolution**
1. Vérifiez si `%AppData%\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\setwallpaper.lnk` existe.
1. Vérifiez dans `%ProgramData%\Amazon\EC2Launch\log\agent.log` pour voir si des erreurs se sont produites.
### Le service ne parvient pas à exécuter les données utilisateur
**Cause possible** : le service peut avoir échoué avant l’exécution des données utilisateur.
**Résolution**
1. Vérifiez `%ProgramData%\Amazon\EC2Launch\state\previous-state.json`.
1. Voyez si `boot`, `network`, `preReady` et `postReadyLocalData` ont tous été marqués comme une réussite.
1. Si l’une des étapes a échoué, vérifiez si `%ProgramData%\Amazon\EC2Launch\log\agent.log` contient des erreurs spécifiques.
### Le service exécute une tâche une seule fois
**Résolution**
1. Vérifiez la fréquence de la tâche.
1. Si le service a déjà été exécuté après Sysprep et que la fréquence de la tâche est définie sur `once`, la tâche ne s’exécutera plus.
1. Définissez la fréquence de la tâche sur `always` si vous souhaitez qu'elle l'exécute à chaque exécution de EC2 Launch v2.
### Le service ne parvient pas à exécuter une tâche
**Résolution**
1. Vérifiez les dernières entrées dans `%ProgramData%\Amazon\EC2Launch\log\agent.log`.
1. Si aucune erreur n’est survenue, essayez d’exécuter le service manuellement à partir de `"%ProgramFiles%\Amazon\EC2Launch\EC2Launch.exe" run` pour voir si les tâches réussissent.
### Le service exécute les données utilisateur plus d’une fois
**Résolution**
Les données utilisateur sont traitées différemment entre EC2 Launch v1 et EC2 Launch v2. EC2Launch v1 exécute les données utilisateur sous forme de tâche planifiée sur l'instance lorsque `persist` ce paramètre est défini sur`true`. Si `persist` est défini sur `false`, la tâche n’est pas planifiée même lorsqu’elle se termine avec un redémarrage ou est interrompue pendant son exécution.
EC2Launch v2 exécute les données utilisateur en tant que tâche d'agent et suit leur état d'exécution. Si les données utilisateur entraînent un redémarrage de l’ordinateur ou si leur exécution est interrompue, l’état d’exécution `pending` persiste et les données utilisateur seront réexécutées au démarrage suivant de l’instance. Si vous souhaitez empêcher le script de données utilisateur de s’exécuter plusieurs fois, rendez le script idempotent.
L’exemple suivant de script idempotent définit le nom de l’ordinateur et joint un domaine.
```
$name = $env:computername
if ($name -ne $desiredName) {
Rename-Computer -NewName $desiredName
}
$domain = Get-ADDomain
if ($domain -ne $desiredDomain)
{
Add-Computer -DomainName $desiredDomain
}
$telnet = Get-WindowsFeature -Name Telnet-Client
if (-not $telnet.Installed)
{
Install-WindowsFeature -Name "Telnet-Client"
}
false
```
### Les tâches planifiées de EC2 Launch v1 ne s'exécutent pas après la migration vers EC2 Launch v2
**Résolution**
L'outil de migration ne détecte aucune tâche planifiée liée aux scripts EC2 Launch v1 ; par conséquent, il ne configure pas automatiquement ces tâches dans EC2 Launch v2. Pour configurer ces tâches, modifiez le [`agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-task-configuration)fichier ou utilisez la [boîte de dialogue des paramètres de EC2 Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui). Par exemple, si une tâche planifiée est exécutée sur une instance`InitializeDisks.ps1`, après avoir exécuté l'outil de migration, vous devez spécifier les volumes que vous souhaitez initialiser dans la boîte de dialogue des paramètres de EC2 Launch v2. Voir l’étape 6 de la procédure pour [Modifier les paramètres à l'aide de la boîte de dialogue des paramètres de EC2 Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui).
### Le service initialise un volume EBS qui n’est pas vide
**Résolution**
Avant d'initialiser un volume, EC2 Launch v2 tente de détecter s'il est vide. Si un volume n’est pas vide, il ignore l’initialisation. Les volumes détectés comme non vides ne sont pas initialisés. Un volume est considéré comme vide si les 4 premiers Ko d’un volume sont vides ou si un volume n’a pas de [disposition de lecteur reconnaissable par Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex). Un volume initialisé et formaté sur un système Linux n’a pas de disposition de lecteur reconnaissable par Windows, par exemple MBR ou GPT. Par conséquent, il sera considéré comme vide et initialisé. Si vous souhaitez conserver ces données, ne vous fiez pas à la détection de disque vide par EC2 Launch v2. Spécifiez plutôt les volumes que vous souhaitez initialiser dans la [boîte de dialogue des paramètres de EC2 Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui) (voir étape 6) ou dans le [`agent-config.yml`](ec2launch-v2-task-definitions.md#ec2launch-v2-initializevolume).
### La tâche `setWallpaper` n’est pas activée, mais le fond d’écran se réinitialise au redémarrage
La tâche `setWallpaper` crée le fichier de raccourci `setwallpaper.lnk` dans le dossier de démarrage de chaque utilisateur existant. Ce fichier de raccourci s’exécute lorsque l’utilisateur se connecte pour la première fois après le démarrage de l’instance. Il configure l’instance avec un fond d’écran personnalisé qui affiche les attributs de l’instance. La suppression de la tâche `setWallpaper` ne supprime pas ce fichier de raccourci. Vous devez supprimer manuellement ce fichier ou le supprimer à l’aide d’un script.
Le chemin du raccourci est le suivant :
`$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk`
**Résolution**
Supprimez manuellement ce fichier ou supprimez-le à l’aide d’un script.
**Exemple de PowerShell script pour supprimer un fichier de raccourci**
```
foreach ($userDir in (Get-ChildItem "C:\Users" -Force -Directory).FullName)
{
$startupPath = Join-Path $userDir -ChildPath "AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"
if (Test-Path $startupPath)
{
$wallpaperSetupPath = Join-Path $startupPath -ChildPath "setwallpaper.lnk"
if (Test-Path $wallpaperSetupPath)
{
Remove-Item $wallpaperSetupPath -Force -Confirm:$false
}
}
}
```
### Service bloqué en mode d’exécution
**Description**
EC2Le lancement de la version 2 est bloqué, avec des messages de journal (`agent.log`) similaires aux suivants :
```
2022-02-24 08:08:58 Info: *****************************************************************************************
2022-02-24 08:08:58 Info: EC2Launch Service starting
2022-02-24 08:08:58 Info: Windows event custom log exists: Amazon EC2Launch
2022-02-24 08:08:58 Info: ACPI SPCR table not supported. Bailing Out
2022-02-24 08:08:58 Info: Serial port is in use. Waiting for Serial Port...
2022-02-24 08:09:00 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:02 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:04 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:06 Info: ACPI SPCR table not supported. Use default console port.
```
**Cause possible**
SAC est activé et utilise le port série. Pour plus d’informations, consultez [Utilisation de SAC pour dépanner votre instance Windows](troubleshoot-using-serial-console.md#troubleshooting-sac).
**Résolution**
Essayez les étapes suivantes pour résoudre ce problème :
+ Désactivez le service qui utilise le port série.
+ Si vous voulez que le service continue à utiliser le port série, écrivez des scripts personnalisés pour exécuter les tâches de l’agent de lancement et invoquez-les en tant que tâches planifiées.
### Non valide `agent-config.yml` empêche l'ouverture de la boîte de dialogue des paramètres de EC2 Launch v2
**Description**
EC2Les paramètres de Launch v2 tentent d'analyser le `agent-config.yml` fichier avant qu'il n'ouvre la boîte de dialogue. Si le fichier de configuration YAML ne suit pas le schéma pris en charge, la boîte de dialogue affiche l’erreur suivante :
`Unable to parse configuration file agent-config.yml. Review configuration file. Exiting application.`
**Résolution**
1. Vérifiez que le fichier de configuration est conforme au [schéma pris en charge](ec2launch-v2-settings.md#ec2launch-v2-schema-agent-config).
1. Si vous souhaitez commencer à zéro, copiez le fichier de configuration par défaut dans `agent-config.yml`. Vous pouvez utiliser l’[exemple `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config) fourni dans la section Configuration des tâches.
1. Vous pouvez également recommencer en supprimant `agent-config.yml`. EC2Les paramètres de Launch v2 génèrent un fichier de configuration vide.
### `task:executeScript should be unique and only invoked once`
**Description**
Une tâche ne peut pas être répétée dans la même étape.
**Résolution**
Certaines tâches doivent être entrées sous forme de tableau, telles que [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript) et [**executeProgram**](ec2launch-v2-task-definitions.md#ec2launch-v2-executeprogram). Pour obtenir un exemple de la façon d’écrire le script en tant que tableau, consultez [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript).
## Journaux d’événements Windows
EC2Launch v2 publie des journaux d'événements Windows pour les événements importants, tels que le démarrage du service, la disponibilité de Windows et la réussite ou l'échec des tâches. Les identificateurs d’événement identifient de manière unique un événement particulier. Chaque événement contient des informations sur l’étape, la tâche et le niveau, ainsi qu’une description. Vous pouvez définir des déclencheurs pour des événements spécifiques à l’aide de l’identificateur d’événement.
Événement : IDs fournissez des informations sur un événement et identifiez certains événements de manière unique. Le chiffre le moins significatif d’un ID d’événement indique la gravité d’un événement.
| Événement | Chiffre le moins significatif |
| --- | --- |
| Success | . . .0 |
| Informational | . . .1 |
| Warning | . . .2 |
| Error | . . .3 |
Les événements liés au service qui sont générés au démarrage ou à l’arrêt du service incluent un identifiant d’événement à un seul chiffre.
| Événement | Identifiant à un chiffre |
| --- | --- |
| Success | 0 |
| Informational | 1 |
| Warning | 2 |
| Error | 3 |
Les messages d’événement pour les événements `EC2LaunchService.exe` commencent par `Service:`. Les messages d’événement pour les événements `EC2Launch.exe` ne commencent pas par `Service:`.
Un événement à quatre chiffres IDs inclut des informations sur le stade, la tâche et la gravité d'un événement.
**Topics**
+ [Format de l’ID d’événement](#ec2launchv2-windows-event-logs-format)
+ [Exemples d’ID d’événement](#ec2launchv2-windows-event-logs-id-examples)
+ [Schéma du journal des événements Windows](#ec2launch-v2-windows-event-logs-schema)
### Format de l’ID d’événement
Le tableau suivant indique le format d'un identifiant d'événement EC2 Launch v2.
| 3 | 2 1 | 0 |
| --- | --- | --- |
| S | T | L |
Les lettres et les chiffres du tableau représentent le type d’événement et les définitions suivants.
| Type d’événement | Définition |
| --- | --- |
| S (Stage) | 0 - Message de niveau de service 1 - Démarrer 2 - Réseau 3 - PreReady 5 - Windows est prêt 6 - PostReady 7 - Données utilisateur |
| T (Tâche) | Les tâches représentées par les deux valeurs correspondantes sont différentes pour chaque étape. Pour afficher la liste complète des événements, consultez [Schéma du journal des événements Windows](#ec2launch-v2-windows-event-logs-schema). |
| L (Niveau de l’événement) | 0 - Réussite 1 - Informationnel 2 - Avertissement 3 - Erreur |
### Exemples d’ID d’événement
Voici un exemple d'événement IDs.
+ `5000` - Windows est prêt à l’emploi
+ `3010`- La tâche d'activation de Windows en cours d' PreReady étape a été réussie
+ `6013`- La tâche de définition du fond d'écran dans le stage PostReady Local Data a rencontré une erreur
### Schéma du journal des événements Windows
| MessageId/Identifiant de l'événement | Message d’événement |
| --- | --- |
| . . .0 | Success |
| . . .1 | Informational |
| . . .2 | Warning |
| . . .3 | Error |
| x | EC2Launch service-level logs |
| 0 | EC2Launch service exited successfully |
| 1 | EC2Launch service informational logs |
| 2 | EC2Launch service warning logs |
| 3 | EC2Launch service error logs |
| 10 | Replace state.json with previous-state.json |
| 100 | Serial Port |
| 200 | Sysprep |
| 300 | PrimaryNic |
| 400 | Metadata |
| x000 | Stage (1 digit), Task (2 digits), Status (1 digit) |
| 1000 | Boot |
| 1010 | Boot - extend\$1root\$1partition |
| 2000 | Network |
| 2010 | Network - add\$1routes |
| 3000 | PreReady |
| 3010 | PreReady - activate\$1windows |
| 3020 | PreReady - install\$1egpu\$1manager |
| 3030 | PreReady - set\$1monitor\$1on |
| 3040 | PreReady - set\$1hibernation |
| 3050 | PreReady - set\$1admin\$1account |
| 3060 | PreReady - set\$1dns\$1suffix |
| 3070 | PreReady - set\$1wallpaper |
| 3080 | PreReady - set\$1update\$1schedule |
| 3090 | PreReady - output\$1log |
| 3100 | PreReady - enable\$1open\$1ssh |
| 5000 | Windows is Ready to use |
| 6000 | PostReadyLocalData |
| 7000 | PostReadyUserData |
| 6010/7010 | PostReadyLocal/UserData - set\$1wallpaper |
| 6020/7020 | PostReadyLocal/UserData - set\$1update\$1schedule |
| 6030/7030 | PostReadyLocal/UserData - set\$1hostname |
| 6040/7040 | PostReadyLocal/UserData - execute\$1program |
| 6050/7050 | PostReadyLocal/UserData - execute\$1script |
| 6060/7060 | PostReadyLocal/UserData - manage\$1package |
| 6070/7070 | PostReadyLocal/UserData - initialize\$1volume |
| 6080/7080 | PostReadyLocal/UserData - write\$1file |
| 6090/7090 | PostReadyLocal/UserData - start\$1ssm |
| 7100 | PostReadyUserData - enable\$1open\$1ssh |
| 6110/7110 | PostReadyLocal/UserData - enable\$1jumbo\$1frames |
## EC2Sortie du journal de la console Launch v2
Cette section contient des exemples de sortie du journal de console pour EC2 Launch v2 et répertorie tous les messages d'erreur du journal de la console EC2 Launch v2 pour vous aider à résoudre les problèmes. Pour plus d'informations sur la sortie de la console de l'instance et sur la manière d'y accéder, consultez [Sortie de la console de l’instance](troubleshoot-unreachable-instance.md#instance-console-console-output).
**Topics**
+ [EC2Sortie du journal de la console Launch v2](#ec2launchv2-console-log-output)
+ [EC2Messages du journal de la console Lancer la v2](#ec2launchv2-console-log-messages)
### EC2Sortie du journal de la console Launch v2
Voici un exemple de sortie du journal de console pour EC2 Launch v2. Dans cet exemple, certaines valeurs sont remplacées par du texte représentatif entouré d’accolades.
```
2025/07/22 21:26:53Z: Windows sysprep configuration complete.
2025/07/22 21:26:53Z: Message: Waiting for access to metadata...
2025/07/22 21:26:53Z: Message: Meta-data is now available.
2025/07/22 21:26:53Z: AMI Origin Version: 2024.12.13
2025/07/22 21:26:53Z: AMI Origin Name: Windows_Server-2022-English-Full-Base
2025/07/22 21:26:53Z: OS: Microsoft Windows NT 10.0.20348
2025/07/22 21:26:53Z: OsVersion: 10.0
2025/07/22 21:26:53Z: OsProductName: Windows Server 2022 Datacenter
2025/07/22 21:26:53Z: OsBuildLabEx: 20348.1.amd64fre.fe_release.210507-1500
2025/07/22 21:26:53Z: OsCurrentBuild: 20348
2025/07/22 21:26:53Z: OsReleaseId: 2009
2025/07/22 21:26:53Z: Language: en-US
2025/07/22 21:26:53Z: TimeZone: UTC
2025/07/22 21:26:53Z: Offset: UTC +0000
2025/07/22 21:26:53Z: Launch: EC2 Launch v2.2.63
2025/07/22 21:26:53Z: AMI-ID: ami-1234567890abcdef1
2025/07/22 21:26:53Z: Instance-ID: i-1234567890abcdef0
2025/07/22 21:26:54Z: Instance Type: t3.xlarge
2025/07/22 21:26:54Z: Driver: AWS NVMe Driver v1.6.0.35
2025/07/22 21:26:54Z: SubComponent: 1.6.0.35; EnableSCSIPersistentReservations: 0
2025/07/22 21:26:54Z: Driver: AWS PV Driver Package v8.5.0
2025/07/22 21:26:55Z: Driver: Amazon Elastic Network Adapter v2.8.0.0
2025/07/22 21:26:55Z: HOSTNAME: EC2AMAZ-9FJG5CC
2025/07/22 21:26:55Z: RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
2025/07/22 21:26:55Z: RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
2025/07/22 21:26:56Z: SSM: Amazon SSM Agent v3.3.2746.0
2025/07/22 21:26:57Z: User data format: no_user_data
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentCommandErrorCode=1
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentErrorLocation=execute_windows.go:410
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/22 21:26:57Z: Message: Windows is Ready to use
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...}
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...}
```
### EC2Messages du journal de la console Lancer la v2
Vous trouverez ci-dessous une liste de tous les messages du journal de la console EC2 Launch v2.
```
Error EC2Launch service is stopping. {error message}
```
Détails de l’erreur de service arrêté :
+ `Error setting up EC2Launch agent folders`
+ `See instance logs for detail`
+ `Error stopping service`
+ `Error initializing service`
```
Windows sysprep configuration complete
```
```
Invalid administrator username: {invalid username}
```
```
Invalid administrator password
Username: {username}
Password: {encrypted password}
```
Le message suivant est un bloc d’informations contenant les détails de l’AMI :
```
AMI Origin Version: {amiVersion}
AMI Origin Name: {amiName}
Microsoft Windows NT {currentVersion}.{currentBuildNumber}
OsVersion: {currentVersion}
OsProductName: {productName}
OsBuildLabEx: {buildLabEx}
OsCurrentBuild: {currentBuild}
OsReleaseId: {releaseId}
Language: {language}
TimeZone: {timeZone}
Offset: UTC {offset}
Launch agent: EC2Launch {BuildVersion}
AMI-ID: {amiId}
Instance-ID: {instanceId}
Instance Type: {instanceType}
HOSTNAME: {computer name}
RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
SqlServerBilling: {sql billing}
SqlServerInstall: {sql patch leve, edition type}
Driver: AWS NVMe Driver {version}
Driver: Inbox NVMe Driver {version}
Driver: AWS PV Driver Package {version}
SSM: Amazon SSM Agent {version}
AWS VSS Version: {version}
```
```
Windows sysprep configuration complete.
Windows is being configured. 'SysprepState is {state}'
Windows is still being configured. 'SysprepState is {state}'
Windows is Ready to use
Waiting for access to metadata...
Meta-data is now available.
Metadata is not available for this instance.
Timed out waiting for access to metadata.
User data format: {format}
```
Les messages de télémétrie EC2Launch v2 incluent les valeurs des propriétés de télémétrie de lancement. À partir de la version 2.2.63, les données de télémétrie de l’agent EC2 sont formatées sous forme d’objet JSON :
```
EC2LaunchTelemetry: {telemetry property}
```
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
# EC2Historique des versions de Launch v2
**Topics**
+ [EC2Historique des versions de Launch v2](#ec2launchv2-version-history)
## EC2Historique des versions de Launch v2
Pour vous assurer que le dernier agent de lancement est installé, consultez la section [Installez la dernière version de EC2 Launch v2](ec2launch-v2-install.md). Vous pouvez recevoir des notifications lorsque de nouvelles versions de l'agent EC2 Launch v2 sont publiées. Pour de plus amples informations, veuillez consulter [Abonnez-vous aux notifications de l'agent de lancement EC2 Windows](launch-agents-subscribe-notifications.md).
Le tableau suivant décrit les versions publiées de EC2 Launch v2.
| Version | Détails | Date de publication |
| --- | --- | --- |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 mars 2026 |
| 2,3,237 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 25 février 2026 |
| 2,3,108 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 29 décembre 2025 |
| 2,3,56 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 novembre 2025 |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15 septembre 2025 |
| 2,2,63 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 29 juillet 2025 |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 14 mai 2025 |
| 2,0.2107 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 27 mars 2025 |
| 2,0,2081 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 février 2025 |
| 2,0,2046 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 octobre 2024 |
| 2,0,1981 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 août 2024 |
| 2,0,1948 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 1 juillet 2024 |
| 2,0,1924 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10 juin 2024 |
| 2,0,114 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 juin 2024 |
| 2,0,1881 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 mai 2024 |
| 2,0,1815 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 mars 2024 |
| 2,0,1739 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 17 janvier 2024 |
| 2,0.1702 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 janvier 2024 |
| 2,0,1643 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 octobre 2023 |
| 2,0.1580 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 septembre 2023 |
| 2,0,1521 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 juillet 2023 |
| 2,0.1303 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 mai 2023 |
| 2,0.1245 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 mars 2023 |
| 2,0.1173 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 février 2023 |
| 2,0.1121 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 janvier 2023 |
| 2,0.1082 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7 décembre 2022 |
| 2,0.1011 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 11 novembre 2022 |
| 2,0.1009 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 novembre 2022 |
| 2,0.982 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31 octobre 2022 |
| 2,0.863 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 juillet 2022 |
| 2,0,698 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 30 janvier 2022 |
| 2,0,674 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15 novembre 2021 |
| 2,0,651 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7 octobre 2021 |
| 2,0,592 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31 août 2021 |
| 2,0.548 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 août 2021 |
| 2,0,470 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 20 juillet 2021 |
| 2.0.285 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 mars 2021 |
| 2.0.207 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 2 février 2021 |
| 2.0.160 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 décembre 2020 |
| 2.0.153 | Ajoute la fonctionnalité Sysprep dans. UserData | 3 novembre 2020 |
| 2.0.146 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 octobre 2020 |
| 2.0.124 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10 septembre 2020 |
| 2.0.104 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 12 août 2020 |
| 2.0.0 | Première version. | 30 juin 2020 |