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 v2 per eseguire attività durante l'avvio dell'istanza EC2 Windows
Tutte le istanze supportate di Amazon EC2 avviate AWS da Windows Server 2022 e Windows Server AMIs 2025 includono EC2 l'agente `EC2Launch.exe` di avvio Launch v2 () per impostazione predefinita. Forniamo inoltre a Windows Server 2016 e 2019 AMIs EC2 Launch v2 installato come agente di avvio predefinito. Questi AMIs sono forniti in aggiunta a Windows Server 2016 e 2019 AMIs che includono EC2 Launch v1. Puoi cercare Windows AMIs che includono EC2 Launch v2 per impostazione predefinita inserendo il seguente prefisso nella ricerca dalla **AMIs**pagina della console Amazon EC2:. `EC2LaunchV2-Windows_Server-*`
Per confrontare le funzionalità della versione dell'agente di avvio, consulta. [Confronta gli agenti di EC2 lancio di Amazon](configure-launch-agents.md#ec2launch-agent-compare)
EC2Launch v2 esegue attività durante l'avvio dell'istanza e viene eseguito se un'istanza viene interrotta e successivamente avviata o riavviata. EC2Launch v2 può anche eseguire attività su richiesta. Alcune di queste attività sono abilitate automaticamente, mentre altre devono essere abilitate manualmente. Il servizio EC2 Launch v2 supporta tutte le funzionalità di EC2 Config EC2 e Launch.
Questo servizio utilizza un file di configurazione per controllarne il funzionamento. Puoi aggiornare il file di configurazione utilizzando uno strumento grafico o modificandolo direttamente come un singolo file .yml (`agent-config.yml`). Per ulteriori informazioni sulle posizioni dei file, consulta [EC2Launch v2: struttura di directory](#ec2launch-v2-directory).
EC2Launch v2 pubblica i registri degli eventi di Windows per aiutarti a risolvere gli errori e impostare i trigger. Per ulteriori informazioni, consulta [Log di eventi di Windows](ec2launchv2-troubleshooting.md#ec2launchv2-windows-event-logs).
**Versioni supportate del sistema operativo**
L'agente EC2 Launch v2 supporta le seguenti versioni del sistema operativo (OS) Windows Server:
+ Windows Server 2025
+ Windows Server 2022
+ Windows Server 2019 (canale di manutenzione a lungo termine e canale semestrale)
+ Windows Server 2016
**Attività che vengono eseguite per impostazione predefinita**
Per impostazione predefinita, l'agente EC2 Launch v2 esegue le seguenti attività una sola volta durante l'avvio iniziale dell'istanza. Le attività vengono organizzate in base all’ordine in cui vengono eseguite nella fase di avvio.
Fase di `Boot`
+ extendRootPartition
Fase di `PreReady`
+ activateWindows
+ setDnsSuffix
+ setAdminAccount
+ setWallpaper
Fase di `PostReady`
+ startSsm
## EC2Concetti di Launch v2
I seguenti concetti sono utili da comprendere quando si considera EC2 Launch v2.
**agent-config**
`agent-config`è un file che si trova nella cartella di configurazione di Launch v2. EC2 Include la configurazione per l'avvio, la rete e PostReady le fasi. PreReady Questo file viene utilizzato per specificare la configurazione di un'istanza per le attività che devono essere eseguite quando l'AMI viene avviata per la prima volta o per le volte successive.
Per impostazione predefinita, l'installazione di EC2 Launch v2 installa un `agent-config` file che include le configurazioni consigliate utilizzate in Amazon Windows standard. AMIs Puoi aggiornare il file di configurazione per modificare l'esperienza di avvio predefinita per l'AMI specificata da EC2 Launch v2. Per ulteriori informazioni sulle posizioni dei file, consulta [EC2Launch v2: struttura di directory](#ec2launch-v2-directory).
**Frequency** (Frequenza)
La frequenza delle attività stabilisce quando le attività devono essere eseguite a seconda del contesto di avvio. La maggior parte delle attività ha una sola frequenza consentita. È possibile specificare una frequenza per le attività `executeScript`.
Vedrai le seguenti frequenze nella [EC2Avvia la configurazione delle attività v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Una volta: l'attività viene eseguita una volta, quando l'AMI viene avviata per la prima volta (Sysprep terminato).
+ Sempre: l'attività viene eseguita ogni volta che viene attivato l'agente di avvio. L'agente di avvio viene eseguito quando:
+ un'istanza viene avviata o riavviata
+ viene eseguito il servizio EC2 Launch
+ viene richiamato `EC2Launch.exe run`
**Fase**
Una fase è un raggruppamento logico di attività eseguite dall'agente EC2 Launch v2. Alcune attività possono essere eseguite solo in una fase specifica. Altre possono essere eseguite in più fasi. Quando utilizzi `agent-config.yml`, è necessario specificare un elenco di fasi e un elenco di attività da eseguire all'interno di ciascuna fase.
Il servizio esegue le fasi nel seguente ordine:
Fase 1: Avvio
Fase 2: Rete
Fase 3: PreReady
Windows è pronto
Al termine della PreReady fase, il servizio invia il `Windows is ready` messaggio alla console Amazon EC2.
Fase 4: PostReady
I dati dell'utente vengono eseguiti durante la *PostReady*fase. Alcune versioni degli script vengono eseguite prima della *PostReady*fase del `agent-config.yml` file e altre dopo, come segue:
Prima di `agent-config.yml`
+ Versione 1.1 dei dati utente in YAML
+ Dati utente XML
Dopo di `agent-config.yml`
+ Dati utente YAML versione 1.0 (versione legacy per compatibilità con le versioni precedenti)
Per le fasi e attività di esempio, consulta [Ad esempio: `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config).
Quando utilizzi i dati utente, devi specificare un elenco di attività per l'esecuzione dell'agente di avvio. La fase è implicita. Per le attività di esempio, consulta [Esempio: dati utente](ec2launch-v2-settings.md#ec2launch-v2-example-user-data).
EC2Launch v2 esegue l'elenco delle attività nell'ordine specificato nei `agent-config.yml` e nei dati utente. Le fasi vengono eseguite in sequenza. La fase successiva inizia dopo il completamento della fase precedente. Anche le attività vengono eseguite in sequenza.
**Attività**
Puoi richiamare un'attività per eseguire un'operazione su un'istanza. Puoi configurare le attività nel file `agent-config.yml` o tramite i dati utente. Per un elenco delle attività disponibili per EC2 Launch v2, vedi Attività di [EC2Launch v2](#ec2launch-v2-tasks). Per lo schema di configurazione delle attività e informazioni dettagliate, consulta [EC2Avvia la configurazione delle attività v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
**Dati utente**
I dati utente sono dati configurabili quando si avvia un'istanza. Puoi aggiornare i dati utente per modificare dinamicamente la configurazione personalizzata AMIs o AMIs quickstart. EC2Launch v2 supporta una lunghezza di input dei dati utente di 60 kB. I dati utente includono solo lo UserData stage e pertanto vengono eseguiti dopo il `agent-config` file. È possibile immettere i dati utente quando si avvia un'istanza utilizzando la procedura guidata di avvio dell'istanza, oppure è possibile modificare i dati utente dalla console EC2. Per informazioni sull'utilizzo dei dati utente, consulta [In che modo Amazon EC2 gestisce i dati utente per le istanze Windows](user-data.md#ec2-windows-user-data).
## EC2Panoramica delle attività di Launch v2
EC2Launch v2 può eseguire le seguenti attività a ogni avvio:
+ Impostare un nuovo sfondo personalizzato e facoltativo che esegue il rendering delle informazioni riguardanti l'istanza.
+ Impostare gli attributi per l'account amministratore creato nel computer locale.
+ Aggiungere i suffissi DNS all'elenco dei suffissi di ricerca. All'elenco vengono aggiunti solo i suffissi che non esistono già.
+ Impostare le lettere di unità per eventuali volumi aggiuntivi ed estenderli per utilizzare lo spazio disponibile.
+ Scrivi i file dalla configurazione sul disco.
+ Esegui gli script specificati nel file di configurazione di EC2 Launch v2 o da. `user-data` Gli script da `user-data` possono essere in testo semplice o compressi e forniti in formato base64.
+ Eseguire un programma con argomenti specificati.
+ Impostare il nome del computer.
+ Inviare le informazioni sull'istanza alla console Amazon EC2.
+ Inviare l'impronta del certificato RDP alla console Amazon EC2.
+ Estendere in modo dinamico la partizione del sistema operativo per includere qualsiasi spazio non partizionato.
+ Eseguire i dati utente. Per ulteriori informazioni sulla specifica dei dati utente, consulta [EC2Avvia la configurazione delle attività v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Imposta istradamenti statici non persistenti per raggiungere il servizio metadati e i server AWS KMS .
+ Impostare le partizioni non di avvio su `mbr` o `gpt`.
+ Avviare il servizio Systems Manager dopo Sysprep.
+ Ottimizzare le impostazioni ENA.
+ Abilitare OpenSSH per le versioni successive di Windows.
+ Abilitare i frame jumbo.
+ Impostare Sysprep per l'esecuzione con Launch v2. EC2
+ Pubblicare i log di eventi di Windows.
## EC2Launch v2: struttura di directory
EC2Launch v2 deve essere installato nelle seguenti directory:
+ Binari del servizio: `%ProgramFiles%\Amazon\EC2Launch`
+ Dati del servizio (impostazioni, file di log e file di stato): `%ProgramData%\Amazon\EC2Launch`
**Nota**
Per impostazione predefinita, Windows nasconde i file e le cartelle in `C:\ProgramData`. Per visualizzare le directory e i file di EC2 Launch v2, è necessario immettere il percorso in Windows Explorer o modificare le proprietà della cartella per mostrare file e cartelle nascosti.
La directory `%ProgramFiles%\Amazon\EC2Launch` contiene binari e librerie di supporto. Include le seguenti sottodirectory:
+ `settings`
+ `EC2LaunchSettingsUI.exe`: interfaccia utente per la modifica del file `agent-config.yml`
+ `YamlDotNet.dll`: DLL per supportare alcune operazioni nell’interfaccia utente
+ `tools`
+ `ebsnvme-id.exe`: strumento per esaminare i metadati dei volumi EBS nell’istanza
+ `AWSAcpiSpcrReader.exe`: strumento per determinare la porta COM corretta da utilizzare
+ `EC2LaunchEventMessage.dll`— DLL per supportare la registrazione degli eventi di Windows per Launch EC2
+ `service`
+ `EC2LaunchService.exe`: eseguibile del servizio Windows che viene avviato quando l’agente di avvio viene attivato come servizio
+ `EC2AgentTelemetry.dll`: DLL per il supporto della telemetria degli agenti EC2
+ `EC2Launch.exe`— eseguibile principale di EC2 Launch
+ `EC2LaunchAgentAttribution.txt`: attribuzione per il codice utilizzato in EC2 Launch
La directory `%ProgramData%\Amazon\EC2Launch` contiene le sottodirectory seguenti. Tutti i dati prodotti dal servizio, inclusi i log, la configurazione e lo stato, vengono memorizzati in questa directory.
+ `config` – Configurazione
Il file di configurazione del servizio è memorizzato in questa directory come `agent-config.yml`. Questo file può essere aggiornato per modificare, aggiungere o rimuovere le attività predefinite eseguite dal servizio. L'autorizzazione per creare file in questa directory è limitata all'account di amministratore per evitare l'escalation dei privilegi.
+ `log` – Log delle istanze
I log relativi al servizio (`agent.log`), alle prestazioni (`bench.log`) e alla telemetria (`telemetry.log`) sono archiviati in questa directory. Quando `agent.log` raggiunge una dimensione di 1 MB, viene ruotato automaticamente e viene creato un file di backup con un formato timestamp (ad esempio,). `agent-2026-03-02T18-56-39.188.log` Viene mantenuto un solo file di registro di backup alla volta.
+ `state` – Dati sullo stato del servizio
Qui viene memorizzato lo stato utilizzato dal servizio per determinare quali attività devono essere eseguite. Esiste un file `.run-once` che indica se il servizio è già stato eseguito dopo Sysprep (quindi le attività con la frequenza di una volta vengono ignorate all'esecuzione successiva). Questa sottodirectory include `state.json` e `previous-state.json` per tenere traccia dello stato di ogni attività.
+ `sysprep` – Sysprep
Questa directory contiene i file utilizzati per determinare le operazioni eseguite da Sysprep quando crea un'AMI di Windows personalizzata che può essere riutilizzata.
+ `wallpaper` – Sfondo
Queste immagini di sfondo sono memorizzate in questa directory.
## Telemetria
La telemetria è un'informazione aggiuntiva che consente di AWS comprendere meglio i requisiti, diagnosticare i problemi e fornire funzionalità con cui migliorare l'esperienza dell'utente. Servizi AWS
EC2Avvia la versione v2 `2.1.592` 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 v2. Sono inclusi tutti i Windows di AMIs proprietà di. AWS
I seguenti tipi di telemetria vengono raccolti da EC2 Launch v2:
+ **Informazioni di utilizzo**: comandi dell'agente, metodo di installazione e frequenza di esecuzione pianificata.
+ **Errori e informazioni diagnostiche** – Codici di errore di installazione dell'agente, esecuzione dei codici di errore e stack di chiamate di errore.
Esempi di dati raccolti dalla versione 2.0.592 alla versione 2.1.1:
```
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentCommandErrorCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/18 22:38:52Z: EC2LaunchTelemetry: AgentErrorLocation=addroutes.go:49
```
A partire dalla versione 2.2.63, i dati telemetrici dell’agente EC2 sono formattati come oggetto JSON:
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
La telemetria è abilitata per impostazione predefinita. Puoi disabilitare la raccolta dati di telemetria in qualsiasi momento.
**Disabilitare la telemetria su un'istanza**
Per disattivare la telemetria per una singola istanza, puoi impostare una variabile di ambiente di sistema oppure utilizzare MSI per modificare l'installazione.
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 utilizzando MSI, esegui il comando seguente dopo il [download dell'MSI](ec2launch-v2-install.md).
```
msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
```
**Topics**
+ [EC2Concetti di Launch v2](#ec2launch-v2-concepts)
+ [EC2Panoramica delle attività di Launch v2](#ec2launch-v2-tasks)
+ [EC2Launch v2: struttura di directory](#ec2launch-v2-directory)
+ [Telemetria](#ec2launch-v2-telemetry)
+ [Installa la versione più recente di EC2 Launch v2](ec2launch-v2-install.md)
+ [Configura le impostazioni di EC2 Launch v2 per le istanze di Windows](ec2launch-v2-settings.md)
+ [Definizioni delle attività per le attività di EC2 avvio di Launch v2](ec2launch-v2-task-definitions.md)
+ [Risolvi i problemi con l'agente EC2 Launch v2](ec2launchv2-troubleshooting.md)
+ [EC2Cronologie delle versioni di Launch v2](ec2launchv2-versions.md)
# Installa la versione più recente di EC2 Launch v2
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
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
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
[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
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
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
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).
# Configura le impostazioni di EC2 Launch v2 per le istanze di Windows
Questa sezione contiene informazioni su come configurare le impostazioni per EC2 Launch v2.
**Topics**
+ [Modifica le impostazioni utilizzando la finestra di dialogo delle impostazioni di EC2 Launch v2](#ec2launch-v2-ui)
+ [Configurare EC2 Launch v2 utilizzando la CLI](#ec2launch-v2-cli)
+ [EC2Avvia la configurazione delle attività v2](#ec2launch-v2-task-configuration)
+ [EC2Avvia i codici di uscita v2 e riavvia](#ec2launch-v2-exit-codes-reboots)
+ [EC2Avvia v2 e Sysprep](#ec2launch-v2-sysprep)
## Modifica le impostazioni utilizzando la finestra di dialogo delle impostazioni di EC2 Launch v2
La procedura seguente descrive come utilizzare la finestra di dialogo delle impostazioni di EC2 Launch v2 per abilitare o disabilitare le impostazioni.
**Nota**
Se configuri in modo errato le attività personalizzate nel file agent-config.yml e tenti di aprire la finestra di dialogo delle impostazioni di Amazon EC2 Launch, riceverai un errore. Per un esempio di schema, consulta la sezione [Ad esempio: `agent-config.yml`](#ec2launch-v2-example-agent-config).
1. Avviare l'istanza Windows e connettersi a essa.
1. **Dal menu Start, scegli **Tutti i programmi**, quindi vai alle impostazioni di avvio. EC2** Prima di scegliere **Arresta con Sysprep** o **Arresta senza Sysprep**, assicurati di salvare tutte le modifiche che vuoi applicare quando esegui l’arresto.
![\[Applicazione delle impostazioni di EC2 Launch.\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/images/ec2launchv2-settings.png)
1. Nella scheda **Generale** della finestra di dialogo **delle impostazioni di EC2 avvio**, puoi abilitare o disabilitare le seguenti impostazioni.
1. **Set Computer Name (Imposta il nome del computer)**
Se questa impostazione viene abilitata (per impostazione predefinita è disabilitata), il nome host attuale viene confrontato con il nome host desiderato ad ogni avvio. Se i nomi host non corrispondono, il nome host viene reimpostato e il sistema si riavvia facoltativamente per acquisire il nuovo nome host. Se non viene specificato un nome host personalizzato, viene generato utilizzando l' IPv4 indirizzo privato in formato esadecimale, ad esempio. `ip-AC1F4E6` Per evitare che il nome host esistente venga modificato, non abilitare questa impostazione.
1. **Estendi volume di avvio**
Questa impostazione estende in modo dinamico `Disk 0`/`Volume 0` per includere qualsiasi spazio non partizionato. Ciò può essere utile quando l’istanza viene avviata da un volume root di dimensioni personalizzate.
1. **Imposta account amministratore**
Se abilitata, puoi impostare gli attributi di nome utente e password per l'account amministratore creato nel computer locale. Se questa caratteristica non è abilitata, non viene creato un account amministratore nel sistema dopo Sysprep. Fornire una password in `adminPassword` solo se `adminPasswordtype` è `Specify`.
I tipi di password sono definiti come segue:
1. `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.
1. `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 in `agent-config.yml` come testo non crittografato e viene cancellata dopo che Sysprep ha impostato la password amministratore. EC2Launch crittografa la password utilizzando la chiave dell'utente.
1. `Do not set`
EC2Launch utilizza la password specificata nel file unattend.xml. Se non specifichi una password in unattend.xml, l'account amministratore viene disabilitato.
1. **Avvia servizio SSM**
Se selezionato, il servizio Systems Manager è abilitato a iniziare a seguire Sysprep. EC2Launch v2 esegue tutte le attività descritte in [precedenza](ec2launch-v2.md#ec2launch-v2-tasks) e l'agente SSM elabora le richieste per le funzionalità di Systems Manager, come Run Command e State Manager.
È possibile utilizzare Run Command per aggiornare le istanze esistenti in modo da utilizzare la versione più recente del servizio EC2 Launch v2 e SSM Agent. Per ulteriori informazioni, consulta [Update SSM Agent using Run Command](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command-tutorial-update-software.html) nella *Guida per l’utente di AWS Systems Manager*.
1. **Ottimizza ENA**
Se selezionate, le impostazioni ENA sono configurate per garantire che le impostazioni ENA Receive Side Scaling e Receive Queue Depth siano ottimizzate per. AWS Per ulteriori informazioni, consulta [Configura l’affinità della CPU con Receive Side Scaling](enhanced-networking-os.md#windows-rss-cpu-affinity).
1. **Abilita SSH**
Questa impostazione abilita OpenSSH per consentire l'amministrazione remota del sistema per le versioni successive di Windows.
1. **Abilita frame jumbo**
Seleziona questa opzione per abilitare i frame jumbo. I frame jumbo possono avere effetti indesiderati sulle comunicazioni di rete, quindi assicurati di capire in che modo i frame jumbo influiscono sul tuo sistema prima di attivarli. Per ulteriori informazioni sui frame jumbo, consulta [Frame jumbo (9001 MTU)](network_mtu.md#jumbo_frame_instances).
1. **Preparazione per l'imaging**
Seleziona questa impostazione se vuoi che l'istanza EC2 venga arrestate con o senza Sysprep. **Per eseguire Sysprep con EC2 Launch v2, scegli Shutdown with Sysprep.**
1. Nella scheda **Suffisso DNS** puoi selezionare se aggiungere un elenco di suffissi DNS per la risoluzione DNS dei server in esecuzione in EC2, senza specificare il nome di dominio completo. I suffissi DNS possono contenere le variabili `$REGION` e `$AZ`. All'elenco vengono aggiunti solo i suffissi che non sono già presenti.
![\[Applicazione delle impostazioni di EC2 Launch.\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/images/ec2launchv2-dns.png)
1. Nella scheda **Sfondo**, puoi configurare lo sfondo dell'istanza con un'immagine di sfondo e specificare i dettagli dell'istanza per lo sfondo da visualizzare. Amazon EC2 genera i dettagli ogni volta che effettui l'accesso.
È possibile configurare lo sfondo con i seguenti comandi.
+ **Mostra i dettagli dell'istanza sullo sfondo**: questa casella di controllo attiva o disattiva la visualizzazione dei dettagli dell'istanza sullo sfondo.
+ **Percorso dell'immagine (.jpg)**: specifica il percorso dell'immagine da utilizzare come sfondo.
+ **Seleziona gli attributi da visualizzare sullo sfondo**: seleziona le caselle di controllo relative ai dettagli dell'istanza che desideri visualizzare sullo sfondo. Deseleziona le caselle di controllo dei dettagli dell'istanza selezionati in precedenza che desideri rimuovere dallo sfondo.
+ **Visualizza i tag delle istanze sullo sfondo**: seleziona una delle seguenti impostazioni per visualizzare i tag delle istanze sullo sfondo:
+ **Nessuno**: non visualizzare alcun tag delle istanze sullo sfondo.
+ **Mostra tutti**: visualizza tutti i tag delle istanze sullo sfondo.
+ **Mostra filtrati**: visualizza i tag delle istanze specificati sullo sfondo. Quando selezioni questa impostazione, puoi aggiungere i tag delle istanze che desideri visualizzare sullo sfondo nella casella del **Filtro dei tag delle istanze**.
**Nota**
È necessario abilitare i tag nei metadati per mostrare i tag sullo sfondo. Per ulteriori informazioni sui tag e metadati delle istanze, consulta [Visualizza i tag per le istanze EC2 utilizzando i metadati dell'istanza](work-with-tags-in-IMDS.md).
![\[Scheda Sfondo delle impostazioni di avvio di EC2.\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/images/ec2launchv2-wallpaper-02.png)
1. Nella scheda **Volumi** seleziona se vuoi inizializzare i volumi collegati all'istanza. L'abilitazione imposta le lettere di unità per eventuali volumi aggiuntivi e li estende per utilizzare lo spazio disponibile. Se si seleziona **All (Tutto)** vengono inizializzati tutti i volumi di archiviazione. Se selezioni **Dispositivi** vengono inizializzati solo i dispositivi specificati nell'elenco. Devi specificare immettere il dispositivo per ogni dispositivo da inizializzare. Utilizza i dispositivi elencati sulla console EC2, ad esempio, `xvdb` o `/dev/nvme0n1`. Nell'elenco a discesa vengono visualizzati i volumi di archiviazione collegati all'istanza. Per immettere un dispositivo non collegato all'istanza, immetterlo nel campo di testo.
**Nome**, **Lettera** e **Partizione** sono campi facoltativi. Se per **Partizione** non viene specificato alcun valore, i volumi di archiviazione superiori a 2 TB vengono inizializzati con il tipo di partizione `gpt` e quelli inferiori a 2 TB vengono inizializzati con il tipo di partizione `mbr`. Se i dispositivi sono configurati e un dispositivo non NTFS contiene una tabella di partizione o i primi 4 KB del disco contengono dati, il disco viene ignorato e l'operazione viene registrata.
![\[Applicazione delle impostazioni di EC2 Launch.\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/images/ec2launchv2-volumes.png)
## Configurare EC2 Launch v2 utilizzando la CLI
È possibile utilizzare l'interfaccia a riga di comando (CLI) per configurare le impostazioni di EC2 avvio e gestire il servizio. La sezione seguente contiene descrizioni e informazioni sull'utilizzo dei comandi CLI che è possibile utilizzare per gestire 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)
+ [validate](#ec2launch-v2-validate)
+ [version](#ec2launch-v2-version)
+ [wallpaper](#ec2launch-v2-wallpaper)
### collect-logs
Raccoglie i file di registro per EC2 Launch, comprime i file e li colloca in una directory specificata.
**Esempio**
```
ec2launch collect-logs -o C:\Mylogs.zip
```
**Utilizzo**
`ec2launch collect-logs [flags]`
**Flag**
`-h`, `--help`
aiuto per `collect-logs`
`-o`, `--output string`
percorso dei file di log di output compressi
### get-agent-config
Stampa `agent-config.yml` nel formato specificato (JSON o YAML). Se non viene specificato alcun formato, `agent-config.yml` viene stampato nel formato specificato in precedenza.
**Esempio**
```
ec2launch get-agent-config -f json
```
**Utilizzo**
`ec2launch get-agent-config [flags]`
**Flag**
`-h`, `--help`
aiuto per `get-agent-config`
`-f`, `--format string`
formato di output del file `agent-config`: `json`, `yaml`
### list-volumes
Elenca tutti i volumi di archiviazione collegati all'istanza, inclusi i volumi temporanei ed EBS.
**Esempio**
```
ec2launch list-volumes
```
**Utilizzo**
`ec2launch list-volumes`
**Flag**
`-h`, `--help`
aiuto per `list-volumes`
### reset
L'obiettivo principale di questa attività è reimpostare l'agente per la prossima esecuzione. A tale scopo, il **reset** comando elimina tutti i dati sullo stato dell'agente per EC2 Launch v2 dalla `EC2Launch` directory locale (vedi). [EC2Launch v2: struttura di directory](ec2launch-v2.md#ec2launch-v2-directory) Il ripristino elimina facoltativamente i log di servizio e Sysprep.
Il comportamento degli script dipende dalla modalità in cui l'agente esegue gli script: in linea o distaccati.
In linea (impostazione predefinita)
L'agente EC2 Launch v2 esegue gli script uno alla volta (). `detach: false` Questa è l'impostazione predefinita.
Quando lo script in linea emette un comando **reset** o **sysprep**, viene eseguito immediatamente e reimposta l'agente. L'attività corrente termina, quindi l'agente si spegne senza eseguire altre attività.
Ad esempio, se l'attività che emette il comando fosse stata seguita da un'attività `startSsm` (inclusa per impostazione predefinita dopo l'esecuzione dei dati utente), l'attività non viene eseguita e il servizio Systems Manager non viene mai avviato.
Distaccato
L'agente EC2 Launch v2 esegue gli script contemporaneamente ad altre attività (). `detach: true`
Quando lo script distaccato emette un comando **reset** o **sysprep**, tali comandi attendono che l'agente finisca prima di procedere all'esecuzione. Le attività successive all'ExecuteScript continueranno a essere eseguite.
**Esempio**
```
ec2launch reset -c
```
**Utilizzo**
`ec2launch reset [flags]`
**Flag**
`-c`, `--clean`
pulisce i log delle istanze prima di `reset`
`-h`, `--help`
aiuto per `reset`
### run
Esegue Launch v2 EC2.
**Esempio**
```
ec2launch run
```
**Utilizzo**
`ec2launch run [flags]`
**Flag**
`-h`, `--help`
aiuto per `run`
### status
Ottiene lo stato dell'agente EC2 Launch v2. Blocca facoltativamente il processo fino al completamento dell'agente. Il codice di uscita del processo determina lo stato dell'agente:
+ `0` — l'agente è stato eseguito e ha avuto successo.
+ `1` — l'agente è stato eseguito e non è andato a buon fine.
+ `2` — l'agente è ancora in esecuzione.
+ `3` — l'agente si trova in uno stato sconosciuto. Lo stato dell'agente non è in esecuzione o è stato interrotto.
+ `4` — si è verificato un errore nel tentativo di recuperare lo stato dell'agente.
+ `5` — l'agente non è in esecuzione e lo stato dell'ultima esecuzione nota è sconosciuto. Ciò può significare che:
+ sia `state.json` che `previous-state.json` sono stati eliminati.
+ `previous-state.json` è danneggiato.
Questo è lo stato dell'agente dopo l'esecuzione del comando [`reset`](#ec2launch-v2-reset).
**Esempio**:
```
ec2launch status -b
```
**Utilizzo**
`ec2launch status [flags]`
**Flag**
`-b`,`--block`
blocca il processo fino al termine dell'esecuzione del'aggente
`-h`,`--help`
aiuto per `status`
### sysprep
L'obiettivo principale di questa attività è reimpostare l'agente per la prossima esecuzione. A tale scopo, il comando **sysprep** reimposta lo stato dell'agente, aggiorna il file `unattend.xml`, disabilita RDP ed esegue Sysprep.
Il comportamento degli script dipende dalla modalità in cui l'agente esegue gli script: in linea o distaccati.
In linea (impostazione predefinita)
L'agente EC2 Launch v2 esegue gli script uno alla volta (). `detach: false` Questa è l'impostazione predefinita.
Quando lo script in linea emette un comando **reset** o **sysprep**, viene eseguito immediatamente e reimposta l'agente. L'attività corrente termina, quindi l'agente si spegne senza eseguire altre attività.
Ad esempio, se l'attività che emette il comando fosse stata seguita da un'attività `startSsm` (inclusa per impostazione predefinita dopo l'esecuzione dei dati utente), l'attività non viene eseguita e il servizio Systems Manager non viene mai avviato.
Distaccato
L'agente EC2 Launch v2 esegue gli script contemporaneamente ad altre attività (). `detach: true`
Quando lo script distaccato emette un comando **reset** o **sysprep**, tali comandi attendono che l'agente finisca prima di procedere all'esecuzione. Le attività successive all'ExecuteScript continueranno a essere eseguite.
**Esempio**:
```
ec2launch sysprep
```
**Utilizzo**
`ec2launch sysprep [flags]`
**Flag**
`-c`,`--clean`
pulisce i log delle istanze prima di `sysprep`
`-h`,`--help`
aiuto per Sysprep
`-s`,`--shutdown`
arresta l'istanza dopo `sysprep`
### validate
Convalida il file `agent-config` `C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml`.
**Esempio**
```
ec2launch validate
```
**Utilizzo**
`ec2launch validate [flags]`
**Flag**
-h` `, `--help`
aiuto per `validate`
### version
Ottiene la versione eseguibile.
**Esempio**
```
ec2launch version
```
**Utilizzo**
`ec2launch version [flags]`
**Flag**
`-h`, `--help`
aiuto per `version`
### wallpaper
Imposta il nuovo sfondo sul percorso dello sfondo fornito (file .jpg) e visualizza i dettagli dell'istanza selezionata.
#### Sintassi
```
ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,ipv6Address,instanceSize,availabilityZone,architecture
```
#### Input
Parameters
**--allowed-tags [,] *tag-name-1* *tag-name-n***
(Facoltativo) Array JSON codificato in Base64 di nomi di tag delle istanze da visualizzare sullo sfondo. Puoi usare questo tag o `--all-tags`, ma non entrambi.
***attribute-string-1*--attributi, *attribute-string-n***
(Facoltativo) Un elenco separato da virgole di stringhe di attributi `wallpaper` per applicare le impostazioni allo sfondo.
**[--percorso \$1 -p] *path-string***
(Obbligatorio) Specifica il percorso del file dell'immagine di sfondo `wallpaper`.Flag
**--all-tags**
(Facoltativo) Visualizza tutti i tag delle istanze sullo sfondo. Puoi usare questo tag o `--allowed-tags`, ma non entrambi.
**[--help \$1 -h]**
Visualizza l'assistenza per il comando **wallpaper**.
## EC2Avvia la configurazione delle attività v2
In questa sezione sono riportati lo schema, le attività, i dettagli e gli esempi di configurazione per `agent-config.yml` e i dati utente.
**Topics**
+ [Schema: `agent-config.yml`](#ec2launch-v2-schema-agent-config)
+ [Configura gli script di dati utente di EC2 Launch v2 che vengono eseguiti durante l'avvio o il riavvio](#ec2launch-v2-schema-user-data)
### Schema: `agent-config.yml`
La struttura del file `agent-config.yml` è riportata di seguito. Nota che un'attività non può essere ripetuta nella stessa fase. Per le proprietà delle attività, consulta le descrizioni delle attività che seguono.
#### Struttura del documento: agent-config.yml
**JSON**
```
{
"version": "1.1",
"config": [
{
"stage": "string",
"tasks": [
{
"task": "string",
"inputs": {
...
}
},
...
]
},
...
]
}
```
**YAML**
```
version: 1.1
config:
- stage: string
tasks:
- task: string
inputs:
...
...
...
```
#### Ad esempio: `agent-config.yml`
Nell'esempio seguente vengono illustrate le impostazioni per il file di configurazione `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
```
### Configura gli script di dati utente di EC2 Launch v2 che vengono eseguiti durante l'avvio o il riavvio
Gli esempi JSON e YAML seguenti mostrano la struttura del documento per i dati utente. Amazon EC2 analizza ogni attività rinominata nell'array `tasks` specificato nel documento. Ogni attività ha il proprio set di proprietà e requisiti. Per informazioni dettagliate, consulta la [Definizioni delle attività per le attività di EC2 avvio di Launch v2](ec2launch-v2-task-definitions.md).
**Nota**
Un'attività deve essere visualizzata una sola volta nell'array di attività per i dati utente.
#### Struttura del documento: dati utente
**JSON**
```
{
"version": "1.1",
"tasks": [
{
"task": "string",
"inputs": {
...
},
},
...
]
}
```
**YAML**
```
version: 1.1
tasks:
- task: string
inputs:
...
...
```
#### Esempio: dati utente
Per ulteriori informazioni su questi dati utente, vedere [In che modo Amazon EC2 gestisce i dati utente per le istanze Windows](user-data.md#ec2-windows-user-data).
Il seguente esempio di documento YAML mostra uno PowerShell script che EC2 Launch v2 esegue come dati utente per creare un file.
```
version: 1.1
tasks:
- task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |-
New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
```
È possibile utilizzare un formato XML per i dati utente compatibile con le versioni precedenti del Launch Agent. EC2Launch v2 esegue lo script come `executeScript` attività nella `UserData` fase. Per conformarsi al comportamento di EC2 Launch v1 e EC2 Config, lo script dei dati utente viene eseguito come processo per impostazione predefinita. attached/inline
Puoi aggiungere tag opzionali per personalizzare la modalità di esecuzione dello script. Ad esempio, per eseguire lo script dei dati utente al riavvio dell'istanza e una volta all'avvio dell'istanza, puoi utilizzare il seguente tag:
`true`
**Esempio**:
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
È possibile specificare uno o più PowerShell argomenti con il tag. `` Se non viene passato alcun argomento, EC2 Launch v2 aggiunge il seguente argomento per impostazione predefinita:`-ExecutionPolicy Unrestricted`.
**Esempio**:
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
-ExecutionPolicy Unrestricted -NoProfile -NonInteractive
```
Per eseguire uno script di dati utente XML come processo distaccato, aggiungi il seguente tag ai dati utente.
`true`
**Esempio**:
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
**Nota**
Il tag di distacco non è supportato nei precedenti agenti di avvio.
#### Log delle modifiche: dati utente
La tabella seguente elenca le modifiche ai dati utente, e le rimanda alla versione dell'agente EC2 Launch v2 applicabile.
| Versione dei dati utente | Informazioni | Introdotta in |
| --- | --- | --- |
| 1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Avvia la versione v2 2.0.1245 |
| 1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Launch v2 versione 2.0.0 |
\$1 Se utilizzato con il file `agent-config.yml` predefinito.
## EC2Avvia i codici di uscita v2 e riavvia
Puoi usare EC2 Launch v2 per definire come i codici di uscita vengono gestiti dagli script. Per impostazione predefinita, il codice di uscita dell'ultimo comando eseguito in uno script viene segnalato come codice di uscita per l'intero script. Ad esempio, se uno script include tre comandi e il primo comando ha esito negativo ma quelli seguenti hanno esito positivo, lo stato di esecuzione viene segnalato come `success` perché il comando finale ha avuto esito positivo.
Se desideri che uno script riavvii un'istanza, devi specificarlo `exit 3010` nello script, anche se il riavvio è l'ultimo passaggio dello script. `exit 3010`indica a EC2 Launch v2 di riavviare l'istanza e richiamare nuovamente lo script finché non restituisce un codice di uscita diverso o finché non viene `3010` raggiunto il numero massimo di riavvii. EC2Launch v2 consente un massimo di 5 riavvii per attività. Se si tenta di riavviare un'istanza da uno script utilizzando un meccanismo diverso, ad esempio `Restart-Computer`, lo stato di esecuzione dello script non sarà coerente. Ad esempio, potrebbe rimanere bloccato in un ciclo di riavvio o non eseguire il riavvio.
Se utilizzi un formato di dati utente XML compatibile con agenti meno recenti, i dati utente potrebbero essere eseguiti più volte di quanto desideri. Per ulteriori informazioni, consulta [Il servizio esegue i dati utente più di una volta](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-user-data-more-than-once) nella sezione di risoluzione dei problemi.
## EC2Avvia v2 e Sysprep
Il servizio EC2 Launch v2 esegue Sysprep, uno strumento Microsoft che consente di creare un'AMI Windows personalizzata che può essere riutilizzata. Quando EC2 Launch v2 chiama Sysprep, utilizza i file per determinare le operazioni da eseguire. `%ProgramData%\Amazon\EC2Launch` È possibile modificare questi file indirettamente utilizzando la finestra di dialogo **delle impostazioni di EC2 avvio** o direttamente utilizzando un editor YAML o un editor di testo. Tuttavia, alcune impostazioni avanzate non sono disponibili nella finestra di dialogo **delle impostazioni di EC2 Launch**, quindi è necessario modificare direttamente tali voci.
Se crei un'AMI da un'istanza dopo l'aggiornamento delle sue impostazioni, le nuove impostazioni vengono applicate a ogni istanza lanciata dalla nuova AMI. Per informazioni sulla creazione di un'AMI, consulta [Creare un'AMI supportata da Amazon EBS](creating-an-ami-ebs.md).
# Definizioni delle attività per le attività di EC2 avvio di Launch v2
Ogni attività eseguita da EC2 Launch v2 durante l'avvio o l'avvio ha il proprio set di proprietà e requisiti. I dettagli delle attività includono le impostazioni per l'esecuzione di un'attività (sempre o una sola volta), a quale fase del processo di avvio dell'agente viene eseguito, la sintassi ed esempi di documento YAML. Per ulteriori informazioni, consulta i dettagli delle attività illustrati in questo riferimento.
**Topics**
+ [activateWindows](#ec2launch-v2-activatewindows)
+ [enableJumboFrames](#ec2launch-v2-enablejumboframes)
+ [enableOpenSsh](#ec2launch-v2-enableopenssh)
+ [executeProgram](#ec2launch-v2-executeprogram)
+ [executeScript](#ec2launch-v2-executescript)
+ [extendRootPartition](#ec2launch-v2-extendrootpartition)
+ [initializeVolume](#ec2launch-v2-initializevolume)
+ [optimizeEna](#ec2launch-v2-optimizeena)
+ [setAdminAccount](#ec2launch-v2-setadminaccount)
+ [setDnsSuffix](#ec2launch-v2-setdnssuffix)
+ [setHostName](#ec2launch-v2-sethostname)
+ [setWallpaper](#ec2launch-v2-setwallpaper)
+ [startSsm](#ec2launch-v2-startssm)
+ [sysprep](#ec2launch-v2-task-sysprep)
+ [writeFile](#ec2-launch-v2-writefile)
## activateWindows
Attiva Windows su un set di server. AWS KMS L'attivazione viene ignorata se l'istanza viene rilevata come Bring-Your-Own-License (BYOL).
*Frequency* - una volta
*AllowedStages* — `[PreReady]`
*Inputs* —
`activation`: (mappa)
`type`: (stringa) tipo di attivazione da utilizzare, impostato su `amazon`
*Esempio*
```
task: activateWindows
inputs:
activation:
type: amazon
```
## enableJumboFrames
Abilita i frame jumbo che aumentano l'unità di trasmissione massima (MTU) della scheda di rete. Per ulteriori informazioni, consulta [Frame jumbo (9001 MTU)](network_mtu.md#jumbo_frame_instances).
*Frequency* - sempre
*AllowedStages* — `[PostReady, UserData]`
*Inputs* - nessuno
*Esempio*
```
task: enableJumboFrames
```
## enableOpenSsh
Abilita Windows OpenSSH e aggiunge la chiave pubblica per l'istanza alla cartella delle chiavi autorizzate.
*Frequency* - una volta
*AllowedStages* — `[PreReady, UserData]`
*Inputs* - nessuno
*Esempio*
Nell'esempio seguente viene illustrato come abilitare OpenSSH su un'istanza e come aggiungere la chiave pubblica per l'istanza alla cartella delle chiavi autorizzate. Questa configurazione funziona solo su istanze che eseguono Windows Server 2019 e versioni successive.
```
task: enableOpenSsh
```
## executeProgram
Esegue uno script con argomenti opzionali e una frequenza specificata.
**Fasi:** è possibile eseguire l'attività `executeProgram` durante le fasi`PreReady`, `PostReady` e `UserData`.
**Frequenza:** configurabile, vedere *Input*.
**Input**
Questa sezione contiene uno o più programmi per l'esecuzione dell'attività **executeProgram** (input). Ogni input può includere le seguenti impostazioni configurabili:
**frequenza (stringa)**
(Obbligatorio) Specifica esattamente uno dei seguenti valori:
+ `once`
+ `always`
**path (stringa)**
(Obbligatorio) Il percorso del file per l'eseguibile da eseguire.
**argomenti (elenco di stringhe)**
(Facoltativo) Un elenco di argomenti separati da virgole da fornire al programma come input.
**runAs (stringa)**
(Obbligatorio) Deve essere impostato su `localSystem`
**Output**
Tutte le attività scrivono le voci del file di registro nel file `agent.log`. L'output aggiuntivo dell'attività `executeProgram` viene archiviato separatamente in una cartella denominata dinamicamente, come segue:
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.tmp`
Il percorso esatto dei file di output è incluso nel file `agent.log`, ad esempio:
```
Program file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\ExecuteProgramInputs.tmp
Output file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Output.tmp
Error file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Err.tmp
```
**File di output per l'attività `executeProgram`**
`ExecuteProgramInputs.tmp`
Contiene il percorso dell'eseguibile e tutti i parametri di input che l'attività `executeProgram` passa durante l'esecuzione.
`Output.tmp`
Contiene l'output di runtime del programma eseguito dall'attività `executeProgram`.
`Err.tmp`
Contiene messaggi di errore di runtime provenienti dal programma eseguito dall'attività `executeProgram`.
**Esempi**
Gli esempi seguenti mostrano come eseguire un file eseguibile da una directory locale su un'istanza con l'attività `executeProgram`.
**Esempio 1: Configurazione dell'eseguibile con un argomento**
Questo esempio mostra un'attività `executeProgram` che esegue un eseguibile di installazione in modalità silenziosa.
```
task: executeProgram
inputs:
- frequency: always
path: C:\Users\Administrator\Desktop\setup.exe
arguments: ['-quiet']
```
**Esempio 2: eseguibile VLC con due argomenti**
Questo esempio mostra un'attività `executeProgram` che esegue un file eseguibile VLC con due argomenti passati come parametri di input.
```
task: executeProgram
inputs:
- frequency: always
path: C:\vlc-3.0.11-win64.exe
arguments: ['/L=1033','/S']
runAs: localSystem
```
## executeScript
Esegue uno script con argomenti opzionali e una frequenza specificata. Il comportamento degli script dipende dalla modalità in cui l'agente esegue gli script: in linea o distaccati.
In linea (impostazione predefinita)
L'agente EC2 Launch v2 esegue gli script uno alla volta (). `detach: false` Questa è l'impostazione predefinita.
Quando lo script in linea emette un comando **reset** o **sysprep**, viene eseguito immediatamente e reimposta l'agente. L'attività corrente termina, quindi l'agente si spegne senza eseguire altre attività.
Ad esempio, se l'attività che emette il comando fosse stata seguita da un'attività `startSsm` (inclusa per impostazione predefinita dopo l'esecuzione dei dati utente), l'attività non viene eseguita e il servizio Systems Manager non viene mai avviato.
Distaccato
L'agente EC2 Launch v2 esegue gli script contemporaneamente ad altre attività (). `detach: true`
Quando lo script distaccato emette un comando **reset** o **sysprep**, tali comandi attendono che l'agente finisca prima di procedere all'esecuzione. Le attività successive all'ExecuteScript continueranno a essere eseguite.
**Fasi:** è possibile eseguire l'attività `executeScript` durante le fasi`PreReady`, `PostReady` e `UserData`.
**Frequenza:** configurabile, vedere *Input*.
**Input**
Questa sezione contiene uno o più script per l'esecuzione dell'attività **executeScript** (input). Ogni input può includere le seguenti impostazioni configurabili:
**frequenza (stringa)**
(Obbligatorio) Specifica esattamente uno dei seguenti valori:
+ `once`
+ `always`
**Tipo: stringa**
(Obbligatorio) Specifica esattamente uno dei seguenti valori:
+ `batch`
+ `powershell`
**argomenti (elenco di stringhe)**
(Facoltativo) Un elenco di argomenti di stringa da passare alla shell (non allo PowerShell script). Questo parametro non è supportato per le attività eseguite su `type: batch`. Se non viene passato alcun argomento, EC2 Launch v2 aggiunge il seguente argomento per impostazione predefinita:`-ExecutionPolicy Unrestricted`.
**contenuto (stringa)**
(Obbligatorio) Contenuto dello script.
**runAs (stringa)**
(Obbligatorio) Specificare esattamente uno dei seguenti valori:
+ `admin`
+ `localSystem`
**staccare (booleano)**
(Facoltativo) Per impostazione predefinita, l'agente EC2 Launch v2 esegue gli script uno alla volta (). `detach: false` Per eseguire lo script in concomitanza con altre attività, impostate il valore su`true` (`detach: true`).
I codici di uscita dello script (tra cui `3010`) non hanno effetto quando `detach` è impostato su `true`.
**Output**
Tutte le attività scrivono le voci del file di registro nel file `agent.log`. L'output aggiuntivo dello script eseguito dall'attività `executeScript` viene archiviato separatamente in una cartella denominata dinamicamente, come segue:
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.ext`
Il percorso esatto dei file di output è incluso nel file `agent.log`, ad esempio:
```
Program file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\UserScript.ps1
Output file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Output.tmp
Error file is created at: C:\Windows\system32\config\systemprofile\AppData\Local\Temp\EC2Launch123456789\Err.tmp
```
**File di output per l'attività `executeScript`**
`UserScript.ext`
Contiene lo script eseguito dall'attività `executeScript`. L'estensione del file dipende dal tipo di script specificato nel parametro `type` per l'attività `executeScript`, come segue:
+ Se il tipo è`batch`, l'estensione del file è `.bat`.
+ Se il tipo è`powershell`, l'estensione del file è `.ps1`.
`Output.tmp`
Contiene l'output di runtime dello script eseguito dall'attività `executeScript`.
`Err.tmp`
Contiene messaggi di errore di runtime provenienti dallo script eseguito dall'attività `executeScript`.
**Esempi**
Gli esempi seguenti mostrano come eseguire uno script in linea con l'attività `executeScript`.
**Esempio 1: file di testo di output Ciao**
Questo esempio mostra un'`executeScript`attività che esegue PowerShell uno script per creare un file di testo «Hello world» sull'unità. `C:`
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: admin
content: |-
New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
Set-Content 'C:\PowerShellTest.txt' "Hello world"
```
**Esempio 2: eseguire due script**
Questo esempio mostra che l'attività `executeScript` può eseguire più di uno script e il tipo di script non deve necessariamente corrispondere.
Il primo script (`type: powershell`) scrive un riepilogo dei processi attualmente in esecuzione sull'istanza in un file di testo che si trova sull'unità `C:`.
Il secondo script (`batch`) scrive le informazioni di sistema nel file `Output.tmp`.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |
Get-Process | Out-File -FilePath C:\Process.txt
- frequency: always
type: batch
runAs: localSystem
content: |
systeminfo
```
**Esempio 3: configurazione di sistema idempotente con riavvii**
Questo esempio mostra un'attività `executeScript` che esegue uno script idempotente per eseguire la seguente configurazione di sistema con un riavvio tra ogni fase:
+ Impostare il nome del computer.
+ Aggiungere il computer al dominio
+ Abilitare Telnet.
Lo script garantisce che ogni operazione venga eseguita una sola volta. Ciò impedisce un ciclo di riavvio e rende lo script idempotente.
```
task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |-
$name = $env:ComputerName
if ($name -ne $desiredName) {
Rename-Computer -NewName $desiredName
exit 3010
}
$domain = Get-ADDomain
if ($domain -ne $desiredDomain)
{
Add-Computer -DomainName $desiredDomain
exit 3010
}
$telnet = Get-WindowsFeature -Name Telnet-Client
if (-not $telnet.Installed)
{
Install-WindowsFeature -Name "Telnet-Client"
exit 3010
}
```
## extendRootPartition
Estende il volume root per utilizzare tutto lo spazio disponibile sul disco.
*Frequency* - una volta
*AllowedStages* — `[Boot]`
*Inputs* - nessuno
*Esempio*
```
task: extendRootPartition
```
## initializeVolume
Inizializza i volumi vuoti che sono collegati all'istanza in modo che vengano attivati e partizionati. L'agente di avvio salta l'inizializzazione se rileva che il volume non è vuoto. Un volume è considerato vuoto se i primi 4 KiB del volume sono vuoti o se non dispone di un [layout di unità riconoscibile da Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex).
Il parametro di input `letter` viene sempre applicato quando viene eseguita questa attività, indipendentemente dal fatto che l'unità sia già inizializzata.
L'attività `initializeVolume` effettua le seguenti operazioni.
+ Imposta gli attributi del disco `offline` e `readonly` su false.
+ Creare una partizione. Se non è specificato alcun tipo di partizione nel parametro di input `partition`, si applicano le seguenti impostazioni predefinite:
+ Se la dimensione del disco è inferiore a 2 TB, imposta il tipo di partizione su `mbr`.
+ Se la dimensione del disco è pari o superiore a 2 TB, imposta il tipo di partizione su .`gpt`.
+ Formatta il volume come NTFS.
+ Imposta l'etichetta del volume, come indicato di seguito:
+ Utilizza il valore del parametro di input `name`, se specificato.
+ Se il volume è temporaneo e non è stato specificato alcun nome, imposta l'etichetta del volume su `Temporary Storage Z`.
+ Se il volume è temporaneo (SSD o HDD, non Amazon EBS), crea un file `Important.txt` nel root del volume con il seguente contenuto:
```
This is an 'Instance Store' disk and is provided at no additional charge.
*This disk offers increased performance since it is local to the host
*The number of Instance Store disks available to an instance vary by instance type
*DATA ON THIS DRIVE WILL BE LOST IN CASES OF IMPAIRMENT OR STOPPING THE INSTANCE. PLEASE ENSURE THAT ANY IMPORTANT DATA IS BACKED UP FREQUENTLY
For more information, please refer to: Archivio dell'istanza archiviazione a blocchi temporanea per le istanze EC2.
```
+ Imposta la lettera dell'unità sul valore specificato nel parametro di input `letter`.
**Fasi:** è possibile eseguire l'attività `initializeVolume` durante le fasi `PostReady` e `UserData`.
**Frequenza:** sempre.
**Input**
È possibile configurare i parametri di runtime come segue:
**dispositivi (elenco di mappe)**
(Condizionale) Configurazione per ogni dispositivo inizializzato dall'agente di avvio. Questo parametro è obbligatorio quando il parametro di input `initialize` è impostato su `devices`.
+ **dispositivo (stringa, obbligatorio)**: identifica il dispositivo durante la creazione dell'istanza. Ad esempio, `xvdb`, `xvdf` o `\dev\nvme0n1`.
+ **lettera (stringa, facoltativo)**: un carattere. La lettera dell'unità da assegnare.
+ **nome (stringa, facoltativo)**: il nome del volume da assegnare.
+ **partizione (stringa, facoltativo)**: specifica uno dei seguenti valori per il tipo di partizione da creare o consenti all'agente di avvio di utilizzare le impostazioni predefinite in base alla dimensione del volume:
+ mbr
+ gpt
**inizializza (stringa)**
(Obbligatorio) Specificare esattamente uno dei seguenti valori:
+ `all`
+ `devices`
**Esempi**
Gli esempi seguenti mostrano esempi di configurazioni di input per l'attività `initializeVolume`.
**Esempio 1: inizializzazione di due volumi su un'istanza**
Questo esempio mostra un'attività `initializeVolume` che inizializza due volumi secondari su un'istanza. Il dispositivo denominato `DataVolume2` nell'esempio è effimero.
```
task: initializeVolume
inputs:
initialize: devices
devices:
- device: xvdb
name: DataVolume1
letter: D
partition: mbr
- device: /dev/nvme0n1
name: DataVolume2
letter: E
partition: gpt
```
**Esempio 2: inizializzazione dei volumi EBS collegati a un'istanza**
Questo esempio mostra un'attività `initializeVolume` che inizializza tutti i volumi EBS vuoti collegati all'istanza.
```
task: initializeVolume
inputs:
initialize: all
```
## optimizeEna
Ottimizza le impostazioni ENA in base al tipo di istanza corrente; l'istanza potrebbe essere riavviata.
*Frequency* - sempre
*AllowedStages* — `[PostReady, UserData]`
*Inputs* - nessuno
*Esempio*
```
task: optimizeEna
```
## setAdminAccount
Imposta gli attributi per l'account amministratore predefinito creato nel computer locale.
*Frequency* - una volta
*AllowedStages* — `[PreReady]`
*Inputs* —
`name`: (stringa) nome dell'account amministratore
`password`: (mappa)
`type`: (stringa) strategia per impostare la password come `static`, `random` o `doNothing`
`data`: (stringa) archivia i dati se il campo `type` è statico
*Esempio*
```
task: setAdminAccount
inputs:
name: Administrator
password:
type: random
```
## setDnsSuffix
Aggiunge suffissi DNS all'elenco dei suffissi di ricerca. All'elenco vengono aggiunti solo i suffissi che non esistono già. 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).
*Frequency* - sempre
*AllowedStages* — `[PreReady]`
*Inputs* —
`suffixes`: (elenco di stringhe) elenco di uno o più suffissi DNS validi, le variabili di sostituzione valide sono `$REGION` e `$AZ`
*Esempio*
```
task: setDnsSuffix
inputs:
suffixes:
- $REGION.ec2-utilities.amazonaws.com
```
## setHostName
Imposta il nome host del computer su una stringa personalizzata o, se non `hostName` è specificato, sull' IPv4 indirizzo privato.
*Frequency* - sempre
*AllowedStages* — `[PostReady, UserData]`
*Inputs* —
`hostName`: (stringa) nome host facoltativo, che deve essere formattato come segue.
+ Deve essere uguale o inferiore a 15 caratteri
+ Deve contenere solo caratteri alfanumerici (a-z, A-Z, 0-9) e trattino (-).
+ Non deve essere costituito interamente da caratteri numerici.
`reboot`: (booleano) indica se è consentito un riavvio quando viene modificato il nome host
*Esempio*
```
task: setHostName
inputs:
reboot: true
```
## setWallpaper
Crea il file di scorciatoia `setwallpaper.lnk` nella cartella di startup di ciascun utente esistente, eccetto `Default User`. Questo file di scorciatoia viene eseguito quando l'utente accede per la prima volta dopo l'avvio dell'istanza. Imposta l'istanza con uno sfondo personalizzato che visualizzi gli attributi dell'istanza.
Il percorso del file di scorciatoia è:
```
$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk
```
**Nota**
La rimozione dell'attività `setWallpaper` non elimina questo file di scorciatoia. Per ulteriori informazioni, consulta [Il processo `setWallpaper` non è abilitato ma lo sfondo viene ripristinato al riavvio](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-wallpaper-resets).
**Fasi:** puoi configurare lo sfondo durante le fasi `PreReady` e `UserData`.
**Frequenza:** `always`
**Configurazione dello sfondo**
È possibile configurare lo sfondo con le seguenti impostazioni.
**Input**
Parametri di input che fornisci e attributi che puoi impostare per configurare lo sfondo:
**path (stringa)**
(Obbligatorio) Il percorso del nome del file immagine in formato.jpg locale da utilizzare per l'immagine di sfondo.
**attributi (elenco di stringhe)**
(Facoltativo) Puoi aggiungere uno o più dei seguenti attributi allo sfondo:
+ `architecture`
+ `availabilityZone`
+ `hostName`
+ `instanceId`
+ `instanceSize`
+ `privateIpAddress`
+ `publicIpAddress`
+ `ipv6Address`
**instanceTags**
(Facoltativo) Per questa impostazione puoi utilizzare esattamente una delle seguenti opzioni.
+ **AllTags**(stringa) — Aggiunge tutti i tag di istanza allo sfondo.
```
instanceTags: AllTags
```
+ **instanceTags** (elenco di stringhe): specifica un elenco di nomi di tag delle istanze da aggiungere allo sfondo. Esempio:
```
instanceTags:
- Tag 1
- Tag 2
```
**Esempio**
L'esempio seguente mostra gli input di configurazione dello sfondo che impostano il percorso del file per l'immagine di sfondo dello sfondo, insieme ai tag delle istanze denominati `Tag 1` e `Tag 2` e agli attributi che includono il nome dell'host, l'ID dell'istanza e gli indirizzi IP privati e pubblici dell'istanza.
```
task: setWallpaper
inputs:
path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
attributes:
- hostName
- instanceId
- privateIpAddress
- publicIpAddress
instanceTags:
- Tag 1
- Tag 2
```
**Nota**
È necessario abilitare i tag nei metadati per mostrare i tag sullo sfondo. Per ulteriori informazioni sui tag e metadati delle istanze, consulta [Visualizza i tag per le istanze EC2 utilizzando i metadati dell'istanza](work-with-tags-in-IMDS.md).
## startSsm
Avvia il servizio Systems Manager (SSM) dopo Sysprep.
*Frequency* - sempre
*AllowedStages* — `[PostReady, UserData]`
*Inputs* - nessuno
*Esempio*
```
task: startSsm
```
## sysprep
Reimposta lo stato del servizio, aggiorna `unattend.xml`, disabilita RDP ed esegue Sysprep. Questa attività viene eseguita solo dopo che tutte le altre attività sono state completate.
*Frequency* - una volta
*AllowedStages* — `[UserData]`
*Inputs* —
`clean`: (booleano) pulisce i log delle istanze prima di eseguire Sysprep
`shutdown`: (booleano) chiude l'istanza dopo l'esecuzione di Sysprep
*Esempio*
```
task: sysprep
inputs:
clean: true
shutdown: true
```
## writeFile
Scrive un file in una destinazione.
*Frequency* - vedi *Inputs*
*AllowedStages* — `[PostReady, UserData]`
*Inputs* —
`frequency`: (stringa) `once` o `always`
`destination`: (stringa) percorso in cui scrivere il contenuto
`content`: (stringa) testo da scrivere nella destinazione
*Esempio*
```
task: writeFile
inputs:
- frequency: once
destination: C:\Users\Administrator\Desktop\booted.txt
content: Windows Has Booted
```
# Risolvi i problemi con l'agente EC2 Launch v2
Questa sezione mostra gli scenari di risoluzione dei problemi più comuni per EC2 Launch v2, informazioni sulla visualizzazione dei registri degli eventi di Windows e l'output e i messaggi dei log della console.
**Topics**
+ [Scenari comuni](#ec2launchv2-troubleshooting-scenarios)
+ [Log di eventi di Windows](#ec2launchv2-windows-event-logs)
+ [EC2Avvia l'output del registro della console v2](#ec2launchv2-console-output)
## Scenari per la risoluzione dei problemi comuni
In questa sezione vengono illustrati gli scenari di risoluzione dei problemi comuni e le fasi per la risoluzione dei problemi.
**Topics**
+ [Il servizio non riesce a impostare lo sfondo](#ec2launchv2-troubleshooting-wallpaper)
+ [Il servizio non riesce a eseguire i dati utente](#ec2launchv2-troubleshooting-user-data)
+ [Il servizio esegue un'attività una sola volta](#ec2launchv2-troubleshooting-task-once)
+ [Il servizio non riesce a eseguire un'attività](#ec2launchv2-troubleshooting-task-failed)
+ [Il servizio esegue i dati utente più di una volta](#ec2launchv2-troubleshooting-user-data-more-than-once)
+ [Le attività pianificate da EC2 Launch v1 non vengono eseguite dopo la migrazione a EC2 Launch v2](#ec2launchv2-troubleshooting-scheduled-tasks-migration)
+ [Il servizio inizializza un volume EBS che non è vuoto](#ec2launchv2-troubleshooting-ebs-initialize)
+ [Il processo `setWallpaper` non è abilitato ma lo sfondo viene ripristinato al riavvio](#ec2launchv2-troubleshooting-wallpaper-resets)
+ [Servizio bloccato nello stato di esecuzione](#ec2launchv2-troubleshooting-service-stuck-running)
+ [Non valido `agent-config.yml` impedisce l'apertura della finestra di dialogo delle EC2 impostazioni di Launch v2](#ec2launchv2-troubleshooting-invalid-agent-config)
+ [`task:executeScript should be unique and only invoked once`](#ec2launchv2-troubleshooting-executescript)
### Il servizio non riesce a impostare lo sfondo
**Risoluzione**
1. Controlla che `%AppData%\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\setwallpaper.lnk` esista.
1. Controlla `%ProgramData%\Amazon\EC2Launch\log\agent.log` per vedere se si sono verificati errori.
### Il servizio non riesce a eseguire i dati utente
**Possibile causa**: il servizio potrebbe aver restituito l'esito negativo prima dell'esecuzione dei dati utente.
**Risoluzione**
1. Controlla `%ProgramData%\Amazon\EC2Launch\state\previous-state.json`.
1. Vedi se `boot`, `network`, `preReady` e `postReadyLocalData` sono stati tutti contrassegnati come completati.
1. Se una delle fasi non è riuscita, controlla `%ProgramData%\Amazon\EC2Launch\log\agent.log` per vedere se si sono verificati errori specifici.
### Il servizio esegue un'attività una sola volta
**Risoluzione**
1. Controlla la frequenza dell'attività.
1. Se il servizio è già stato eseguito dopo Sysprep e la frequenza dell'attività è impostata su `once`, l'attività non verrà eseguita nuovamente.
1. Imposta la frequenza dell'attività su `always` se desideri che venga eseguita ogni volta che viene eseguito EC2 Launch v2.
### Il servizio non riesce a eseguire un'attività
**Risoluzione**
1. Controlla le ultime voci in `%ProgramData%\Amazon\EC2Launch\log\agent.log`.
1. Se non si sono verificati errori, prova a eseguire manualmente il servizio da `"%ProgramFiles%\Amazon\EC2Launch\EC2Launch.exe" run` per verificare se le attività hanno esito positivo.
### Il servizio esegue i dati utente più di una volta
**Risoluzione**
I dati utente vengono gestiti in modo diverso tra EC2 Launch v1 e EC2 Launch v2. EC2Launch v1 esegue i dati utente come attività pianificata sull'istanza in cui `persist` è impostato su. `true` Se `persist` è impostato su `false`, l'attività non viene pianificata anche quando esce con un riavvio o viene interrotta durante l'esecuzione.
EC2Launch v2 esegue i dati utente come attività dell'agente e ne tiene traccia dello stato di esecuzione. Se i dati utente emettono un riavvio del computer o sono stati interrotti durante l'esecuzione, lo stato di esecuzione persiste come `pending` e i dati utente verranno eseguiti nuovamente al successivo avvio dell'istanza. Se si desidera impedire l'esecuzione dello script dei dati utente più di una volta, rendere lo script idempotente.
Lo script idempotente di esempio seguente imposta il nome del computer e si unisce a un dominio.
```
$name = $env:computername
if ($name -ne $desiredName) {
Rename-Computer -NewName $desiredName
}
$domain = Get-ADDomain
if ($domain -ne $desiredDomain)
{
Add-Computer -DomainName $desiredDomain
}
$telnet = Get-WindowsFeature -Name Telnet-Client
if (-not $telnet.Installed)
{
Install-WindowsFeature -Name "Telnet-Client"
}
false
```
### Le attività pianificate da EC2 Launch v1 non vengono eseguite dopo la migrazione a EC2 Launch v2
**Risoluzione**
Lo strumento di migrazione non rileva alcuna attività pianificata collegata agli script di EC2 Launch v1, pertanto non configura automaticamente tali attività in Launch v2. EC2 Per configurare queste attività, modifica il [`agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-task-configuration)file o utilizza la finestra di dialogo delle impostazioni di [EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui). Ad esempio, se un'istanza ha un'attività pianificata in esecuzione`InitializeDisks.ps1`, dopo aver eseguito lo strumento di migrazione, è necessario specificare i volumi che si desidera inizializzare nella finestra di dialogo delle impostazioni di EC2 Launch v2. Vedere il passaggio 6 della procedura per [Modifica le impostazioni utilizzando la finestra di dialogo delle impostazioni di EC2 Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui).
### Il servizio inizializza un volume EBS che non è vuoto
**Risoluzione**
Prima di inizializzare un volume, EC2 Launch v2 tenta di rilevare se è vuoto. Se un volume non è vuoto, ignora l'inizializzazione. I volumi rilevati come non vuoti non vengono inizializzati. Un volume è considerato vuoto se i primi 4 KiB del volume sono vuoti o se non dispone di un [layout di unità riconoscibile da Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex). Un volume che è stato inizializzato e formattato su un sistema Linux non dispone di un layout di unità riconoscibile da Windows, ad esempio MBR o GPT. Pertanto, sarà considerato vuoto e inizializzato. Se desideri conservare questi dati, non fare affidamento sul rilevamento delle unità vuote di EC2 Launch v2. Specificate invece i volumi che desiderate inizializzare nella finestra di [dialogo delle impostazioni di EC2 Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui) (vedere il passaggio 6) o nel. [`agent-config.yml`](ec2launch-v2-task-definitions.md#ec2launch-v2-initializevolume)
### Il processo `setWallpaper` non è abilitato ma lo sfondo viene ripristinato al riavvio
Il processo `setWallpaper` crea il file di scorciatoia `setwallpaper.lnk` nella cartella di startup di ciascun utente esistente. Questo file di scorciatoia viene eseguito quando l'utente accede per la prima volta dopo l'avvio dell'istanza. Imposta l'istanza con uno sfondo personalizzato che visualizzi gli attributi dell'istanza. La rimozione del processo `setWallpaper` non elimina questo file di scorciatoia. È necessario eliminare questo file manualmente o con uno script.
Il percorso del file di scorciatoia è:
`$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk`
**Risoluzione**
Eliminare questo file manualmente o con uno script.
** PowerShell Script di esempio per eliminare un file di collegamento**
```
foreach ($userDir in (Get-ChildItem "C:\Users" -Force -Directory).FullName)
{
$startupPath = Join-Path $userDir -ChildPath "AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"
if (Test-Path $startupPath)
{
$wallpaperSetupPath = Join-Path $startupPath -ChildPath "setwallpaper.lnk"
if (Test-Path $wallpaperSetupPath)
{
Remove-Item $wallpaperSetupPath -Force -Confirm:$false
}
}
}
```
### Servizio bloccato nello stato di esecuzione
**Descrizione**
EC2Launch v2 è bloccato, con messaggi di log (`agent.log`) simili ai seguenti:
```
2022-02-24 08:08:58 Info: *****************************************************************************************
2022-02-24 08:08:58 Info: EC2Launch Service starting
2022-02-24 08:08:58 Info: Windows event custom log exists: Amazon EC2Launch
2022-02-24 08:08:58 Info: ACPI SPCR table not supported. Bailing Out
2022-02-24 08:08:58 Info: Serial port is in use. Waiting for Serial Port...
2022-02-24 08:09:00 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:02 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:04 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:06 Info: ACPI SPCR table not supported. Use default console port.
```
**Possibile causa**
SAC è abilitato e utilizza la porta seriale. Per ulteriori informazioni, consulta [Utilizzo di SAC per risolvere i problemi relativi all'istanza di Windows](troubleshoot-using-serial-console.md#troubleshooting-sac).
**Risoluzione**
Per risolvere il problema, prova a eseguire i seguenti passaggi:
+ Disabilita il servizio che utilizza la porta seriale.
+ Se desideri che il servizio continui a utilizzare la porta seriale, scrivi degli script personalizzati per eseguire le attività dell'agente di avvio e richiamarle come attività pianificate.
### Non valido `agent-config.yml` impedisce l'apertura della finestra di dialogo delle EC2 impostazioni di Launch v2
**Description**
EC2Launch v2 settings tenta di analizzare il `agent-config.yml` file prima che apra la finestra di dialogo. Se il file di configurazione YAML non segue lo schema supportato, nella finestra di dialogo viene visualizzato il seguente errore:
`Unable to parse configuration file agent-config.yml. Review configuration file. Exiting application.`
**Risoluzione**
1. Verifica che il file di configurazione segua lo [schema supportato](ec2launch-v2-settings.md#ec2launch-v2-schema-agent-config).
1. Se vuoi iniziare da zero, copia il file di configurazione predefinito in `agent-config.yml`. Puoi utilizzare il plugin di [`agent-config.yml` di esempio](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config) fornito nella sezione Task Configuration (Configurazione attività).
1. Puoi anche ricominciare da capo eliminando `agent-config.yml`. EC2Le impostazioni di Launch v2 generano un file di configurazione vuoto.
### `task:executeScript should be unique and only invoked once`
**Description**
Un'attività non può essere ripetuta nella stessa fase.
**Risoluzione**
Alcune attività devono essere inserite come array, ad esempio [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript) e [**executeProgram**](ec2launch-v2-task-definitions.md#ec2launch-v2-executeprogram). Per un esempio di come scrivere lo script in forma di array, consulta l'argomento [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript).
## Log di eventi di Windows
EC2Launch v2 pubblica i registri degli eventi di Windows relativi a eventi importanti, ad esempio l'avvio del servizio, la disponibilità di Windows e l'esito positivo o negativo delle operazioni. Gli identificatori di evento identificano in modo univoco un particolare evento. Ogni evento contiene informazioni su fasi, attività e livelli e una descrizione. Puoi impostare i trigger per eventi specifici utilizzando l'identificatore di evento.
Gli eventi IDs forniscono informazioni su un evento e identificano in modo univoco alcuni eventi. La cifra meno significativa di un ID evento indica la gravità di un evento.
| Evento | Cifra meno significativa |
| --- | --- |
| Success | . . .0 |
| Informational | . . .1 |
| Warning | . . .2 |
| Error | . . .3 |
Gli eventi relativi al servizio generati all'avvio o all'arresto del servizio includono un identificatore di evento a una cifra.
| Evento | Identificatore a una cifra |
| --- | --- |
| Success | 0 |
| Informational | 1 |
| Warning | 2 |
| Error | 3 |
I messaggi di evento per gli eventi `EC2LaunchService.exe` iniziano con `Service:`. I messaggi di evento per gli eventi `EC2Launch.exe` non iniziano con `Service:`.
IDs Gli eventi a quattro cifre includono informazioni sullo stadio, sull'attività e sulla gravità di un evento.
**Topics**
+ [Formato ID evento](#ec2launchv2-windows-event-logs-format)
+ [Esempi di ID evento](#ec2launchv2-windows-event-logs-id-examples)
+ [Schema dei log di eventi di Windows](#ec2launch-v2-windows-event-logs-schema)
### Formato ID evento
La tabella seguente mostra il formato di un identificatore di evento EC2 Launch v2.
| 3 | 2 1 | 0 |
| --- | --- | --- |
| S | T | L |
Le lettere e i numeri nella tabella rappresentano il tipo di evento e le definizioni seguenti.
| Tipo di evento | Definizione |
| --- | --- |
| S (fase) | 0 - Messaggio a livello di servizio 1 - Avvio 2 - Rete 3 - PreReady 5 - Windows è pronto 6 - PostReady 7 - Dati utente |
| T (attività) | Le attività rappresentate dai due valori corrispondenti sono diverse per ogni fase. Per visualizzare l'elenco completo degli eventi, consulta lo [Schema dei log di eventi di Windows](#ec2launch-v2-windows-event-logs-schema). |
| L (livello di evento) | 0 - Operazione completata 1 - Messaggio informativo 2 - Avvertenza 3 - Errore |
### Esempi di ID evento
I seguenti sono esempi di evento IDs.
+ `5000` - Windows è pronto per l'uso
+ `3010`- L'attività di attivazione di Windows in PreReady fase è stata completata con successo
+ `6013`- Si è verificato un errore nell'operazione Imposta sfondo nella fase PostReady Local Data
### Schema dei log di eventi di Windows
| MessageId/ID evento | Messaggio di evento |
| --- | --- |
| . . .0 | Success |
| . . .1 | Informational |
| . . .2 | Warning |
| . . .3 | Error |
| x | EC2Launch service-level logs |
| 0 | EC2Launch service exited successfully |
| 1 | EC2Launch service informational logs |
| 2 | EC2Launch service warning logs |
| 3 | EC2Launch service error logs |
| 10 | Replace state.json with previous-state.json |
| 100 | Serial Port |
| 200 | Sysprep |
| 300 | PrimaryNic |
| 400 | Metadata |
| x000 | Stage (1 digit), Task (2 digits), Status (1 digit) |
| 1000 | Boot |
| 1010 | Boot - extend\$1root\$1partition |
| 2000 | Network |
| 2010 | Network - add\$1routes |
| 3000 | PreReady |
| 3010 | PreReady - activate\$1windows |
| 3020 | PreReady - install\$1egpu\$1manager |
| 3030 | PreReady - set\$1monitor\$1on |
| 3040 | PreReady - set\$1hibernation |
| 3050 | PreReady - set\$1admin\$1account |
| 3060 | PreReady - set\$1dns\$1suffix |
| 3070 | PreReady - set\$1wallpaper |
| 3080 | PreReady - set\$1update\$1schedule |
| 3090 | PreReady - output\$1log |
| 3100 | PreReady - enable\$1open\$1ssh |
| 5000 | Windows is Ready to use |
| 6000 | PostReadyLocalData |
| 7000 | PostReadyUserData |
| 6010/7010 | PostReadyLocal/UserData - set\$1wallpaper |
| 6020/7020 | PostReadyLocal/UserData - set\$1update\$1schedule |
| 6030/7030 | PostReadyLocal/UserData - set\$1hostname |
| 6040/7040 | PostReadyLocal/UserData - execute\$1program |
| 6050/7050 | PostReadyLocal/UserData - execute\$1script |
| 6060/7060 | PostReadyLocal/UserData - manage\$1package |
| 6070/7070 | PostReadyLocal/UserData - initialize\$1volume |
| 6080/7080 | PostReadyLocal/UserData - write\$1file |
| 6090/7090 | PostReadyLocal/UserData - start\$1ssm |
| 7100 | PostReadyUserData - enable\$1open\$1ssh |
| 6110/7110 | PostReadyLocal/UserData - enable\$1jumbo\$1frames |
## EC2Avvia l'output del registro della console v2
Questa sezione contiene esempi di output del log della console per EC2 Launch v2 ed elenca tutti i messaggi di errore del registro della console EC2 Launch v2 per aiutarti a risolvere i problemi. Per ulteriori informazioni sull'output della console di istanza e su come accedervi, consultare [Output della console delle istanze](troubleshoot-unreachable-instance.md#instance-console-console-output).
**Topics**
+ [EC2Output del log della console Launch v2](#ec2launchv2-console-log-output)
+ [EC2Messaggi di registro della console Launch v2](#ec2launchv2-console-log-messages)
### EC2Output del log della console Launch v2
Di seguito è riportato un esempio di output del log della console per EC2 Launch v2. Alcuni valori in questo esempio sono sostituiti con testo rappresentativo circondato da parentesi graffe.
```
2025/07/22 21:26:53Z: Windows sysprep configuration complete.
2025/07/22 21:26:53Z: Message: Waiting for access to metadata...
2025/07/22 21:26:53Z: Message: Meta-data is now available.
2025/07/22 21:26:53Z: AMI Origin Version: 2024.12.13
2025/07/22 21:26:53Z: AMI Origin Name: Windows_Server-2022-English-Full-Base
2025/07/22 21:26:53Z: OS: Microsoft Windows NT 10.0.20348
2025/07/22 21:26:53Z: OsVersion: 10.0
2025/07/22 21:26:53Z: OsProductName: Windows Server 2022 Datacenter
2025/07/22 21:26:53Z: OsBuildLabEx: 20348.1.amd64fre.fe_release.210507-1500
2025/07/22 21:26:53Z: OsCurrentBuild: 20348
2025/07/22 21:26:53Z: OsReleaseId: 2009
2025/07/22 21:26:53Z: Language: en-US
2025/07/22 21:26:53Z: TimeZone: UTC
2025/07/22 21:26:53Z: Offset: UTC +0000
2025/07/22 21:26:53Z: Launch: EC2 Launch v2.2.63
2025/07/22 21:26:53Z: AMI-ID: ami-1234567890abcdef1
2025/07/22 21:26:53Z: Instance-ID: i-1234567890abcdef0
2025/07/22 21:26:54Z: Instance Type: t3.xlarge
2025/07/22 21:26:54Z: Driver: AWS NVMe Driver v1.6.0.35
2025/07/22 21:26:54Z: SubComponent: 1.6.0.35; EnableSCSIPersistentReservations: 0
2025/07/22 21:26:54Z: Driver: AWS PV Driver Package v8.5.0
2025/07/22 21:26:55Z: Driver: Amazon Elastic Network Adapter v2.8.0.0
2025/07/22 21:26:55Z: HOSTNAME: EC2AMAZ-9FJG5CC
2025/07/22 21:26:55Z: RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
2025/07/22 21:26:55Z: RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
2025/07/22 21:26:56Z: SSM: Amazon SSM Agent v3.3.2746.0
2025/07/22 21:26:57Z: User data format: no_user_data
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentCommandErrorCode=1
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AdminPasswordTypeCode=0
2025/07/22 21:26:57Z: EC2LaunchTelemetry: AgentErrorLocation=execute_windows.go:410
2025/07/22 21:26:57Z: EC2LaunchTelemetry: IpConflictDetectionCode=0
2025/07/22 21:26:57Z: Message: Windows is Ready to use
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...}
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2", ...}
```
### EC2Messaggi di registro della console Launch v2
Di seguito è riportato un elenco di tutti i messaggi di registro della console EC2 Launch v2.
```
Error EC2Launch service is stopping. {error message}
```
Dettagli dell’errore di un servizio arrestato:
+ `Error setting up EC2Launch agent folders`
+ `See instance logs for detail`
+ `Error stopping service`
+ `Error initializing service`
```
Windows sysprep configuration complete
```
```
Invalid administrator username: {invalid username}
```
```
Invalid administrator password
Username: {username}
Password: {encrypted password}
```
Il messaggio seguente è un blocco di informazioni che contiene i dettagli dell’AMI:
```
AMI Origin Version: {amiVersion}
AMI Origin Name: {amiName}
Microsoft Windows NT {currentVersion}.{currentBuildNumber}
OsVersion: {currentVersion}
OsProductName: {productName}
OsBuildLabEx: {buildLabEx}
OsCurrentBuild: {currentBuild}
OsReleaseId: {releaseId}
Language: {language}
TimeZone: {timeZone}
Offset: UTC {offset}
Launch agent: EC2Launch {BuildVersion}
AMI-ID: {amiId}
Instance-ID: {instanceId}
Instance Type: {instanceType}
HOSTNAME: {computer name}
RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
SqlServerBilling: {sql billing}
SqlServerInstall: {sql patch leve, edition type}
Driver: AWS NVMe Driver {version}
Driver: Inbox NVMe Driver {version}
Driver: AWS PV Driver Package {version}
SSM: Amazon SSM Agent {version}
AWS VSS Version: {version}
```
```
Windows sysprep configuration complete.
Windows is being configured. 'SysprepState is {state}'
Windows is still being configured. 'SysprepState is {state}'
Windows is Ready to use
Waiting for access to metadata...
Meta-data is now available.
Metadata is not available for this instance.
Timed out waiting for access to metadata.
User data format: {format}
```
I messaggi di telemetria di EC2Launch v2 includono i valori delle proprietà di telemetria di avvio. A partire dalla versione 2.2.63, i dati di telemetria dell’agente EC2 sono formattati come oggetto JSON.
```
EC2LaunchTelemetry: {telemetry property}
```
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
# EC2Cronologie delle versioni di Launch v2
**Topics**
+ [EC2Cronologia delle versioni di Launch v2](#ec2launchv2-version-history)
## EC2Cronologia delle versioni di Launch v2
Per assicurarti di avere installato l’agente di avvio più recente, consulta [Installa la versione più recente di EC2 Launch v2](ec2launch-v2-install.md). Puoi ricevere notifiche quando vengono rilasciate nuove versioni dell'agente EC2 Launch v2. Per ulteriori informazioni, consulta [Iscriviti alle notifiche di Windows Launch Agent EC2](launch-agents-subscribe-notifications.md).
La tabella seguente descrive le versioni rilasciate di EC2 Launch v2.
| Versione | Dettagli | Data di rilascio |
| --- | --- | --- |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 marzo 2026 |
| 2.3.237 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 25 febbraio 2026 |
| 2.3.108 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 29 dicembre 2025 |
| 2,3,56 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 novembre 2025 |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15 settembre 2025 |
| 2.2.63 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 29 luglio 2025 |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 14 maggio 2025 |
| 2.0.2107 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 27 marzo 2025 |
| 2.0.2081 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 febbraio 2025 |
| 20,2046 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 ottobre 2024 |
| 2,0,1981 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 agosto 2024 |
| 2,0,1948 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 1° luglio 2024 |
| 2.0.1924 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10 giugno 2024 |
| 2.0.1914 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 giugno 2024 |
| 2.0.1881 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 maggio 2024 |
| 2.0.1815 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 marzo 2024 |
| 2.0,1739 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 17 gennaio 2024 |
| 2.0,1702 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 gennaio 2024 |
| 2.0.1643 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 ottobre 2023 |
| 2.0,1580 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 05 settembre 2023 |
| 2.0,1521 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 luglio 2023 |
| 2.0,1303 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 maggio 2023 |
| 2.0.1245 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 marzo 2023 |
| 2.0.1173 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 febbraio 2023 |
| 2,0,1121 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 gennaio 2023 |
| 2.0.1082 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7 dicembre 2022 |
| 2.0.1011 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 11 novembre 2022 |
| 2.0.1009 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 novembre 2022 |
| 2.0,982 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31 ottobre 2022 |
| 2.0,863 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 luglio 2022 |
| 2.0.698 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 30 gennaio 2022 |
| 2.0,6674 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15 novembre 2021 |
| 2.0.651 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7 ottobre 2021 |
| 2.0.592 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31 agosto 2021 |
| 2.0,548 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 agosto 2021 |
| 2.0,470 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 20 luglio 2021 |
| 2.0.285 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 marzo 2021 |
| 2.0.207 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 2 febbraio 2021 |
| 2.0.160 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 dicembre 2020 |
| 2.0.153 | Aggiunge la funzionalità Sysprep in. UserData | 3 novembre 2020 |
| 2.0.146 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 ottobre 2020 |
| 2.0.124 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10 settembre 2020 |
| 2.0.104 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 12 agosto 2020 |
| 2.0.0 | Versione iniziale. | 30 giugno 2020 |