

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configura l'agente EC2 Launch v1 sulla tua istanza di Windows
<a name="ec2launch-config"></a>

Dopo che l'istanza è stata inizializzata per la prima volta, puoi configurare EC2 Launch in modo che venga eseguita nuovamente ed esegua diverse attività di avvio.

**Topics**
+ [Configurare le attività di inizializzazione](#ec2launch-inittasks)
+ [Pianifica EC2 Launch in modo che venga eseguito a ogni avvio](#run-on-every-boot)
+ [Inizializzazione delle unità e mappatura delle lettere di unità](#ec2launch-mapping)
+ [Inviare i log di eventi di Windows alla console EC2.](#ec2launch-sendlogs)
+ [Inviare il messaggio Windows is ready (Windows è pronto) dopo un avvio riuscito.](#ec2launch-sendwinisready)

## Configurare le attività di inizializzazione
<a name="ec2launch-inittasks"></a>

Specificare le impostazioni nel file `LaunchConfig.json` per attivare o disattivare le seguenti attività di inizializzazione:
+ Imposta il nome del computer sull'indirizzo privato IPv4 dell'istanza.
+ Impostare il monitor in modo che rimanga sempre acceso.
+ Impostare un nuovo sfondo.
+ Aggiungere l'elenco di suffissi DNS.
**Nota**  
Ciò aggiunge una ricerca dei suffissi DNS per il seguente dominio e configura altri suffissi standard. Per ulteriori informazioni sul modo in cui gli agenti di lancio impostano i suffissi DNS, consultare [Configura il suffisso DNS per EC2 gli agenti di avvio di Windows](launch-agents-set-dns.md).  

  ```
  region.ec2-utilities.amazonaws.com
  ```
+ Estendere la dimensione del volume di avvio.
+ Impostare la password amministratore

**Configurare le impostazioni di inizializzazione**

1. Nell'istanza da configurare, aprire il seguente file in un editor di testo: `C:\ProgramData\Amazon\EC2-Windows\Launch\Config\LaunchConfig.json`.

1. Aggiornare le seguenti impostazioni come necessario e salvare le modifiche. Fornire una password in `adminPassword` solo se `adminPasswordtype` è `Specify`.

   ```
   {
   	"setComputerName": false,
   	"setMonitorAlwaysOn": true,
   	"setWallpaper": true,
   	"addDnsSuffixList": true,
   	"extendBootVolumeSize": true,
   	"handleUserData": true,					  
   	"adminPasswordType": "Random | Specify | DoNothing",
   	"adminPassword": "password that adheres to your security policy (optional)"
   }
   ```

   I tipi di password sono definiti come segue:  
`Random`  
EC2Launch genera una password e la crittografa utilizzando la chiave dell'utente. Il sistema disattiva questa impostazione dopo l'avvio dell'istanza in modo che questa password rimanga se l'istanza viene riavviata o arrestata e avviata.  
`Specify`  
EC2Launch utilizza la password specificata in`adminPassword`. Se la password non soddisfa i requisiti di sistema, EC2 Launch genera invece una password casuale. La password viene memorizzata `LaunchConfig.json` come testo non crittografato e viene eliminata dopo che Sysprep ha impostato la password dell'amministratore. EC2Launch crittografa la password utilizzando la chiave dell'utente.  
`DoNothing`  
EC2Launch utilizza la password specificata nel `unattend.xml` file. Se non si indica una password in `unattend.xml`, l'account amministratore viene disattivato.

1. In Windows PowerShell, esegui il comando seguente per pianificare l'esecuzione dello script come operazione pianificata di Windows. Lo script viene eseguito una volta durante l'avvio successivo, poi disabilita la nuova esecuzione di queste attività.

   ```
   C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -Schedule
   ```

## Pianifica EC2 Launch in modo che venga eseguito a ogni avvio
<a name="run-on-every-boot"></a>

Puoi pianificare EC2 Launch in modo che venga eseguito a ogni avvio anziché solo all'avvio iniziale.

Per consentire l'esecuzione di EC2 Launch a ogni avvio: 

1. Apri Windows PowerShell ed esegui il seguente comando:

   ```
   C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -SchedulePerBoot
   ```

1. Oppure, eseguire l'eseguibile con il seguente comando:

   ```
   C:\ProgramData\Amazon\EC2-Windows\Launch\Settings\Ec2LaunchSettings.exe
   ```

   Quindi selezionare `Run EC2Launch on every boot`. Puoi specificare che la tua istanza EC2 `Shutdown without Sysprep` o `Shutdown with Sysprep`.

**Nota**  
Quando abiliti EC2 Launch per l'esecuzione a ogni avvio, alla successiva esecuzione di EC2 Launch si verifica quanto segue:  
Se `AdminPasswordType` è ancora impostato su`Random`, EC2 Launch genererà una nuova password all'avvio successivo. Dopo tale avvio, `AdminPasswordType` viene impostato automaticamente per impedire `DoNothing` a EC2 Launch di generare nuove password agli avvii successivi. Per evitare che EC2 Launch generi una nuova password al primo avvio, imposta manualmente questa opzione `AdminPasswordType` `DoNothing` prima del riavvio.
`HandleUserData` verrà di nuovo impostato su `false` a meno che i dati utente non abbiano `persist` impostato su `true`. Per ulteriori informazioni, consulta [Script di dati utente](user-data.md#user-data-scripts).

## Inizializzazione delle unità e mappatura delle lettere di unità
<a name="ec2launch-mapping"></a>

Specificare le impostazioni nel file `DriveLetterMappingConfig.json` per mappare le lettere di unità nei volumi dell'istanza EC2. Lo script inizializza le unità che non sono già inizializzate e partizionate. Per ulteriori informazioni su come ottenere i dettagli del volume in Windows, consulta la pagina [Get-Volume](https://learn.microsoft.com/en-us/powershell/module/storage/get-volume) nella documentazione di Microsoft.

**Mappatura delle lettere di unità nei volumi**

1. Apri il file `C:\ProgramData\Amazon\EC2-Windows\Launch\Config\DriveLetterMappingConfig.json` in un editor di testo.

1. Specificare le seguenti impostazioni di volume e salvare le modifiche:

   ```
   {
   	"driveLetterMapping": [
   		{
   			"volumeName": "sample volume",
   			"driveLetter": "H"
   		}
   	]
   }
   ```

1. Apri Windows PowerShell e usa il seguente comando per eseguire lo script di EC2 avvio che inizializza i dischi:

   ```
   C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeDisks.ps1
   ```

   Per inizializzare i dischi ogni volta che l'istanza si avvia, aggiungere il contrassegno `-Schedule` come segue:

   ```
   C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeDisks.ps1 -Schedule
   ```

## Inviare i log di eventi di Windows alla console EC2.
<a name="ec2launch-sendlogs"></a>

Specificare le impostazioni nel file `EventLogConfig.json` per inviare i log di eventi di Windows ai log della console EC2.

**Configurazione delle impostazioni per inviare i log di eventi di Windows**

1. Nell'istanza, aprire il file `C:\ProgramData\Amazon\EC2-Windows\Launch\Config\EventLogConfig.json` in un editor di testo.

1. Configurare le seguenti impostazioni di log e salvare le modifiche:

   ```
   {
   	"events": [
   		{
   			"logName": "System",
   			"source": "An event source (optional)",
   			"level": "Error | Warning | Information",
   			"numEntries": 3
   		}
   	]
   }
   ```

1. In Windows PowerShell, esegui il comando seguente in modo che il sistema pianifichi l'esecuzione dello script come attività pianificata di Windows ogni volta che l'istanza viene avviata.

   ```
   C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SendEventLogs.ps1 -Schedule
   ```

   Possono essere necessari tre minuti o più prima che i log compaiano nei log della console EC2.

## Inviare il messaggio Windows is ready (Windows è pronto) dopo un avvio riuscito.
<a name="ec2launch-sendwinisready"></a>

Il servizio EC2Config ha inviato il messaggio «Windows is ready» alla console EC2 dopo ogni avvio. EC2Launch invia questo messaggio solo dopo l'avvio iniziale. Per la retrocompatibilità con il servizio EC2 Config, puoi EC2 pianificare Launch in modo che invii questo messaggio dopo ogni avvio. Nell'istanza, apri Windows PowerShell ed esegui il comando seguente. Il sistema programma l'esecuzione dello script come Windows Scheduled Task.

```
C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SendWindowsIsReady.ps1 -Schedule
```