Utilizza l'agente EC2Launch v1 per eseguire attività durante l'avvio dell'istanza EC2 Windows - Amazon Elastic Compute Cloud
Attività EC2LaunchStruttura della directory di EC2LaunchTelemetria

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 v1 per eseguire attività durante l'avvio dell'istanza EC2 Windows

Le AMI gestite da Amazon per Windows Server 2016 e 2019 comprendono una serie di script Windows Powershell chiamati EC2Launch. EC2Launch esegue le operazioni durante l'avvio dell'istanza iniziale. Per ulteriori informazioni sulle versioni di EC2Launch incluse nelle AMI Windows AWS, consulta la pagina AWS Windows AMI Reference.

Nota

L’agente di avvio più recente per Windows Server 2016 e versioni successive del sistema operativo è EC2Launch v2 che sostituisce sia EC2Config che EC2Launch. È preinstallato sulle AMI AWS Windows Server 2016 e 2019, con nomi che iniziano con EC2LaunchV2-Windows_Server-*. Puoi anche installare e configurare manualmente l’agente su Windows Server 2016 e 2019. Per ulteriori informazioni, consulta Installare EC2Launch v2.

Per utilizzare EC2Launch con IMDSv2, la versione deve essere 1.3.2002730 o versione successiva.

Puoi utilizzare il seguente comando PowerShell di Windows per verificare la versione installata di EC2Launch.

Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version

Attività EC2Launch

EC2Launch esegue le seguenti operazioni per impostazione predefinita durante l'avvio dell'istanza iniziale:

  • Imposta un nuovo sfondo che esegue il rendering delle informazioni riguardanti l'istanza.

  • Imposta il nome del computer sull'indirizzo IPv4 privato dell'istanza.

  • Invia le informazioni di istanza alla console Amazon EC2.

  • Invia l'impronta del certificato RDP alla console EC2.

  • Imposta una password casuale per l'account dell'amministratore.

  • Aggiunge i suffissi DNS.

  • Estende in modo dinamico la partizione del sistema operativo per includere qualsiasi spazio non partizionato.

  • Esegue i dati utente (se specificato). Per ulteriori informazioni sulla specifica dei dati utente, consulta Esegui comandi all'avvio di un' EC2 istanza con input di dati utente.

  • Imposta routing statici persistenti per raggiungere il servizio di metadati e i server AWS KMS.

    Importante

    Se da questa istanza viene creata un'AMI personalizzata, i routing vengono acquisiti come parte della configurazione del sistema operativo e qualsiasi nuova istanza avviata dall'AMI avrà gli stessi routing, indipendentemente dal posizionamento della sottorete. Per aggiornare i routing, vedi Aggiornamento di routing KMS/metadati per il Server 2016 o versione successiva quando si lancia un'AMI personalizzata.

Le seguenti attività contribuiscono a mantenere la retrocompatibilità con il servizio EC2Config. È anche possibile configurare EC2Launch in modo che esegua queste attività durante li startup:

  • Inizializzare i volumi EBS secondari.

  • Inviare i log di eventi di Windows ai log della console EC2.

  • Inviare il messaggio Windows is ready to use (Windows è pronto per l'utilizzo) alla console EC2.

Struttura della directory di EC2Launch

Per impostazione predefinita, EC2Launch viene installato sulle AMI di Windows Server 2016 o versione successiva nella directory radice C:\ProgramData\Amazon\EC2-Windows\Launch.

Nota

Per impostazione predefinita, Windows nasconde i file e le cartelle in C:\ProgramData. Per visualizzare le directory e i file di EC2Launch, è necessario digitare il percorso in Windows Explorer risorse o modificare le proprietà della cartella per visualizzare i file e le cartelle nascosti.

La directory Launch contiene le sottodirectory seguenti.

  • Scripts - Contiene gli script PowerShell che compongono EC2Launch.

  • Module - Contiene il modulo per la creazione di script relativi a Amazon EC2.

  • Config - Contiene file di configurazione dello script che si possono personalizzare.

  • Sysprep - Contiene risorse Sysprep.

  • Settings - Contiene un'applicazione per l'interfaccia utente grafica di Sysprep.

  • Library: contiene librerie condivise per gli agenti di avvio di EC2.

  • Log: contiene sottodirectory per gli script e i file di log generati dagli script.

Telemetria

La telemetria offre informazioni aggiuntive che consentono ad AWS di comprendere meglio i tuoi requisiti, diagnosticare i problemi e fornire funzionalità per migliorare la tua esperienza con i servizi AWS.

EC2Launch versione 1.3.2003498 e successive raccolgono dati di telemetria, ad esempio parametri ed errori di utilizzo. Questi dati vengono raccolti dall'istanza Amazon EC2 su cui viene eseguito EC2Launch. Sono incluse tutte le AMI di Windows di proprietà di AWS.

EC2Launch raccoglie i seguenti tipi di telemetria:

  • Informazioni di utilizzo: comandi dell'agente, metodo di installazione e frequenza di esecuzione pianificata.

  • Errori e informazioni diagnostiche: installazione dell'agente ed esecuzione dei codici di errore.

Esempi di dati raccolti:

2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0

La telemetria è abilitata per impostazione predefinita. Puoi disabilitare la raccolta dati di telemetria in qualsiasi momento. Se la telemetria è abilitata, EC2Launch invia i dati di telemetria senza ulteriori notifiche ai clienti.

Viene registrata la scelta di abilitare o disabilitare la telemetria.

È possibile attivare o disattivare la raccolta di telemetria. La propria selezione per attivare o disattivare la telemetria viene raccolta per garantire l'adesione alla propria opzione di telemetria.

Visibilità della telemetria

Quando la telemetria è abilitata, viene visualizzata nell'output della console Amazon EC2 come segue:

2021/07/15 21:44:12Z: Telemetry: <Data>
Disabilitare la telemetria su un'istanza

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 durante l'installazione, eseguire install.ps1 come riportato:

. .\install.ps1 -EnableTelemetry:$false
Altri argomenti per EC2Launch