

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.

# Configuration des paramètres de EC2 Launch v2 pour les instances Windows
<a name="ec2launch-v2-settings"></a>

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
<a name="ec2launch-v2-ui"></a>

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
<a name="ec2launch-v2-cli"></a>

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
<a name="ec2launch-v2-collect-logs"></a>

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
<a name="ec2launch-v2-get-agent-config"></a>

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
<a name="ec2launch-v2-list-volumes"></a>

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
<a name="ec2launch-v2-reset"></a>

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
<a name="ec2launch-v2-run"></a>

Exécute EC2 Launch v2.

**Exemple**

```
ec2launch run
```

**Utilisation**

`ec2launch run [flags]`

**Indicateurs**

`-h`, `--help`

aide pour `run`

### status
<a name="ec2launch-v2-settings-status"></a>

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
<a name="ec2launch-v2-settings-sysprep"></a>

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
<a name="ec2launch-v2-validate"></a>

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
<a name="ec2launch-v2-version"></a>

Obtient la version exécutable.

**Exemple**

```
ec2launch version
```

**Utilisation**

`ec2launch version [flags]`

**Indicateurs**

`-h`, `--help`

aide pour `version`

### fond d’écran
<a name="ec2launch-v2-wallpaper"></a>

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
<a name="lv2-wallpaper-syntax"></a>

```
ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,ipv6Address,instanceSize,availabilityZone,architecture
```

#### Inputs
<a name="lv2-wallpaper-inputs"></a>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
<a name="ec2launch-v2-task-configuration"></a>

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`
<a name="ec2launch-v2-schema-agent-config"></a>

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
<a name="ec2launch-v2-schema-agent-config-doc-structure"></a>

**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`
<a name="ec2launch-v2-example-agent-config"></a>

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
<a name="ec2launch-v2-schema-user-data"></a>

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
<a name="ec2launch-v2-schema-user-data-doc-structure"></a>

**JSON**

```
{
	"version": "1.1",
	"tasks": [
		{
			"task": "string",
			"inputs": {
				...
			},
		},
		...
	]
}
```

**YAML**

```
version: 1.1
tasks:
- task: string
  inputs:
    ...
...
```

#### Exemple : données utilisateur
<a name="ec2launch-v2-example-user-data"></a>

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 :

`<persist>true</persist>`

**Exemple :**

```
<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<persist>true</persist>
```

Vous pouvez spécifier un ou plusieurs PowerShell arguments à l'aide de la `<powershellArguments>` balise. Si aucun argument n'est transmis, EC2 Launch v2 ajoute l'argument suivant par défaut :`-ExecutionPolicy Unrestricted`.

**Exemple :**

```
<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<powershellArguments>-ExecutionPolicy Unrestricted -NoProfile -NonInteractive</powershellArguments>
```

Pour exécuter un script de données utilisateur XML en tant que processus détaché, ajoutez la balise suivante à vos données utilisateur.

`<detach>true</detach>`

**Exemple :**

```
<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<detach>true</detach>
```

**Note**  
La balise detach n’est pas prise en charge sur les agents de lancement précédents.

#### Journal des modifications : données utilisateur
<a name="ec2launch-v2-versions-user-data"></a>

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
<a name="ec2launch-v2-exit-codes-reboots"></a>

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
<a name="ec2launch-v2-sysprep"></a>

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).