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)