

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

# Installa la versione più recente di EC2 Launch v2
<a name="ec2launch-v2-install"></a>

Puoi utilizzare uno dei seguenti metodi per installare l'agente EC2Launch v2 sulla tua istanza EC2:
+ Scarica l'agente da Amazon S3 e installalo con Windows. PowerShell Per il download URLs, consulta[EC2Avvia i download della versione 2 su Amazon S3](#lv2-download-s3).
+ Installazione con SSM Distributor
+ Installazione a partire da un componente di EC2 Image Builder quando si crea un'immagine personalizzata.
+ Avvia l'istanza da un'AMI con EC2 Launch v2 preinstallato.

**avvertimento**  
AmazonEC2Launch.msi disinstalla le versioni precedenti dei servizi di lancio EC2, come EC2 Launch (v1) e Config. EC2

Per l'installazione, seleziona la scheda corrispondente al tuo metodo preferito.

------
#### [ PowerShell ]

Per installare la versione più recente dell'agente EC2 Launch v2 con Windows, segui questi passaggi. PowerShell

1. Crea la tua directory locale.

   ```
   New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
   ```

1. Imposta l'URL per la posizione di download. Esegui il comando seguente con l'URL Amazon S3 che utilizzerai. Per il download URLs, vedi [EC2Avvia i download della versione 2 su Amazon S3](#lv2-download-s3)

   ```
   $Url = "Amazon S3 URL/AmazonEC2Launch.msi"
   ```

1. Utilizza il seguente comando composito per scaricare l'agente e avviare l'installazione 

   ```
   $DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
   Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
   msiexec /i "$DownloadFile"
   ```
**Nota**  
Se ricevi un errore durante il download del file e utilizzi Windows Server 2016 o versioni precedenti, potrebbe essere necessario abilitare TLS 1.2 per il tuo PowerShell terminale. Puoi abilitare TLS 1.2 per la PowerShell sessione corrente con il seguente comando e riprovare:  

   ```
   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   ```

1. Il **msiexec** comando installa EC2 Launch v2 nella seguente posizione sulle istanze di Windows Server:. `%ProgramFiles%\Amazon\EC2Launch` Per verificare che l'installazione sia stata eseguita, è possibile verificare il file system locale dell'istanza.

------
#### [ AWS Systems Manager Distributor ]

Per configurare gli aggiornamenti automatici per EC2 Launch v2 con AWS Systems Manager Quick Setup, vedi. [Installazione e aggiornamento automatici con Configurazione rapida di Distributor](#lv2-distributor-quick-setup) 

È anche possibile eseguire un'installazione una tantum del pacchetto `AWSEC2Launch-Agent` da AWS Systems Manager Distributor. Per istruzioni su come installare un pacchetto da System Manager Distributor, consulta [Installazione o pacchetti di aggiornamento](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) nella *AWS Systems Manager Guida per l'utente*.

------
#### [ EC2 Image Builder component ]

Quando si costruisce un'immagine personalizzata con EC2 Image Builder, è possibile installare il componente `ec2launch-v2-windows`. Per istruzioni su come creare un'immagine personalizzata con EC2 Image Builder, vedi [Creazione di una pipeline di immagini utilizzando la procedura guidata della console EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) nella*Guida per l'utente di EC2 Image Builder*.

------
#### [ AMI ]

EC2Launch v2 è preinstallato AMIs per impostazione predefinita sui sistemi operativi Windows Server 2022 e versioni successive:
+ Windows\$1Server- -Inglese-Full-Base *version*
+ Windows\$1Server- *version* -Inglese-Core-Base
+ Windows\$1Server- *version* -English-Core-EKS\$1Optimized
+ Windows Server con *version* AMIs tutte le altre lingue
+ Windows Server *version* AMIs con SQL installato

EC2Launch è inoltre preinstallato sulle seguenti AMI Windows Server. Puoi trovare queste AMI dalla console Amazon EC2 oppure utilizzando il seguente prefisso di ricerca `EC2LaunchV2-` nel  AWS CLI.
+ EC2Launchv2-windows\$1server-2019-English-Core-Base
+ EC2Launchv2-windows\$1server-2019-English-Base completa
+ EC2Avvia v2-windows\$1server-2016-English-Core-Base
+ EC2Avvia v2-Windows\$1Server-2016-English - Base completa

------

## Installa e aggiorna automaticamente Launch v2 con Distributor Quick Setup EC2 AWS Systems Manager
<a name="lv2-distributor-quick-setup"></a>

Con AWS Systems Manager Distributor Quick Setup, puoi configurare gli aggiornamenti automatici per EC2 Launch v2. Il processo seguente configura un'associazione Systems Manager sull'istanza che aggiorna automaticamente l'agente EC2 Launch v2 con una frequenza specificata dall'utente. L'associazione creata da Distributor Quick Setup può includere istanze all'interno di una regione Account AWS and o istanze all'interno di un'organizzazione. AWS Per ulteriori informazioni sulla configurazione di un'organizzazione, consultare [Tutorial: creazione e configurazione di un'organizzazione](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html) nella *Guida per l'utente di AWS Organizations *.

Prima di iniziare, è necessario assicurarsi che le istanze soddisfino tutti i prerequisiti.

### Prerequisiti
<a name="lv2-distributor-quickset-prereq"></a>

Per configurare aggiornamenti automatici con Configurazione rapida di Distributor, le istanze devono soddisfare i seguenti prerequisiti.
+ Hai almeno un'istanza in esecuzione che supporta EC2 Launch v2. Visualizzare i sistemi operativi supportati per [EC2Avvia v2](ec2launch-v2.md).
+ Sono state eseguite tutte le attività di configurazione di Systems Manager sulle istanze. Per ulteriori informazioni, consulta [Configurazione di Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html) nella *Guida per l'utente di AWS Systems Manager *.
+ EC2Launch v2 deve essere l'unico agente di lancio installato sull'istanza. Se è stato installato più di un agente di avvio, la configurazione di Configurazione rapida di Distributor non andrà a buon fine. Prima di configurare EC2 Launch v2 con un Distributor Quick Setup, disinstalla gli agenti di EC2 avvio EC2 Config o Launch v1, se esistenti.

### Configura Distributor Quick Setup per Launch v2 EC2
<a name="lv2-distributor-quickset-config"></a>

[Per creare una configurazione per EC2 Launch v2 con Distributor Quick Setup, utilizza le seguenti impostazioni quando completi i passaggi per la distribuzione del pacchetto Distributor:](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html)
+ **Pacchetti software:** agente Amazon EC2 Launch v2.
+ **Frequenza di aggiornamento:** selezionare una frequenza dall'elenco.
+ **Destinazioni:** scegliere tra le opzioni di implementazione disponibili.

Per verificare lo stato della configurazione, accedere alla scheda **Configurazioni** di Configurazione rapida di Systems Manager nella Console di gestione AWS.

1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Nel pannello di navigazione, scegli **Configurazione rapida**.

1. Nella scheda **Configurazioni**, selezionare la riga associata alla configurazione creata. Nella scheda **Configurazioni** è presente un elenco delle configurazioni con un riepilogo dei dettagli principali, come **Regione**, **Stato dell'implementazione** e **Stato associazione**.
**Nota**  
Il nome dell'associazione per ogni configurazione di EC2 Launch v2 Distributor inizia con il seguente prefisso:. `AWS-QuickSetup-Distributor-EC2Launch-Agent-`

1. Per visualizzare i dettagli, selezionare la configurazione e scegliere **Visualizza dettagli**.

Per ulteriori informazioni e procedure di risoluzione dei problemi, consultare [Risoluzione dei problemi dei risultati di Configurazione rapida](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-results-troubleshooting.html) nella *Guida per l'utente di AWS Systems Manager *.

## EC2Avvia i download della versione 2 su Amazon S3
<a name="lv2-download-s3"></a>

Per installare la versione più recente di EC2 Launch v2, scarica il programma di installazione dal seguente percorso:
+ [https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi](https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi)

## Configurazione delle opzioni di installazione
<a name="lv2-configure-install"></a>

Quando installi o aggiorni EC2 Launch v2, puoi configurare le opzioni di installazione con la finestra di dialogo di installazione di EC2 Launch v2 o con il **msiexec** comando in una shell a riga di comando.

La prima volta che il programma di installazione di EC2 Launch v2 viene eseguito su un'istanza, inizializza le impostazioni del Launch Agent sull'istanza come segue:
+ Crea il percorso locale e vi scrive il file dell'agente di avvio. Questo a volte viene definito come *installazione pulita*.
+ Crea la variabile d'ambiente `EC2LAUNCH_TELEMETRY` se non esiste già e la imposta in base alla tua configurazione.

Per i dettagli della configurazione, seleziona la scheda che corrisponde al metodo di configurazione che utilizzerai.

------
#### [ Amazon EC2Launch Setup dialog ]

Quando installi o aggiorni EC2 Launch v2, puoi configurare le seguenti opzioni di installazione tramite la finestra di dialogo di installazione di Launch v2. EC2Opzioni **Installazione di base**

**Invia telemetria**  
Se includi questa funzionalità nella finestra di configurazione, l'installatore imposta la `EC2LAUNCH_TELEMETRY` variabile di ambiente con un valore di`1`. Se disabiliti **Invia telemetria**, l'installatore imposta la variabile di ambiente su un valore di `0`.  
Quando l'agente EC2 Launch v2 viene eseguito, legge la variabile di `EC2LAUNCH_TELEMETRY` ambiente per determinare se caricare i dati di telemetria. Se il valore è `1`, carica i dati. Altrimenti, non li carica.

**Configurazione di default**  
La configurazione predefinita per EC2 Launch v2 consiste nel sovrascrivere l'agente di avvio locale, se già esistente. La prima volta che esegui un'installazione su un'istanza, la configurazione predefinita esegue un'installazione pulita. Se disattivi la configurazione predefinita nell'installazione iniziale, l'installazione non riesce.  
Se esegui nuovamente l'installazione sull'istanza, puoi disabilitare la configurazione predefinita per eseguire un aggiornamento che non sostituisca il file `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`.

**Esempio: aggiorna EC2 Launch v2 con telemetria**  
L'esempio seguente mostra la finestra di dialogo di configurazione di EC2 Launch v2 configurata per aggiornare l'installazione corrente e abilitare la telemetria. Questa configurazione esegue un'installazione senza sostituire il file di configurazione dell'agente e imposta la `EC2LAUNCH_TELEMETRY` variabile di ambiente al valore `1`.

![\[EC2Avvia la configurazione di aggiornamento v2.\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png)


------
#### [ Command line ]

Quando installi o aggiorni EC2 Launch v2, puoi configurare le seguenti opzioni di installazione con il **msiexec** comando in una shell a riga di comando.`ADDLOCAL`Valori parametri

**Base** (richiesto)  
Installa l'agente di avvio. Se questo valore non è presente nel parametro `ADDLOCAL` l'installazione termina.

**Elimina**  
Quando includi il valore `Clean` nel parametro `ADDLOCAL`, l'installatore scrive il file di configurazione dell'agente nella seguente posizione:`%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`. Se il file di configurazione dell'agente esiste già, lo sovrascrive.  
Se lasci il valore `Clean` al di fuori del parametro `ADDLOCAL`, l'installatore esegue un aggiornamento che non sostituisce il file di configurazione dell'agente.

**Telemetria**  
Se includi il valore `Telemetry` nel parametro `ADDLOCAL`, l'installatore imposta la variabile di ambiente `EC2LAUNCH_TELEMETRY` a un valore di `1`.  
Se lasci il valore `Telemetry` al di fuori del parametro `ADDLOCAL`, l'installatore imposta la variabile di ambiente a valore di `0`.  
Quando l'agente EC2 Launch v2 viene eseguito, legge la variabile di `EC2LAUNCH_TELEMETRY` ambiente per determinare se caricare i dati di telemetria. Se il valore è `1`, carica i dati. Altrimenti, non li carica.

**Esempio: installa Launch v2 con telemetria EC2**

```
& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q
```

------

## Verifica la versione Launch v2 EC2
<a name="lv2-verify-version"></a>

Utilizza una delle seguenti procedure per verificare la versione di EC2 Launch v2 installata sulle tue istanze.



------
#### [ PowerShell ]

Verifica la versione installata di EC2 Launch v2 con Windows PowerShell, come segue.

1. Lancia un'istanza dall'AMI e connettila.

1. Esegui il seguente comando PowerShell per verificare la versione installata di EC2 Launch v2:

   ```
   & "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
   ```

------
#### [ Windows Control Panel ]

Verifica la versione installata di EC2 Launch v2 nel Pannello di controllo di Windows, come segue.

1. Lancia un'istanza dall'AMI e connettila.

1. Apri il Pannello di Controllo e scegli **Programmi e funzionalità**.

1. Nella lista dei programmi installati, cerca `Amazon EC2Launch`. Il numero della versione viene mostrato nella colonna **Version (Versione)**.

------

Per visualizzare gli aggiornamenti più recenti per AWS Windows AMIs, consulta la [cronologia delle versioni di Windows AMI](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html) nel *AWS Windows AMI Reference*.

Per la versione più recente di EC2 Launch v2, vedi[EC2Cronologia delle versioni di Launch v2](ec2launchv2-versions.md#ec2launchv2-version-history).

Puoi ricevere notifiche quando vengono rilasciate nuove versioni del servizio EC2 Launch v2. Per ulteriori informazioni, consulta [Iscriviti alle notifiche di Windows Launch Agent EC2](launch-agents-subscribe-notifications.md).