

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

# Installare la versione più recente di EC2Launch 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 gli URL dei download, consulta [Download di EC2Launch v2 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 la tua istanza da un'AMI su cui è preinstallato EC2Launch v2.

**avvertimento**  
AmazonEC2Launch.msi disinstalla le versioni precedenti dei servizi di lancio di EC2, come EC2Launch (v1) ed EC2Config.

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

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

Per installare la versione più recente dell'agente EC2Launch 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 gli URL dei download, consulta [Download di EC2Launch v2 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 terminale. PowerShell Puoi abilitare TLS 1.2 per la PowerShell sessione corrente con il seguente comando e riprovare:  

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

1. Il comando **msiexec** installa EC2Launch v2 nella seguente posizione nelle istanze 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 EC2Launch v2 con AWS Systems Manager Quick Setup, consulta. [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 ]

Per impostazione predefinita, EC2Launch v2 è preinstallato sulle AMI per i sistemi operativi Windows Server 2022 e successivi:
+ Windows\_Server-{{version}}-English-Full-Base
+ Windows\_Server-{{version}}-English-Core-Base
+ Windows\_Server- - \_Ottimizzato {{version}} English-Core-EKS
+ {{version}}AMI Windows Server con tutte le altre lingue
+ {{version}}AMI Windows Server 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\_Server-2019-English-Core-Base
+ EC2LaunchV2-Windows\_Server-2019-English-Full-Base
+ EC2LaunchV2-Windows\_Server-2016-English-Core-Base
+ EC2LaunchV2-Windows\_Server-2016-English-Full-Base

------

## Installa e aggiorna automaticamente EC2Launch v2 con AWS Systems Manager Configurazione rapida del distributore
<a name="lv2-distributor-quick-setup"></a>

Con AWS Systems Manager Distributor Quick Setup, puoi configurare gli aggiornamenti automatici per EC2Launch v2. La seguente procedura configura Systems Manager Association sull'istanza affinché aggiorni automaticamente l'agente EC2Launch v2 alla frequenza specificata. 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.
+ Deve essere presente almeno una istanza in esecuzione che supporta EC2Launch v2. Visualizzare i sistemi operativi supportati per [EC2Launch 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 avvio 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 EC2Launch v2 con Configurazione rapida Distributor, disinstallare gli agenti di lancio EC2Config o EC2Launch v1, se presenti.

### Impostare Configurazione rapida di Distributor per EC2Launch v2
<a name="lv2-distributor-quickset-config"></a>

Per creare una configurazione per EC2Launch v2 con Configurazione rapida di Distributor, utilizzare le seguenti impostazioni quando si completa la procedura per l'[implementazione del pacchetto Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html):
+ **Pacchetti software:** agente Amazon EC2Launch 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 console all' AWS Systems Manager 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 EC2Launch v2 di 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 *.

## Download di EC2Launch v2 su Amazon S3
<a name="lv2-download-s3"></a>

Per installare la versione più recente di EC2Launch v2, scarica il programma di installazione dai seguenti percorsi:
+ [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>

Durante l'installazione o l'aggiornamento di EC2Launch v2, puoi configurare le opzioni di installazione con la finestra di installazione di EC2Launch v2 o con il **msiexec**comando in una shell a riga di comando.

Alla prima esecuzione su un'istanza di EC2Launch v2, inizializza le impostazioni dell'agente di avvio 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 EC2Launch v2, puoi configurare le seguenti opzioni di installazione tramite la finestra di dialogo di installazione di EC2Launch v2.**Installazione di base** options

**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 EC2Launch v2 è in esecuzione, legge la`EC2LAUNCH_TELEMETRY` variabile di ambiente per determinare se caricare dati di telemetria. Se il valore è `1`, carica i dati. Altrimenti, non li carica.

**Configurazione di default**  
La configurazione predefinita per EC2Launch 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: installazione di EC2Launch v2 con telemetria**  
L'esempio seguente mostra la finestra di configurazione di EC2Launch 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`.

![Configurazione dell'aggiornamento EC2Launch v2.](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png)


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

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

**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 EC2Launch v2 è in esecuzione, legge la`EC2LAUNCH_TELEMETRY` variabile di ambiente per determinare se caricare dati di telemetria. Se il valore è `1`, carica i dati. Altrimenti, non li carica.

**Esempio: installazione di EC2Launch v2 con telemetria**

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

------

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

Utilizzare la procedura seguente per verificare la versione di EC2Launch v2 installata sulle istanze.



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

Verifica la versione installata di EC2Launch 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 EC2Launch v2:

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

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

Verifica la versione installata di EC2Launch 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 le AMI AWS Windows, 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 EC2Launch v2, consulta [Cronologia delle versioni di EC2Launch v2](ec2launchv2-versions.md#ec2launchv2-version-history).

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