

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

# Utilizza l'agente EC2Launch v1 per eseguire attività durante l'avvio dell'istanza EC2 Windows
<a name="ec2launch"></a>

Amazon managed AMIs for Windows Server 2016 e 2019 include un set di script Windows Powershell chiamato EC2 Launch. EC2Launch esegue attività durante l'avvio iniziale dell'istanza. Per informazioni sulle versioni EC2 Launch incluse in AWS Windows AMIs, consulta [AWS Windows AMI Reference](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/windows-amis.html).

**Nota**  
L'agente di avvio più recente per Windows Server 2016 e versioni successive del sistema operativo è EC2 Launch v2, che sostituisce EC2 Config e EC2 Launch e viene preinstallato su AWS Windows Server 2016 e 2019 AMIs con nomi che iniziano con. `EC2LaunchV2-Windows_Server-*` Puoi anche installare e configurare manualmente l’agente su Windows Server 2016 e 2019. Per ulteriori informazioni, consulta [Installa EC2 Launch v2](ec2launch-v2-install.md).  
Per utilizzare EC2 Launch con IMDSv2, la versione deve essere 1.3.2002730 o successiva.

È possibile utilizzare il seguente PowerShell comando di Windows per verificare la versione installata di Launch. EC2

```
Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version
```

## EC2Attività di avvio
<a name="ec2launch-tasks"></a>

EC2Launch esegue le seguenti attività per impostazione predefinita durante l'avvio iniziale dell'istanza:
+ Imposta un nuovo sfondo che esegue il rendering delle informazioni riguardanti l'istanza.
+ Imposta il nome del computer sull' IPv4 indirizzo privato dell'istanza.
+ Invia le informazioni di istanza alla console Amazon EC2.
+ Invia l'impronta del certificato RDP alla console EC2. 
+ Imposta una password casuale per l'account dell'amministratore.
+ Aggiunge i suffissi DNS.
+ Estende in modo dinamico la partizione del sistema operativo per includere qualsiasi spazio non partizionato.
+ Esegue i dati utente (se specificato). Per ulteriori informazioni sulla specifica dei dati utente, consulta [Esegui i comandi quando avvii un'istanza EC2 con l'input dei dati utente](user-data.md).
+  Imposta routing statici persistenti per raggiungere il servizio di metadati e i server AWS KMS . 
**Importante**  
Se da questa istanza viene creata un'AMI personalizzata, i routing vengono acquisiti come parte della configurazione del sistema operativo e qualsiasi nuova istanza avviata dall'AMI avrà gli stessi routing, indipendentemente dal posizionamento della sottorete. Per aggiornare i routing, vedi [Aggiorna i metadata/KMS percorsi per Server 2016 e versioni successive all'avvio di un'AMI personalizzata](ec2launch-sysprep.md#update-metadata-KMS).

Le seguenti attività aiutano a mantenere la compatibilità con le versioni precedenti con il servizio EC2 Config. Puoi anche configurare EC2 Launch per eseguire queste attività durante l'avvio:
+ Inizializzare i volumi EBS secondari.
+ Inviare i log di eventi di Windows ai log della console EC2.
+ Inviare il messaggio *Windows is ready to use (Windows è pronto per l'utilizzo)* alla console EC2.

## EC2Avvia la struttura delle cartelle
<a name="ec2launch-directories"></a>

EC2Launch è installato per impostazione predefinita in Windows Server 2016 e versioni successive AMIs nella directory principale`C:\ProgramData\Amazon\EC2-Windows\Launch`.

**Nota**  
Per impostazione predefinita, Windows nasconde i file e le cartelle in `C:\ProgramData`. Per visualizzare le directory e i file di EC2 Launch, è necessario digitare il percorso in Windows Explorer o modificare le proprietà della cartella per mostrare file e cartelle nascosti.

La directory `Launch` contiene le sottodirectory seguenti.
+ `Scripts`— Contiene PowerShell gli script che compongono EC2 Launch.
+ `Module` - Contiene il modulo per la creazione di script relativi a Amazon EC2. 
+ `Config` - Contiene file di configurazione dello script che si possono personalizzare.
+ `Sysprep` - Contiene risorse Sysprep.
+ `Settings` - Contiene un'applicazione per l'interfaccia utente grafica di Sysprep.
+ `Library`: contiene librerie condivise per gli agenti di avvio di EC2.
+ `Log`: contiene sottodirectory per gli script e i file di log generati dagli script.

## Telemetria
<a name="ec2launch-telemetry"></a>

La telemetria è un'informazione aggiuntiva che aiuta AWS a comprendere meglio i requisiti, diagnosticare i problemi e fornire funzionalità per migliorare l'esperienza con i servizi. AWS 

EC2Avvia la versione `1.3.2003498` e successivamente raccogli dati di telemetria, ad esempio metriche di utilizzo ed errori. Questi dati vengono raccolti dall'istanza Amazon EC2 su cui viene eseguito EC2 Launch. Sono inclusi tutti i Windows di AMIs proprietà di AWS.

Launch raccoglie i seguenti tipi di telemetria: EC2
+ **Informazioni di utilizzo**: comandi dell'agente, metodo di installazione e frequenza di esecuzione pianificata.
+ **Errori e informazioni diagnostiche**: installazione dell'agente ed esecuzione dei codici di errore.

Esempi di dati raccolti:

```
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0
```

La telemetria è abilitata per impostazione predefinita. Puoi disabilitare la raccolta dati di telemetria in qualsiasi momento. Se la telemetria è abilitata, EC2 Launch invia i dati di telemetria senza ulteriori notifiche ai clienti.

Viene registrata la scelta di abilitare o disabilitare la telemetria.

È possibile attivare o disattivare la raccolta di telemetria. La propria selezione per attivare o disattivare la telemetria viene raccolta per garantire l'adesione alla propria opzione di telemetria.

**Visibilità della telemetria**  
Quando la telemetria è abilitata, viene visualizzata nell'output della console Amazon EC2 come segue:

```
2021/07/15 21:44:12Z: Telemetry: <Data>
```

**Disabilitare la telemetria su un'istanza**  
Per disattivare la telemetria impostando una variabile di ambiente di sistema, esegui il comando seguente come amministratore:

```
setx /M EC2LAUNCH_TELEMETRY 0
```

Per disabilitare la telemetria durante l'installazione, eseguire `install.ps1` come riportato:

```
. .\install.ps1 -EnableTelemetry:$false
```

**Topics**
+ [EC2Attività di avvio](#ec2launch-tasks)
+ [EC2Avvia la struttura delle cartelle](#ec2launch-directories)
+ [Telemetria](#ec2launch-telemetry)
+ [Installa la versione più recente di EC2 Launch](ec2launch-download.md)
+ [Configura l'agente EC2 Launch v1 sulla tua istanza di Windows](ec2launch-config.md)
+ [EC2Avvia la cronologia delle versioni](ec2launch-version-details.md)