Utilizza l'agente EC2Launch v2 per eseguire attività durante l'avvio dell'istanza EC2 Windows - Amazon Elastic Compute Cloud
EC2Concetti di Launch v2EC2Panoramica delle attività di Launch v2EC2Launch v2: struttura di directoryTelemetria

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 AMIspagina 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

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

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.

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.

  • 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 PostReadyfase. Alcune versioni degli script vengono eseguite prima della PostReadyfase 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.

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 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. Per lo schema di configurazione delle attività e informazioni dettagliate, consulta EC2Avvia la configurazione delle attività v2.

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.

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.

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

msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
Altri argomenti per Launch v2 EC2