# Uso del agente EC2Launch v2 para realizar tareas durante la inicialización de una instancia de EC2
Todas las instancias admitidas de Amazon EC2 que se lanzan desde las AMI para Windows Server 2022 y Windows Server 2025 de AWS incluyen el agente de inicialización EC2Launch v2 (`EC2Launch.exe`) de manera predeterminada. También proporcionamos AMI de Windows Server 2016 y 2019 con EC2Launch v2 instalado como agente de inicialización predeterminado. Estas AMI se proporcionan de manera adicional a las AMI de Windows Server 2016 y 2019 que incluyen EC2Launch v1. Puede buscar AMI de Windows que incluyan EC2Launch v2 de manera predeterminada ingresando el siguiente prefijo en la búsqueda en la página **AMIs** de la consola de Amazon EC2: `EC2LaunchV2-Windows_Server-*`.
Para comparar las características de la versión del agente de inicialización, consulte [Comparación de los agentes de inicialización de Amazon EC2](configure-launch-agents.md#ec2launch-agent-compare).
EC2Launch v2 realiza tareas durante el inicio de la instancia y se ejecuta si una instancia se detiene y posteriormente se inicia, o se reinicia. EC2Launch v2 también puede realizar tareas bajo demanda. Algunas de estas tareas se activan automáticamente, mientras que otras se deben activar manualmente. El servicio EC2Launch v2 admite todas las características de EC2Config y EC2Launch.
Este servicio utiliza un archivo de configuración para controlar su funcionamiento. Puede actualizar el archivo de configuración mediante una herramienta gráfica o editándolo directamente como un archivo .yml único (`agent-config.yml`). Para obtener más información acerca de las ubicaciones de los archivos, consulte [Estructura del directorio de EC2Launch v2](#ec2launch-v2-directory).
EC2Launch v2 publica registros de eventos de Windows para ayudarlo a solucionar errores y establecer desencadenadores. Para obtener más información, consulte [Registros de eventos de Windows](ec2launchv2-troubleshooting.md#ec2launchv2-windows-event-logs).
**Versiones de sistemas operativos compatibles**
El agente EC2Launch v2 es compatible con las siguientes versiones del sistema operativo (SO) Windows Server:
+ Windows Server 2025
+ Windows Server 2022
+ Windows Server 2019 (canal de servicio a largo plazo y canal semestral)
+ Windows Server 2016
**Tareas que se ejecutan de forma predeterminada**
El agente EC2Launch v2 ejecuta las siguientes tareas solo una vez de forma predeterminada durante la primera inicialización de la instancia. Las tareas están organizadas según el orden en que se ejecutan dentro de su etapa de inicialización.
Etapa `Boot`
+ extendRootPartition
Etapa `PreReady`
+ activateWindows
+ setDnsSuffix
+ setAdminAccount
+ setWallpaper
Etapa `PostReady`
+ startSsm
## Conceptos de EC2Launch v2
Es útil entender los siguientes conceptos al considerar EC2Launch v2.
**agent-config**
`agent-config` es un archivo que se encuentra en la carpeta de configuración de EC2Launch v2. Incluye configuración para las etapas de arranque, red, PreReady y PostReady. Este archivo se utiliza con el objetivo de especificar la configuración de la instancia para las tareas que deben ejecutarse cuando la AMI se arranca por primera vez o las veces siguientes.
De forma predeterminada, la instalación de EC2Launch v2 instala un archivo `agent-config` que incluye configuraciones recomendadas que se utilizan en AMI estándar de Amazon Windows. Puede actualizar el archivo de configuración para modificar la experiencia de arranque predeterminada de la AMI que EC2Launch v2 especifique. Para obtener más información acerca de las ubicaciones de los archivos, consulte [Estructura del directorio de EC2Launch v2](#ec2launch-v2-directory).
**Frecuencia**
La frecuencia de las tareas determina cuándo deben ejecutarse las tareas, en función del contexto de arranque. La mayoría de las tareas solo tienen una frecuencia permitida. Puede especificar la frecuencia de las tareas de `executeScript`.
Verá las siguientes frecuencias en [Configuración de tareas de EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Una vez: la tarea se ejecuta una vez, cuando la AMI se ha arrancado por primera vez (Sysprep terminado).
+ Siempre: la tarea se ejecuta cada vez que se ejecuta el agente de inicialización. El agente de inicialización se ejecuta cuando:
+ una instancia se inicia o se reinicia
+ el servicio EC2Launch se ejecuta
+ `EC2Launch.exe run` se invoca
**Etapa**
Una etapa es una agrupación lógica de tareas que ejecuta el agente EC2Launch v2. Algunas tareas solo pueden ejecutarse en una etapa específica. Otras se pueden ejecutar en varias etapas. Al usar `agent-config.yml`, debe especificar una lista de etapas y una lista de tareas a ejecutar dentro de cada etapa.
El servicio ejecuta las etapas en el siguiente orden:
Fase 1: Iniciar
Fase 2: Red
Fase 3: PreReady
Windows está listo
Una vez finalizada la etapa de preparación previa, el servicio envía el mensaje `Windows is ready` a la consola Amazon EC2.
Etapa 4: PostReady
Los datos del usuario se ejecutan durante la etapa *PostReady*. Algunas versiones del script se ejecutan antes de la etapa *PostReady* del archivo `agent-config.yml` y otras después, de la siguiente manera:
Antes de `agent-config.yml`
+ Datos de usuario de YAML versión 1.1
+ Datos de usuario XML
Después de `agent-config.yml`
+ Datos de usuario de YAML, versión 1.0 (versión antigua para compatibilidad con versiones anteriores)
Para ver etapas y tareas de ejemplo, consulte [Ejemplo: `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config).
Cuando utilice datos de usuario, debe especificar una lista de tareas para que las ejecute el agente de inicialización. El escenario está implícito. Para ver tareas de ejemplo, consulte [Ejemplo: datos de usuario](ec2launch-v2-settings.md#ec2launch-v2-example-user-data).
EC2Launch v2 ejecuta la lista de tareas en el orden en que usted especifique en `agent-config.yml` y en los datos de usuario. Las etapas se ejecutan de forma secuencial. La siguiente etapa comienza una vez finalizada la anterior. Las tareas se ejecutan de forma secuencial.
**Tarea**
Puede invocar una tarea para que realice una acción en una instancia. Se pueden configurar las tareas en el archivo `agent-config.yml` o a través de los datos de usuario. Para obtener una lista de las tareas disponibles para EC2Launch v2, consulte [Tareas de EC2Launch v2](#ec2launch-v2-tasks). Para obtener información y el esquema sobre la configuración de tareas, consulte [Configuración de tareas de EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
**Datos de usuario**
Los datos de usuario son datos que se pueden configurar al iniciar una instancia. Puede actualizar los datos de usuario para cambiar dinámicamente el modo en que se configuran las AMI personalizadas o las AMI de inicio rápido. EC2Launch v2 admite una entrada de datos de usuario de 60 KB. Los datos de usuario incluyen sólo la etapa UserData y, por lo tanto, se ejecutan después del archivo `agent-config`. Puede introducir datos de usuario al iniciar una instancia utilizando el asistente de inicialización de instancias o modificar los datos de usuario desde la consola de EC2. Para obtener más información sobre el trabajo con datos de usuarios, consulte [Cómo gestiona Amazon EC2 los datos de usuario de las instancias de Windows](user-data.md#ec2-windows-user-data).
## Información general sobre las tareas de EC2Launch v2
EC2Launch v2 puede realizar las siguientes tareas en cada arranque:
+ Configure fondos de pantalla nuevos y personalizados opcionalmente en los que se representen información sobre la instancia.
+ Establezca los atributos de la cuenta de administrador que se crea en el equipo local.
+ Agregue sufijos de DNS a la lista de sufijos de búsqueda. Sólo se agregan a la lista los sufijos que aún no existen.
+ Establezca las letras de unidad para los volúmenes adicionales y amplíelas para utilizar el espacio disponible.
+ Escriba archivos desde la configuración en el disco.
+ Ejecute los scripts especificados en el archivo de configuración de EC2Launch v2 o desde `user-data`. Los scripts de `user-data` pueden ser texto plano o comprimidos y proporcionarse en formato base64.
+ Ejecute un programa con argumentos dados.
+ Establecer el nombre del equipo.
+ Enviar información de instancia a la consola de Amazon EC2.
+ Envía la huella digital del certificado RDP a la consola de Amazon EC2.
+ Ampliar dinámicamente la partición del sistema operativo para incluir cualquier espacio sin particionar.
+ Ejecute los datos del usuario. Para obtener más información acerca de cómo especificar datos de usuario, consulte [Configuración de tareas de EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-task-configuration).
+ Establezca rutas estáticas no persistentes para alcanzar el servicio de metadatos y los servidores AWS KMS.
+ Establezca las particiones que no sean de arranque en `mbr` o `gpt`.
+ Inicie el servicio Systems Manager tras Sysprep.
+ Optimice la configuración de ENA.
+ Habilite OpenSSH para versiones posteriores de Windows.
+ Habilite tramas gigantes.
+ Establezca Sysprep para que se ejecute con EC2Launch v2.
+ Publique registros de eventos de Windows.
## Estructura del directorio de EC2Launch v2
EC2Launch v2 debe instalarse en los siguientes directorios:
+ Binarios de servicio: `%ProgramFiles%\Amazon\EC2Launch`
+ Datos del servicio (configuración, archivos de registro y archivos de estado): `%ProgramData%\Amazon\EC2Launch`
**nota**
De manera predeterminada, Windows oculta los archivos y las carpetas en `C:\ProgramData`. Para ver los directorios y los archivos de EC2Launch v2, debe ingresar la ruta en Windows Explorer o cambiar las propiedades de la carpeta para mostrar los archivos y las carpetas ocultos.
El directorio `%ProgramFiles%\Amazon\EC2Launch` contiene binarios y bibliotecas auxiliares. Incluye los siguientes subdirectorios:
+ `settings`
+ `EC2LaunchSettingsUI.exe`: interfaz de usuario para modificar el archivo `agent-config.yml`
+ `YamlDotNet.dll`: DLL para admitir algunas operaciones en la interfaz de usuario
+ `tools`
+ `ebsnvme-id.exe`: herramienta para examinar los metadatos de los volúmenes de EBS en la instancia
+ `AWSAcpiSpcrReader.exe`: herramienta para determinar el puerto COM correcto que usar
+ `EC2LaunchEventMessage.dll`: DLL para admitir el registro de eventos de Windows para EC2Launch
+ `service`
+ `EC2LaunchService.exe`: ejecutable del servicio de Windows que se lanza cuando el agente de lanzamiento se ejecuta como un servicio
+ `EC2AgentTelemetry.dll`: DLL para admitir la telemetría de agentes de EC2
+ `EC2Launch.exe`: ejecutable principal de EC2Launch
+ `EC2LaunchAgentAttribution.txt`: atribución del código utilizado en EC2Launch
El directorio `%ProgramData%\Amazon\EC2Launch` contiene los subdirectorios siguientes. Todos los datos producidos por el servicio, incluidos los registros, la configuración y el estado, se almacenan en este directorio.
+ `config`: configuración
El archivo de configuración del servicio se almacena en este directorio como `agent-config.yml`. Este archivo se puede actualizar para modificar, agregar o eliminar tareas predeterminadas ejecutadas por el servicio. El permiso para crear archivos en este directorio se encuentra restringido a la cuenta de administrador a fin de evitar la escalada de privilegios.
+ `log`: registros de instancias
Los registros del servicio (`agent.log`), el rendimiento (`bench.log`) y la telemetría (`telemetry.log`) se almacenan en este directorio. Cuando `agent.log` alcanza un tamaño de 1 MB, se gira de forma automática y se crea un archivo de copia de seguridad con un formato de marca de tiempo (por ejemplo, `agent-2026-03-02T18-56-39.188.log`). Solo se mantiene un archivo de registro de copia de seguridad a la vez.
+ `state`: datos del estado del servicio
El estado que utiliza el servicio para determinar qué tareas deben ejecutarse se almacena aquí. Hay un archivo `.run-once` que indica si el servicio ya se ejecutó después de Sysprep (por lo que las tareas con una frecuencia de una vez se omitirán en la siguiente ejecución). Este subdirectorio incluye un `state.json` y `previous-state.json` para realizar un seguimiento del estado de cada tarea.
+ `sysprep`: Sysprep
Este directorio contiene archivos que se utilizan para determinar qué operaciones debe realizar Sysprep cuando crea una AMI de Windows personalizada que se puede reutilizar.
+ `wallpaper`: fondo de pantalla
Las imágenes de este fondo de pantalla se almacenan en este directorio.
## Telemetría
La telemetría es información adicional que ayuda a AWS a comprender mejor sus requisitos, diagnosticar problemas y ofrecer recursos para mejorar su experiencia con Servicios de AWS.
EC2Launch v2 versión `2.1.592` y posteriores recopilan telemetría, como métricas de uso y errores. Estos datos se recopilan de la instancia de Amazon EC2 en la que se ejecuta EC2Launch v2. Esto incluye todas las AMI de Windows que son propiedad de AWS.
EC2Launch v2 recopila los siguientes tipos de telemetría:
+ **Información de uso**: comandos del agente, método de instalación y frecuencia de ejecución programada.
+ **Errores e información de diagnóstico**: códigos de error de instalación del agente, códigos de error de ejecución y pilas de llamadas con error.
Ejemplos de datos recopilados desde la versión 2.0.592 hasta la 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 partir de la versión 2.2.63, los datos de telemetría de agentes de EC2 se formatean como un objeto JSON:
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
La telemetría se encuentra habilitada de forma predeterminada. Puede desactivar la recopilación de telemetría en cualquier momento.
**Desactivar la telemetría en una instancia**
Para desactivar la telemetría en una sola instancia, puede definir una variable de entorno del sistema o utilizar el MSI a fin de modificar la instalación.
Para desactivar la telemetría al establecer una variable de entorno de sistema, ejecute el siguiente comando como administrador.
```
setx /M EC2LAUNCH_TELEMETRY 0
```
Para desactivar la telemetría mediante el MSI, ejecute el siguiente comando después de [descargar el MSI](ec2launch-v2-install.md).
```
msiexec /i ".\AmazonEC2Launch.msi" Remove="Telemetry" /q
```
**Topics**
+ [Conceptos de EC2Launch v2](#ec2launch-v2-concepts)
+ [Información general sobre las tareas de EC2Launch v2](#ec2launch-v2-tasks)
+ [Estructura del directorio de EC2Launch v2](#ec2launch-v2-directory)
+ [Telemetría](#ec2launch-v2-telemetry)
+ [Instalar la versión más reciente de EC2Launch v2](ec2launch-v2-install.md)
+ [Configuración de EC2Launch v2 en instancias de Windows](ec2launch-v2-settings.md)
+ [Definiciones de tareas para tareas de inicio de EC2Launch v2](ec2launch-v2-task-definitions.md)
+ [Solución de problemas con el agente EC2Launch v2](ec2launchv2-troubleshooting.md)
+ [Historiales de versiones de EC2Launch v2](ec2launchv2-versions.md)
# Instalar la versión más reciente de EC2Launch v2
Puede utilizar uno de los siguientes métodos para instalar el agente EC2Launch v2 en su instancia de EC2:
+ Descargue el agente de Amazon S3 e instálelo con Windows PowerShell. Para obtener URL de descargas, consulte [Descargas de EC2Launch v2 en Amazon S3](#lv2-download-s3).
+ Instale desde SSM Distributor.
+ Instale desde un componente del Generador de imágenes de EC2 al crear una imagen personalizada.
+ Lance la instancia desde una AMI que tenga EC2Launch v2 preinstalado.
**aviso**
AmazonEC2Launch.msi desinstala versiones anteriores de los servicios de inicialización de EC2, como EC2Launch (v1) y EC2Config.
Para ver los pasos de instalación, seleccione la pestaña que coincida con su método preferido.
------
#### [ PowerShell ]
Para instalar la versión más reciente del agente EC2Launch v2 con Windows PowerShell, siga estos pasos.
1. Cree su directorio local.
```
New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
```
1. Configure la URL de la ubicación de descarga. Ejecute el siguiente comando con la URL de Amazon S3 que utilizará. Para obtener URL de descargas, consulte [Descargas de EC2Launch v2 en Amazon S3](#lv2-download-s3)
```
$Url = "Amazon S3 URL/AmazonEC2Launch.msi"
```
1. Utilice el siguiente comando compuesto para descargar el agente y ejecutar la instalación
```
$DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
msiexec /i "$DownloadFile"
```
**nota**
Si recibe un error al descargar el archivo y está usando Windows Server 2016 o una versión anterior, es posible que sea necesario habilitar TLS 1.2 para su terminal PowerShell. Puede habilitar TLS 1.2 para la sesión actual de PowerShell con el siguiente comando y luego volver a intentarlo:
```
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
```
1. El comando **msiexec** instala EC2Launch v2 en la siguiente ubicación en las instancias de Windows Server: `%ProgramFiles%\Amazon\EC2Launch`. Para comprobar que la instalación se ha ejecutado, puede comprobar el sistema de archivos local de la instancia.
------
#### [ AWS Systems Manager Distributor ]
Para configurar las actualizaciones automáticas de EC2launch v2 con configuración AWS Systems Manager rápida, consulte [Instale y actualice de forma automática con la configuración rápida del distribuidor.](#lv2-distributor-quick-setup).
También puede realizar una instalación única del `AWSEC2Launch-Agent` paquete desde AWS Systems Manager Distributor. Para obtener instrucciones sobre cómo instalar un paquete desde Systems Manager Distributor, consulte [Instalar o actualizar paquetes](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) en la *Guía del usuario de AWS Systems Manager*.
------
#### [ EC2 Image Builder component ]
Puede instalar el componente `ec2launch-v2-windows` cuando crea una imagen personalizada con EC2 Image Builder. Para obtener instrucciones sobre cómo crear una imagen personalizada con EC2 Image Builder, consulte[Creación de una canalización de imágenes utilizando el asistente de consola de EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) en la *Guía del usuario de EC2 Image Builder*.
------
#### [ AMI ]
EC2Launch v2 está preinstalado de forma predeterminada en las AMI de los sistemas operativos Windows Server 2022 y versiones posteriores:
+ Windows\$1Server-*version*-English-Full-Base
+ Windows\$1Server-*version*-English-Core-Base
+ Windows\$1Server-*version*-English-Core-EKS\$1Optimized
+ AMI de la *versión* de Windows Server con todos los demás idiomas
+ AMI de la *versión* de Windows Server con SQL instalado
EC2Launch v2 también está preinstalado en las siguientes AMI de Windows Server. Puede encontrar estas AMI en la consola de Amazon EC2 o utilizando el siguiente prefijo de búsqueda: `EC2LaunchV2-` en la AWS CLI.
+ EC2LaunchV2-Windows\$1Server-2019-English-Core-Base
+ EC2LaunchV2-Windows\$1Server-2019-English-Full-Base
+ EC2LaunchV2-Windows\$1Server-2016-English-Core-Base
+ EC2LaunchV2-Windows\$1Server-2016-English-Full-Base
------
## Instale y actualice EC2Launch v2 de forma automática con la configuración rápida del distribuidor de AWS Systems Manager.
Con la configuración rápida del distribuidor de AWS Systems Manager, puede configurar actualizaciones automáticas para EC2launch v2. El siguiente proceso configura una Asociación de Systems Manager en la instancia que actualiza automáticamente el agente EC2Launch v2 con la frecuencia que especifique. La asociación que crea la configuración rápida del distribuidor puede incluir instancias de una región y Cuenta de AWS, o instancias de una organización AWS. Para obtener más información sobre cómo crear una organización, consulte [Tutorial: Creación y configuración de una organización](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html) en la *AWS OrganizationsGuía del usuario*.
Antes de comenzar, asegúrese de que las instancias cumplen todos los requisitos previos.
### Requisitos previos
Para configurar las actualizaciones automáticas con la configuración rápida del distribuidor, las instancias deben cumplir los siguientes requisitos previos.
+ Tiene al menos una instancia en ejecución que admite EC2Launch v2. Consulte los sistemas operativos admitidos por [EC2Launch v2](ec2launch-v2.md).
+ Ha realizado las tareas de configuración de Systems Manager en sus instancias. Para obtener más información, consulte [Configuración de Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html) en la *AWS Systems ManagerGuía del usuario*.
+ EC2Launch v2 debe ser el único agente de lanzamiento instalado en su instancia. Si tiene más de un agente de lanzamiento instalado, la configuración rápida del distribuidor fallará. Antes de configurar EC2Launch v2 con una configuración rápida del distribuidor, desinstale los agentes de lanzamiento de EC2Config o EC2Launch v1, si existen.
### Cómo configurar la configuración rápida del distribuidor para EC2Launch v2
Para crear una configuración para EC2Launch v2 con la configuración rápida del distribuidor, utilice las siguientes configuraciones cuando complete los pasos para la [implementación del paquete de distribuidor:](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html)
+ **Paquetes de software: Agente** Amazon EC2Launch v2.
+ **Frecuencia de actualización:** Seleccione una frecuencia de la lista.
+ **Objetivos:** Elija entre las opciones de implementación disponibles.
Para comprobar el estado de la configuración, vaya a la pestaña **Configuraciones** de configuración rápida de Systems Manager en el Consola de administración de AWS.
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, elija **Quick Setup**.
1. En la pestaña **Configuraciones**, seleccione la fila asociada a la configuración que creó. La pestaña **Configuraciones** muestra las configuraciones e incluye un resumen de los detalles clave, como la **región**, el estado de la **implementación y el estado** de **la asociación**.
**nota**
El nombre de la asociación de cada configuración de EC2Launch v2 Distributor comienza con el siguiente prefijo: `AWS-QuickSetup-Distributor-EC2Launch-Agent-`.
1. Para ver los detalles, seleccione la configuración y elija **Ver detalles.**
Para obtener más información y los pasos de solución de problemas, consulte los [resultados de solución de problemas de la configuración rápida](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-results-troubleshooting.html) en la *AWS Systems ManagerGuía del usuario*.
## Descargas de EC2Launch v2 en Amazon S3
Para instalar la versión más reciente de EC2Launch v2, descargue el instalador de la siguiente ubicación:
+ [https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi](https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi)
## Configurar las opciones de instalación
Al instalar o actualizar EC2Launch v2, puede configurar las opciones de instalación con el cuadro de diálogo de instalación de EC2Launch v2 o con el comando **msiexec** en una consola de línea de intérprete de comandos.
La primera vez que el instalador de EC2Launch v2 se ejecuta en una instancia, inicializa la configuración del agente de inicialización de la instancia de la siguiente manera:
+ Crea la ruta local y escribe en ella el archivo del agente de inicialización. Esto a veces se denomina *instalación limpia*.
+ Crea la variable de entorno `EC2LAUNCH_TELEMETRY` si aún no existe, y la establece en función de su configuración.
Para obtener detalles de configuración, seleccione la pestaña que coincida con el método de configuración que utilizará.
------
#### [ Amazon EC2Launch Setup dialog ]
Al instalar o actualizar EC2Launch v2, puede configurar las siguientes opciones de instalación a través del cuadro de diálogo de instalación de EC2Launch v2.Opciones de **instalación básica**
**Enviar telemetría**
Al incluir esta característica en el cuadro de diálogo de configuración, el instalador establece la variable de entorno `EC2LAUNCH_TELEMETRY` hasta un valor de `1`. Si deshabilita **Enviar telemetría**, el instalador establece la variable de entorno en un valor de `0`.
Cuando se ejecuta el agente EC2Launch v2, lee la variable de entorno `EC2LAUNCH_TELEMETRY` para determinar si se deben cargar datos de telemetría. Si el valor es igual a `1`, carga los datos. De lo contrario, no los carga.
**Configuración predeterminada**
La configuración predeterminada de EC2Launch v2 consiste en sobrescribir el agente de inicialización local si ya existe. La primera vez que ejecuta una instalación en una instancia, la configuración predeterminada realiza una instalación limpia. Si deshabilita la configuración predeterminada en la instalación inicial, se producirá un error en la instalación.
Si vuelve a ejecutar la instalación en la instancia, puede deshabilitar la configuración predeterminada para realizar una actualización que no sustituya el archivo `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`.
**Ejemplo: actualizar EC2Launch v2 con telemetría**
El siguiente ejemplo muestra el cuadro de diálogo de configuración de EC2Launch v2 configurado para actualizar la instalación actual y habilitar la telemetría. Esta configuración realiza una instalación sin reemplazar el archivo de configuración del agente y establece la variable de entorno `EC2LAUNCH_TELEMETRY` hasta un valor de `1`.
![\[Configuración de actualización de EC2Launch v2.\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png)
------
#### [ Command line ]
Al instalar o actualizar EC2Launch v2, puede configurar las siguientes opciones de instalación con el comando **msiexec** en una consola de línea de intérprete de comandos.Valores de parámetro `ADDLOCAL`
**Básico** (obligatorio)
Instale el agente de inicialización. Si este valor no está presente en el parámetro `ADDLOCAL`, finaliza la instalación.
**Limpio**
Cuando incluye el valor `Clean` en el parámetro `ADDLOCAL`, el instalador escribe el archivo de configuración del agente en la siguiente ubicación: `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml`. Si el archivo de configuración del agente ya existe, lo sobrescribe.
Cuando salga del valor `Clean` fuera del parámetro `ADDLOCAL`, el instalador realiza una actualización que no reemplaza el archivo de configuración del agente.
**Telemetría**
Cuando incluye el valor `Telemetry` en el parámetro `ADDLOCAL`, el instalador establece loa variable de entrono `EC2LAUNCH_TELEMETRY` hasta un valor de `1`.
Cuando salga del valor `Telemetry` fuera del parámetro `ADDLOCAL`, el instalador establece la variable de entorno en un valor de `0`.
Cuando se ejecuta el agente EC2Launch v2, lee la variable de entorno `EC2LAUNCH_TELEMETRY` para determinar si se deben cargar datos de telemetría. Si el valor es igual a `1`, carga los datos. De lo contrario, no los carga.
**Ejemplo: instalar EC2Launch v2 con telemetría**
```
& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q
```
------
## Verificar la versión de EC2Launch v2
Siga uno de los procedimientos siguientes para verificar la versión de EC2Launch v2 instalada en las instancias.
------
#### [ PowerShell ]
Verifique la versión instalada de EC2Launch v2 con Windows PowerShell de la siguiente manera.
1. Lance una instancia desde la AMI y conéctese a ella.
1. Ejecute el siguiente comando en PowerShell para verificar la versión instalada de EC2Launch v2:
```
& "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
```
------
#### [ Windows Control Panel ]
Verifique la versión instalada de EC2Launch v2 en el panel de control de Windows de la siguiente manera.
1. Lance una instancia desde la AMI y conéctese a ella.
1. Abra el panel de control de Windows y elija **Programas y características**.
1. En la lista de programas instalados, busque `Amazon EC2Launch`. Su número de versión aparece en la columna **Version** (Versión).
------
Para ver las actualizaciones más recientes de las AMI de Windows de AWS, consulte el [historial de versiones de las AMI de Windows](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html) en la *Referencia de las AMI de Windows de AWS*.
Para obtener la última versión de EC2Launch v2, consulte [Historial de versiones de EC2Launch v2](ec2launchv2-versions.md#ec2launchv2-version-history).
Puede recibir notificaciones cuando se publiquen nuevas versiones del servicio EC2Launch v2. Para obtener más información, consulte [Suscripción a las notificaciones del agente de inicialización de Windows de EC2](launch-agents-subscribe-notifications.md).
# Configuración de EC2Launch v2 en instancias de Windows
Esta sección contiene información acerca de cómo configurar las opciones para EC2Launch v2.
**Topics**
+ [Cambiar la configuración mediante el cuadro de diálogo de configuración de EC2Launch v2](#ec2launch-v2-ui)
+ [Configurar EC2Launch v2 mediante la CLI](#ec2launch-v2-cli)
+ [Configuración de tareas de EC2Launch v2](#ec2launch-v2-task-configuration)
+ [Códigos de salida y reinicios de EC2Launch v2](#ec2launch-v2-exit-codes-reboots)
+ [EC2Launch v2 y Sysprep](#ec2launch-v2-sysprep)
## Cambiar la configuración mediante el cuadro de diálogo de configuración de EC2Launch v2
El siguiente procedimiento describe cómo utilizar el cuadro de diálogo de configuración de EC2Launch v2 para habilitar o desactivar la configuración.
**nota**
Si configuró de forma incorrecta las tareas personalizadas en el archivo agent-config.yml e intenta abrir el cuadro de diálogo configuración de Amazon EC2Launch, recibirá un mensaje de error. Para ver un esquema de ejemplo, consulte [Ejemplo: `agent-config.yml`](#ec2launch-v2-example-agent-config).
1. Lance y conéctese a la instancia de Windows.
1. En el menú Inicio, elija **Todos los programas** y, a continuación, vaya a la **Configuración de EC2Launch**. Antes de elegir **Apagar con Sysprep** o **Apagar sin Sysprep**, asegúrese de guardar los cambios que desee aplicar al ejecutar el apagado.
![\[Aplicación de configuración de inicialización de EC2.\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/images/ec2launchv2-settings.png)
1. En la pestaña **General** del cuadro de diálogo **Configuración de EC2Launch**, puede habilitar o desactivar la siguiente configuración.
1. **Set Computer Name (Establecer nombre del equipo**
Si esta configuración está habilitada (está desactivada de forma predeterminada), el nombre de host actual se compara con el nombre de host deseado en cada arranque. Si los nombres de host no coinciden, el nombre de host se restablece y el sistema, opcionalmente, se reinicia para recoger el nuevo nombre de host. Si no se especifica un nombre de host personalizado, se genera mediante la dirección IPv4 privada con formato hexadecimal, por ejemplo, `ip-AC1F4E6`. Para evitar que se modifique el nombre de host no habilite esta opción.
1. **Extender volumen de arranque**
Esta opción amplía dinámicamente `Disk 0`/`Volume 0` para incluir cualquier espacio sin particionar. Esto puede resultar útil cuando la instancia se arranca desde un volumen raíz con un tamaño personalizado.
1. **Establecer cuenta de administrador**
Cuando está habilitado, puede establecer los atributos de nombre de usuario y contraseña para la cuenta de administrador que se crea en el equipo local. Si esta característica no está habilitada, no se crea una cuenta de administrador en el sistema después de Sysprep. Proporcione una contraseña en `adminPassword` solo si `adminPasswordtype` es `Specify`.
Los tipos de contraseñas se definen de la siguiente manera:
1. `Random`
EC2Launch genera una contraseña y la cifra usando la clave del usuario. El sistema deshabilita esta configuración tras la inicialización de la instancia para que esta contraseña persista si la instancia se reinicia o si se detiene y se inicia.
1. `Specify`
EC2Launch usa la contraseña que ha especificado en `adminPassword`. Si la contraseña no cumple los requisitos del sistema, EC2Launch genera una contraseña aleatoria en su lugar. La contraseña se almacena en `agent-config.yml` como texto sin cifrar y se elimina cuando Sysprep define la contraseña del administrador. EC2Launch cifra la contraseña usando la clave del usuario.
1. `Do not set`
EC2Launch utiliza la contraseña especificada en el archivo unattend.xml. Si no especifica una contraseña en unattend.xml, la cuenta del administrador se desactiva.
1. **Iniciar servicio SSM**
Cuando se selecciona, el servicio Systems Manager queda habilitado para comenzar después de Sysprep. EC2Launch v2 realiza todas las tareas descritas [anteriormente](ec2launch-v2.md#ec2launch-v2-tasks), y SSM Agent procesa las solicitudes para las funcionalidades de Systems Manager, como Run Command y administrador de estados.
Puede usar Run Command para actualizar las instancias existentes de manera que utilicen la versión más reciente del servicio EC2Launch v2 y de SSM Agent. Para obtener más información, consulte [Actualización del agente de SSM mediante el comando de ejecución](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command-tutorial-update-software.html) en la *Guía del usuario de AWS Systems Manager*.
1. **Optimizar ENA**
Cuando se selecciona, la configuración de ENA se configura para garantizar que la configuración del escalado del lado de recepción de ENA y la configuración de profundidad de cola de recepción se optimizan para AWS. Para obtener más información, consulte [Configurar la afinidad de CPU de escalado del lado de recepción](enhanced-networking-os.md#windows-rss-cpu-affinity).
1. **Habilitar SSH**
Esta configuración habilita OpenSSH para versiones posteriores de Windows para permitir la administración remota del sistema.
1. **Habilitar tramas gigantes**
Seleccione esta opción para habilitar las tramas gigantes. Las tramas gigantes pueden tener efectos no deseados en las comunicaciones de red, así que asegúrese de comprender cómo afectarán las tramas gigantes al sistema antes de habilitarlas. Para obtener más información acerca de las tramas gigantes, consulte [Tramas gigantes (9 001 MTU)](network_mtu.md#jumbo_frame_instances).
1. **Preparativos para la creación de imágenes**
Seleccione si desea que su instancia de EC2 se cierre con o sin Sysprep. Cuando desee ejecutar Sysprep con EC2Launch v2, elija **“Shutdown with Sysprep” (Apagar con Sysprep)**.
1. En la pestaña **Sufijo de DNS**, puede seleccionar si desea agregar una lista de sufijos DNS para la resolución DNS de los servidores que se ejecutan en EC2, sin proporcionar el nombre de dominio completo. Los sufijos de DNS pueden contener las variables `$REGION` y `$AZ`. Solo se agregarán a la lista los sufijos que aún no existan.
![\[Aplicación de configuración de inicialización de EC2.\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/images/ec2launchv2-dns.png)
1. En la pestaña **Fondo de pantalla**, puede configurar el fondo de pantalla de la instancia con una imagen de fondo y especificar los detalles de la instancia para que se muestre el fondo de pantalla. Amazon EC2 genera los detalles cada vez que inicia sesión.
Puede configurar su fondo de pantalla con los siguientes controles.
+ **Mostrar detalles de la instancia en el fondo de pantalla**: esta casilla de verificación activa o desactiva la visualización de detalles de la instancia en el fondo de pantalla.
+ **Ruta de la imagen (.jpg)**: especifique la ruta a la imagen que se va a utilizar como fondo de pantalla.
+ **Seleccionar atributos que mostrar en el fondo de pantalla**: seleccione las casillas con los detalles de la instancia que quiere que aparezcan en el fondo de pantalla. Desactive las casillas de verificación que anteriormente seleccionadas para detalles de instancias que quiere eliminar del fondo de pantalla.
+ **Mostrar etiquetas de la instancia en el fondo de pantalla**: seleccione una de las siguientes configuraciones para mostrar etiquetas de la instancia en el fondo de pantalla:
+ **Ninguna**: no muestra ninguna etiqueta de instancia en el fondo de pantalla.
+ **Mostrar todas**: muestra todas las etiquetas de instancia en el fondo de pantalla.
+ **Mostrar solo las filtradas**: muestra las etiquetas de instancia especificadas en el fondo de pantalla. Al seleccionar esta configuración, puede agregar las etiquetas de instancia que quiera que se muestren en su fondo de pantalla en el cuadro **Filtro de etiquetas de instancia**.
**nota**
Debe habilitar las etiquetas en los metadatos para que se muestren en el fondo de pantalla. Para obtener más información acerca de las etiquetas y metadatos de instancias, consulte [Visualización de etiquetas para las instancias de EC2 mediante los metadatos de la instancia](work-with-tags-in-IMDS.md).
![\[Pestaña EC2 Launch settings Wallpaper (Fondo de pantalla de EC2 Launch Settings).\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/images/ec2launchv2-wallpaper-02.png)
1. En la pestaña **Volúmenes**, seleccione si desea inicializar los volúmenes asociados a la instancia. La habilitación establece letras de unidad para cualquier volumen adicional y las amplía para utilizar el espacio disponible. Si selecciona **Todo**, se inicializarán todos los volúmenes de almacenamiento. Si selecciona **Dispositivos**, solo se inicializarán los dispositivos especificados en la lista. Debe escribir el dispositivo para cada dispositivo que se inicialice. Utilice los dispositivos enumerados en la consola de EC2, por ejemplo, `xvdb` o `/dev/nvme0n1`. La lista desplegable muestra los volúmenes de almacenamiento asociados a la instancia. Para introducir un dispositivo que no esté asociado a la instancia, escríbalo en el campo de texto.
**Nombre**, **Letra** y **Partición** son campos opcionales. Si no se especifica ningún valor para **Partición**, los volúmenes de almacenamiento más grandes que 2 TB se inicializan con el tipo de partición `gpt`, mientras que los más chicos que 2 TB se inicializan con el tipo de partición `mbr`. Si los dispositivos están configurados y un dispositivo que no sea NTFS contiene una tabla de particiones o los primeros 4 KB del disco contienen datos, se omite el disco y se registra la acción.
![\[Aplicación de configuración de inicialización de EC2.\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/images/ec2launchv2-volumes.png)
## Configurar EC2Launch v2 mediante la CLI
Puede utilizar la interfaz de línea de comandos (CLI) para ajustar la configuración de EC2Launch y administrar el servicio. La siguiente sección contiene descripciones e información de uso de los comandos de la CLI que puede utilizar para administrar EC2Launch 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)
+ [validar](#ec2launch-v2-validate)
+ [versión](#ec2launch-v2-version)
+ [fondo de pantalla](#ec2launch-v2-wallpaper)
### collect-logs
Recopila archivos de registro para EC2Launch, comprime los archivos y los coloca en un directorio especificado.
**Ejemplo**
```
ec2launch collect-logs -o C:\Mylogs.zip
```
**Uso**
`ec2launch collect-logs [flags]`
**Flags**
`-h`, `--help`
ayuda para `collect-logs`
`-o`, `--output string`
ruta a los archivos de registro de salida comprimidos
### get-agent-config
Imprime `agent-config.yml` en el formato especificado (JSON o YAML). Si no se especifica ningún formato, `agent-config.yml` se imprime en el formato especificado anteriormente.
**Ejemplo**
```
ec2launch get-agent-config -f json
```
**Uso**
`ec2launch get-agent-config [flags]`
**Flags**
`-h`, `--help`
ayuda para `get-agent-config`
`-f`, `--format string`
formato de salida del archivo `agent-config`: `json`, `yaml`
### list-volumes
Muestra todos los volúmenes de almacenamiento asociados a la instancia, incluidos los volúmenes efímeros y de EBS.
**Ejemplo**
```
ec2launch list-volumes
```
**Uso**
`ec2launch list-volumes`
**Flags**
`-h`, `--help`
ayuda para `list-volumes`
### reset
El objetivo principal de esta tarea es restablecer el agente para la próxima vez que se ejecute. Con este objetivo, el comando **reset** elimina todos los datos de estado del agente para EC2Launch v2 del directorio local de `EC2Launch` (consulte [Estructura del directorio de EC2Launch v2](ec2launch-v2.md#ec2launch-v2-directory)). Restablecer elimina de manera opcional el servicio y los registros de Sysprep.
El comportamiento de los scripts depende del modo en el que el agente los ejecute: en línea o de forma independiente.
En línea (predeterminado)
El agente de EC2Launch v2 ejecuta los scripts de uno en uno (`detach: false`). Este es el valor predeterminado.
Cuando el script en línea emite un comando **reset** o **sysprep**, se ejecuta de manera inmediata y restablece el agente. La tarea actual finaliza y, a continuación, el agente se cierra sin ejecutar ninguna otra tarea.
Por ejemplo, si la tarea que emite el comando hubiera estado seguida de una tarea `startSsm` (incluida de forma predeterminada cuando se ejecutan los datos del usuario), la tarea no se ejecutaría y el servicio Systems Manager nunca se iniciaría.
Desconectado
El agente EC2Launch v2 ejecuta scripts de manera simultánea a otras tareas (`detach: true`).
Cuando el script independiente emite un comando **reset** o **sysprep**, dichos comandos esperan a que el agente termine antes de ejecutarse. Las tareas posteriores a executeScript seguirán ejecutándose.
**Ejemplo**
```
ec2launch reset -c
```
**Uso**
`ec2launch reset [flags]`
**Flags**
`-c`, `--clean`
limpia los registros de instancias antes de `reset`
`-h`, `--help`
ayuda para `reset`
### run
Ejecuciones de EC2Launch v2.
**Ejemplo**
```
ec2launch run
```
**Uso**
`ec2launch run [flags]`
**Flags**
`-h`, `--help`
ayuda para `run`
### status
Obtiene el estado del agente EC2Launch v2. Opcionalmente bloquea el proceso hasta que finalice el agente. El código de salida del proceso determina el estado del agente:
+ `0`: el agente se ejecutó con éxito.
+ `1`: el agente se ejecutó de forma incorrecta.
+ `2`: el agente sigue en ejecución.
+ `3`: el agente se encuentra en estado desconocido. El estado del agente es detenido o sin ejecución.
+ `4`: se produjo un error al intentar recuperar el estado del agente.
+ `5`: el agente no se está ejecutando y se desconoce el estado de la última ejecución registrada. Esto podría significar una de las siguientes opciones:
+ tanto el `state.json` y `previous-state.json` se han eliminado.
+ el `previous-state.json` se encuentra dañado.
Este es el estado del agente después de ejecutar el comando [`reset`](#ec2launch-v2-reset).
**Ejemplo:**
```
ec2launch status -b
```
**Uso**
`ec2launch status [flags]`
**Flags**
`-b`,`--block`
bloquea el proceso hasta que el agente termine de ejecutarse
`-h`,`--help`
ayuda para `status`
### sysprep
El objetivo principal de esta tarea es restablecer el agente para la próxima vez que se ejecute. Para ello, el comando **sysprep** restablece el estado del agente, actualiza el archivo `unattend.xml`, desactiva RDP y ejecuta Sysprep.
El comportamiento de los scripts depende del modo en el que el agente los ejecute: en línea o de forma independiente.
En línea (predeterminado)
El agente de EC2Launch v2 ejecuta los scripts de uno en uno (`detach: false`). Este es el valor predeterminado.
Cuando el script en línea emite un comando **reset** o **sysprep**, se ejecuta de manera inmediata y restablece el agente. La tarea actual finaliza y, a continuación, el agente se cierra sin ejecutar ninguna otra tarea.
Por ejemplo, si la tarea que emite el comando hubiera estado seguida de una tarea `startSsm` (incluida de forma predeterminada cuando se ejecutan los datos del usuario), la tarea no se ejecutaría y el servicio Systems Manager nunca se iniciaría.
Desconectado
El agente EC2Launch v2 ejecuta scripts de manera simultánea a otras tareas (`detach: true`).
Cuando el script independiente emite un comando **reset** o **sysprep**, dichos comandos esperan a que el agente termine antes de ejecutarse. Las tareas posteriores a executeScript seguirán ejecutándose.
**Ejemplo:**
```
ec2launch sysprep
```
**Uso**
`ec2launch sysprep [flags]`
**Flags**
`-c`,`--clean`
limpia los registros de instancias antes de `sysprep`
`-h`,`--help`
ayuda para Sysprep
`-s`,`--shutdown`
cierra la instancia después de `sysprep`
### validar
Valida el archivo `agent-config` `C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml`.
**Ejemplo**
```
ec2launch validate
```
**Uso**
`ec2launch validate [flags]`
**Flags**
-h` `, `--help`
ayuda para `validate`
### versión
Obtiene la versión ejecutable.
**Ejemplo**
```
ec2launch version
```
**Uso**
`ec2launch version [flags]`
**Flags**
`-h`, `--help`
ayuda para `version`
### fondo de pantalla
Establece el nuevo fondo de pantalla en la ruta de fondo de pantalla que se proporciona (archivo .jpg) y muestra los detalles de la instancia seleccionada.
#### Sintaxis
```
ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,ipv6Address,instanceSize,availabilityZone,architecture
```
#### Entradas
Parameters
**--allowed-tags [*nombre-etiqueta-1*, *nombre-etiqueta-n*]**
(Opcional) Matriz JSON codificada en Base64 de nombres de etiquetas de instancia para mostrarla en el fondo de pantalla. Puede utilizar esta etiqueta o `--all-tags`, pero no ambas.
**--attributes *cadena-de-atributos-1*, *cadena-de-atributos-n***
(Opcional) Lista separada por comas de `wallpaper` cadenas de atributos para aplicar la configuración al fondo de pantalla.
**[--path\$1 -p] *cadena-de-ruta***
(Obligatorio) Especifique la ruta del archivo de imagen de fondo de `wallpaper`.Indicadores
**--all-tags**
(Opcional) Muestre todas las etiquetas de instancia en el fondo de pantalla. Puede utilizar esta etiqueta o `--allowed-tags`, pero no ambas.
**[--help \$1 -h]**
Muestra ayuda para el comando **wallpaper**.
## Configuración de tareas de EC2Launch v2
Esta sección incluye el esquema de configuración, las tareas, detalles y ejemplos para `agent-config.yml` y datos del usuario.
**Topics**
+ [Esquema: `agent-config.yml`](#ec2launch-v2-schema-agent-config)
+ [Configuración de los scripts de datos de usuario de EC2Launch v2 que se ejecutan durante el inicio o el reinicio](#ec2launch-v2-schema-user-data)
### Esquema: `agent-config.yml`
La estructura del archivo `agent-config.yml` se muestra a continuación. Tenga en cuenta que no es posible repetir una tarea en la misma etapa. Para ver las propiedades de las tareas, consulte las descripciones de tareas siguientes.
#### Estructura 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:
...
...
...
```
#### Ejemplo: `agent-config.yml`
En el ejemplo siguiente se muestran los valores del archivo de configuración `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
```
### Configuración de los scripts de datos de usuario de EC2Launch v2 que se ejecutan durante el inicio o el reinicio
Los siguientes ejemplos de JSON y YAML muestran la estructura del documento para los datos de usuario. Amazon EC2 analiza cada tarea nombrada en la matriz `tasks` que especifique en el documento. Cada tarea tiene su propio conjunto de propiedades y requisitos. Para obtener información detallada, consulte [Definiciones de tareas para tareas de inicio de EC2Launch v2](ec2launch-v2-task-definitions.md).
**nota**
Una tarea solo debe aparecer una vez en la matriz de tareas de datos de usuario.
#### Estructura del documento: datos de usuario
**JSON**
```
{
"version": "1.1",
"tasks": [
{
"task": "string",
"inputs": {
...
},
},
...
]
}
```
**YAML**
```
version: 1.1
tasks:
- task: string
inputs:
...
...
```
#### Ejemplo: datos de usuario
Para obtener más información sobre datos de usuario, consulte [Cómo gestiona Amazon EC2 los datos de usuario de las instancias de Windows](user-data.md#ec2-windows-user-data).
El siguiente ejemplo de documento YAML muestra un script de PowerShell que EC2Launch v2 ejecuta como datos de usuario para crear un archivo.
```
version: 1.1
tasks:
- task: executeScript
inputs:
- frequency: always
type: powershell
runAs: localSystem
content: |-
New-Item -Path 'C:\PowerShellTest.txt' -ItemType File
```
Puede utilizar un formato XML para los datos de usuario que sea compatible con las versiones anteriores del agente de inicialización. EC2Launch v2 ejecuta el script como una tarea `executeScript` en la etapa `UserData`. Para cumplir con el comportamiento de EC2Launch v1 y EC2Config, el script de datos del usuario se ejecuta como un proceso adjunto o en línea de forma predeterminada.
Puede agregar etiquetas opcionales para personalizar la ejecución del script. Por ejemplo, para ejecutar el script de datos de usuario cuando la instancia se reinicia, además de ejecutarse una vez cuando se inicia la instancia, puede usar la siguiente etiqueta:
`true`
**Ejemplo:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
Puede especificar uno o varios argumentos de PowerShell con la etiqueta ``. Si no se pasa ningún argumento, EC2Launch v2 agrega el siguiente argumento de forma predeterminada: `-ExecutionPolicy Unrestricted`.
**Ejemplo:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
-ExecutionPolicy Unrestricted -NoProfile -NonInteractive
```
Para ejecutar un script de datos de usuario XML como un proceso independiente, agregue la siguiente etiqueta a sus datos de usuario.
`true`
**Ejemplo:**
```
$file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
true
```
**nota**
La etiqueta de desconexión no es compatible con los agentes de inicialización anteriores.
#### Registro de cambios: datos de usuario
La siguiente tabla muestra los cambios en los datos de usuario y los compara con la versión del agente EC2Launch v2 aplicable.
| Versión de datos de usuario | Details | Presentación |
| --- | --- | --- |
| 1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Launch v2, versión 2.0.1245 |
| 1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launch-v2-settings.html) | EC2Launch v2, versión 2.0.0 |
\$1 Cuando se usa con el archivo `agent-config.yml` predeterminado.
## Códigos de salida y reinicios de EC2Launch v2
Puede utilizar EC2Launch v2 para definir cómo los scripts manejan los códigos de salida. De forma predeterminada, el código de salida del último comando ejecutado en un script se registra como el código de salida de todo el script. Por ejemplo, si una secuencia de comandos incluye tres comandos y el primer comando falla pero los siguientes se ejecutan correctamente, el estado de ejecución se informa como `success` porque el comando final se ha realizado correctamente.
Si desea que un script reinicie una instancia, debe especificar el `exit 3010` en el script, incluso cuando el reinicio sea el último paso del script. `exit 3010` indica a EC2Launch v2 que reinicie la instancia y llame nuevamente al script hasta que devuelva un código de salida que no sea `3010`, o hasta que se haya alcanzado el número máximo de reinicios. EC2Launch v2 permite un máximo de 5 reinicios por tarea. Si intentas reiniciar una instancia desde un script utilizando un mecanismo diferente, como por ejemplo `Restart-Computer`, el estado de ejecución del script será incoherente. Por ejemplo, puede quedarse atascado en un bucle de reinicio o no realizar el reinicio.
Si utiliza un formato de datos de usuario XML que es compatible con agentes antiguos, los datos de usuario pueden ejecutarse más veces de las que desea. Para obtener más información, consulta [El servicio ejecuta datos de usuario más de una vez](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-user-data-more-than-once) en la sección de resolución de problemas.
## EC2Launch v2 y Sysprep
El servicio EC2Launch v2 ejecuta Sysprep, una herramienta de Microsoft que le permite crear una AMI de Windows personalizada que se puede reutilizar. Cuando EC2Launch v2 llama a Sysprep, utiliza los archivos de `%ProgramData%\Amazon\EC2Launch` para determinar qué operaciones realizar. Puede editar estos archivos de manera indirecta mediante el cuadro de diálogo **Configuración de EC2Launch** o directamente mediante un editor YAML o un editor de texto. Sin embargo, hay algunas opciones de configuración avanzada que no están disponibles en el cuadro de diálogo **Configuración de EC2Launch**, por lo que debe editar dichas entradas directamente.
Si crea una AMI desde una instancia después de actualizar su configuración, la nueva configuración se aplica a cualquier instancia que se lance desde la nueva AMI. Para obtener información acerca de la creación de una AMI, consulte [Creación de una AMI basada en Amazon EBS](creating-an-ami-ebs.md).
# Definiciones de tareas para tareas de inicio de EC2Launch v2
Cada tarea que ejecuta EC2Launch v2 durante el lanzamiento o la puesta en marcha tiene su propio conjunto de propiedades y requisitos. Los detalles de la tarea incluyen la configuración de la frecuencia con la que se ejecuta una tarea (una vez o siempre), la fase del proceso de arranque del agente en la que se ejecuta, la sintaxis y ejemplos de documentos de YAML. Para obtener más información, revise los detalles de la tarea que se muestran en esta referencia.
**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
Activa Windows frente a un conjunto de servidores AWS KMS. La activación se omite si se detecta que la instancia es de tipo “traiga su propia licencia (BYOL)”.
*Frecuencia*: una vez
*AllowedStages* — `[PreReady]`
*Entradas* —
`activation`: (mapa)
`type`: (cadena) tipo de activación que se va a utilizar, se establece en `amazon`
*Ejemplo*
```
task: activateWindows
inputs:
activation:
type: amazon
```
## enableJumboFrames
Habilita tramas gigantes, que aumentan la unidad de transmisión máxima (MTU) del adaptador de red. Para obtener más información, consulte [Tramas gigantes (9 001 MTU)](network_mtu.md#jumbo_frame_instances).
*Frecuencia*: siempre
*AllowedStages* — `[PostReady, UserData]`
*Entradas*: ninguna
*Ejemplo*
```
task: enableJumboFrames
```
## enableOpenSsh
Habilita Windows OpenSSH y agrega la clave pública de la instancia a la carpeta de claves autorizadas.
*Frecuencia*: una vez
*AllowedStages* — `[PreReady, UserData]`
*Entradas*: ninguna
*Ejemplo*
En el ejemplo siguiente se muestra cómo habilitar OpenSSH en una instancia y agregar la clave pública de la instancia a la carpeta de claves autorizadas. Esta configuración solo funciona en instancias que ejecutan Windows Server 2019 y en versiones posteriores.
```
task: enableOpenSsh
```
## executeProgram
Ejecuta un programa con argumentos opcionales y una frecuencia especificada.
**Etapas:** puede ejecutar la tarea `executeProgram` durante las etapas `PreReady`, `PostReady` y `UserData`.
**Frecuencia:** configurable, consulte *Entradas*.
**Entradas**
Esta sección contiene uno o más programas para ejecutar la tarea **executeProgram** (entradas). Cada paso puede incluir los siguientes atributos:
**frequency (cadena)**
(Obligatorio) Especifique exactamente uno de los siguientes valores:
+ `once`
+ `always`
**ruta (cadena)**
(Obligatorio) La ruta del archivo para el ejecutable a ejecutar.
**arguments (lista de cadenas)**
(Opcional) Una lista de argumentos separados por comas para proporcionar al programa como entrada.
**runAs (cadena)**
(Obligatorio) Debe configurarse en `localSystem`
**Output**
Todas las tareas escriben las entradas del archivo de registro en el archivo `agent.log`. Los resultados adicionales de la tarea `executeProgram` se almacenan por separado en una carpeta con nombre dinámico, de la siguiente manera:
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.tmp`
La ruta exacta a los archivos de salida se incluye en el archivo `agent.log`, por ejemplo:
```
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
```
**Archivos de salida para la tarea `executeProgram`**
`ExecuteProgramInputs.tmp`
Contiene la ruta del ejecutable y todos los parámetros de entrada que la tarea `executeProgram` le transfiere cuando se ejecuta.
`Output.tmp`
Contiene la salida del tiempo de ejecución del programa en el que se ejecuta la tarea `executeProgram`.
`Err.tmp`
Contiene el error del tiempo de ejecución del programa en el que se ejecuta la tarea `executeProgram`.
**Ejemplos**
En los siguientes ejemplos, se muestra cómo ejecutar un archivo ejecutable desde un directorio local en una instancia con la tarea `executeProgram`.
**Ejemplo 1: Configurar el ejecutable con un argumento**
En este ejemplo, se muestra una tarea `executeProgram` que ejecuta un ejecutable de configuración en modo silencioso.
```
task: executeProgram
inputs:
- frequency: always
path: C:\Users\Administrator\Desktop\setup.exe
arguments: ['-quiet']
```
**Ejemplo 2: Ejecutable de VLC con dos argumentos**
Este ejemplo muestra una tarea `executeProgram` que ejecuta un archivo ejecutable de VLC con dos argumentos pasados como parámetros de entrada.
```
task: executeProgram
inputs:
- frequency: always
path: C:\vlc-3.0.11-win64.exe
arguments: ['/L=1033','/S']
runAs: localSystem
```
## executeScript
Ejecuta un script con argumentos opcionales y una frecuencia especificada. El comportamiento de los scripts depende del modo en el que el agente los ejecute: en línea o de forma independiente.
En línea (predeterminado)
El agente de EC2Launch v2 ejecuta los scripts de uno en uno (`detach: false`). Este es el valor predeterminado.
Cuando el script en línea emite un comando **reset** o **sysprep**, se ejecuta de manera inmediata y restablece el agente. La tarea actual finaliza y, a continuación, el agente se cierra sin ejecutar ninguna otra tarea.
Por ejemplo, si la tarea que emite el comando hubiera estado seguida de una tarea `startSsm` (incluida de forma predeterminada cuando se ejecutan los datos del usuario), la tarea no se ejecutaría y el servicio Systems Manager nunca se iniciaría.
Desconectado
El agente EC2Launch v2 ejecuta scripts de manera simultánea a otras tareas (`detach: true`).
Cuando el script independiente emite un comando **reset** o **sysprep**, dichos comandos esperan a que el agente termine antes de ejecutarse. Las tareas posteriores a executeScript seguirán ejecutándose.
**Etapas:** puede ejecutar la tarea `executeScript` durante las etapas `PreReady`, `PostReady` y `UserData`.
**Frecuencia:** configurable, consulte *Entradas*.
**Entradas**
Esta sección contiene uno o más scripts para ejecutar la tarea **executeScript** (entradas). Cada paso puede incluir los siguientes atributos:
**frequency (cadena)**
(Obligatorio) Especifique exactamente uno de los siguientes valores:
+ `once`
+ `always`
**type (cadena)**
(Obligatorio) Especifique exactamente uno de los siguientes valores:
+ `batch`
+ `powershell`
**arguments (lista de cadenas)**
(Opcional) Una lista de argumentos de cadena para pasar al intérprete de comandos (no al script de PowerShell). Este parámetro no es compatible con `type: batch`. Si no se pasa ningún argumento, EC2Launch v2 agrega el siguiente argumento de forma predeterminada: `-ExecutionPolicy Unrestricted`.
**content (cadena)**
(Obligatorio) Contenido de script.
**runAs (cadena)**
(Obligatorio) Especifique exactamente uno de los siguientes valores:
+ `admin`
+ `localSystem`
**detach (booleano)**
(Opcional) El agente EC2Launch v2 ejecuta de forma predeterminada los scripts de uno en uno (`detach: false`). Para ejecutar el script simultáneamente con otras tareas, defina el valor en `true` (`detach: true`).
Los códigos de salida de script (incluido `3010`) no surten efecto cuando `detach` está establecido como `true`.
**Output**
Todas las tareas escriben las entradas del archivo de registro en el archivo `agent.log`. La salida adicional del script que ejecuta la tarea `executeScript` se almacena por separado en una carpeta con nombre dinámico, de la siguiente manera:
`%LocalAppData%\Temp\EC2Launch#########\outputfilename.ext`
La ruta exacta a los archivos de salida se incluye en el archivo `agent.log`, por ejemplo:
```
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
```
**Archivos de salida para la tarea `executeScript`**
`UserScript.ext`
Contiene el script en el que se ejecutó la tarea `executeScript`. La extensión del archivo depende del tipo de script que haya especificado en el parámetro `type` de la tarea `executeScript`, como se indica a continuación:
+ Si el tipo es `batch`, entonces la extensión del archivo es `.bat`.
+ Si el tipo es `powershell`, entonces la extensión del archivo es `.ps1`.
`Output.tmp`
Contiene la salida del tiempo de ejecución del script en el que se ejecuta la tarea `executeScript`.
`Err.tmp`
Contiene el error del tiempo de ejecución del script en el que se ejecuta la tarea `executeScript`.
**Ejemplos**
En los siguientes ejemplos, se muestra cómo ejecutar un script en línea con la tarea `executeScript`.
**Ejemplo 1: Archivo de texto de salida de Hola mundo**
En este ejemplo, se muestra una tarea `executeScript` en la que se ejecuta un script de PowerShell para crear un archivo de texto que diga “Hola mundo” en la unidad `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"
```
**Ejemplo 2: Ejecutar dos scripts**
En este ejemplo, se muestra que la tarea `executeScript` puede ejecutar más de un script y que el tipo de script no tiene por qué coincidir.
El primer script (`type: powershell`) escribe un resumen de los procesos que se están ejecutando actualmente en la instancia en un archivo de texto ubicado en la unidad `C:`.
El segundo script (`batch`) escribe la información del sistema en el archivo `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
```
**Ejemplo 3: Configurar el sistema idempotente con reinicios**
En este ejemplo, se muestra una tarea `executeScript` en la que se ejecuta un script idempotente para realizar la siguiente configuración del sistema con un reinicio entre cada paso:
+ Cambiar el nombre del equipo.
+ Unir el equipo al dominio.
+ Habilitar Telnet.
El script garantiza que cada operación se ejecute una sola vez. Esto evita un bucle de reinicio y hace que el script sea 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
Extiende el volumen raíz para utilizar todo el espacio disponible en el disco.
*Frecuencia*: una vez
*AllowedStages* — `[Boot]`
*Entradas*: ninguna
*Ejemplo*
```
task: extendRootPartition
```
## initializeVolume
Inicializa los volúmenes vacíos que están asociados a la instancia para que se activen y se particionen. El agente de inicialización omite la inicialización si detecta que el volumen no está vacío. Un volumen se considera vacío si los primeros 4 KB del volumen están vacíos o si el volumen no tiene un [diseño de unidad reconocible por Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex).
El parámetro de entrada `letter` siempre se aplica cuando se ejecuta esta tarea, independientemente de si la unidad ya está inicializada.
La tarea `initializeVolume` realiza las siguientes acciones.
+ Establezca los atributos del disco `offline` y `readonly` en false.
+ Cree una partición. Si no se especifica ningún tipo de partición en el parámetro de entrada `partition`, se aplican los siguientes valores predeterminados:
+ Si el tamaño del disco es inferior a 2 TB, defina el tipo de partición en `mbr`.
+ Si el tamaño del disco es de 2 TB o mayor, defina el tipo de partición en `gpt`.
+ Dé formato al volumen como NTFS.
+ Defina la etiqueta de volumen de la siguiente manera:
+ Use el valor del parámetro de entrada `name`, si procede.
+ Si el volumen es efímero y no se especificó ningún nombre, defina la etiqueta de volumen en `Temporary Storage Z`.
+ Si el volumen es efímero (SSD o HDD, no Amazon EBS), cree un archivo `Important.txt` en la raíz del volumen con el siguiente contenido:
```
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: Almacenamiento de nivel de bloques temporal del almacén de instancias para las instancias de EC2.
```
+ Defina la letra de la unidad en el valor especificado en el parámetro de entrada `letter`.
**Etapas:** puede ejecutar la tarea `initializeVolume` durante las etapas `PostReady` y `UserData`.
**Frecuencia:** siempre.
**Entradas**
Puede configurar los parámetros de tiempo de ejecución de la siguiente manera:
**devices (lista de asignaciones)**
(Condicional) Configuración para cada dispositivo que inicialice el agente de inicialización. Es necesario cuando el parámetro de entrada `initialize` se establece en `devices`.
+ **device (cadena, obligatorio)**: identifica el dispositivo durante la creación de la instancia. Por ejemplo, `xvdb`, `xvdf` o `\dev\nvme0n1`.
+ **letter (cadena, opcional)**: un carácter. La letra de unidad que se va a asignar.
+ **name (cadena, opcional)**: el nombre del volumen que se va a asignar.
+ **partition (cadena, opcional)**: especifique uno de los siguientes valores para el tipo de partición que desee crear o deje que el agente de inicialización tome el valor predeterminado en función del tamaño del volumen:
+ mbr
+ gpt
**initialize (cadena)**
(Obligatorio) Especifique exactamente uno de los siguientes valores:
+ `all`
+ `devices`
**Ejemplos**
En los siguientes ejemplos se muestran ejemplos de configuraciones de entrada para la tarea `initializeVolume`.
**Ejemplo 1: inicializar dos volúmenes en una instancia**
En este ejemplo, se muestra una tarea `initializeVolume` que inicializa dos volúmenes secundarios en una instancia. El dispositivo llamado `DataVolume2` en el ejemplo es efímero.
```
task: initializeVolume
inputs:
initialize: devices
devices:
- device: xvdb
name: DataVolume1
letter: D
partition: mbr
- device: /dev/nvme0n1
name: DataVolume2
letter: E
partition: gpt
```
**Ejemplo 2: inicializar volúmenes de EBS adjuntos a una instancia**
En este ejemplo, se muestra una tarea `initializeVolume` que inicializa todos los volúmenes vacíos de EBS adjuntos a la instancia.
```
task: initializeVolume
inputs:
initialize: all
```
## optimizeEna
Optimiza la configuración de ENA en función del tipo de instancia actual; podría reiniciar la instancia.
*Frecuencia*: siempre
*AllowedStages* — `[PostReady, UserData]`
*Entradas*: ninguna
*Ejemplo*
```
task: optimizeEna
```
## setAdminAccount
Establece atributos para la cuenta de administrador predeterminada que se crea en el equipo local.
*Frecuencia*: una vez
*AllowedStages* — `[PreReady]`
*Entradas* —
`name`: (cadena) nombre de la cuenta de administrador
`password`: (mapa)
`type`: (cadena) estrategia para establecer la contraseña, ya sea como `static`, `random` o `doNothing`
`data`: (cadena) almacena datos si el campo `type` es estático
*Ejemplo*
```
task: setAdminAccount
inputs:
name: Administrator
password:
type: random
```
## setDnsSuffix
Agrega sufijos DNS a la lista de sufijos de búsqueda. Sólo se agregan a la lista los sufijos que aún no existen. Para obtener más información acerca de cómo los agentes de inicialización configuran los sufijos de DNS, consulte [Configuración del sufijo de DNS para los agentes de inicialización de Windows de EC2](launch-agents-set-dns.md).
*Frecuencia*: siempre
*AllowedStages* — `[PreReady]`
*Entradas* —
`suffixes`: (lista de cadenas) enumera uno o varios sufijos DNS válidos; las variables de sustitución válidas son `$REGION` y `$AZ`
*Ejemplo*
```
task: setDnsSuffix
inputs:
suffixes:
- $REGION.ec2-utilities.amazonaws.com
```
## setHostName
Establece el nombre de host del equipo en una cadena personalizada o, si no se especifica `hostName`, la dirección IPv4 privada.
*Frecuencia*: siempre
*AllowedStages* — `[PostReady, UserData]`
*Entradas* —
`hostName`: (cadena) nombre de host opcional, que debe tener el siguiente formato.
+ Debe tener 15 caracteres o menos
+ Debe contener sólo caracteres alfanuméricos (a-z, A-Z, 0-9) y guión (-).
+ No debe estar compuesta únicamente por caracteres numéricos.
`reboot`: (booleano) indica si se permite un reinicio cuando se cambia el nombre de host
*Ejemplo*
```
task: setHostName
inputs:
reboot: true
```
## setWallpaper
Crea el archivo de acceso directo `setwallpaper.lnk` en la carpeta de inicio de cada usuario existente, excepto el `Default User`. Este archivo de acceso directo se ejecuta cuando el usuario inicia sesión por primera vez después del arranque de la instancia. Configura la instancia con un fondo de pantalla personalizado que muestra los atributos de la instancia.
La ruta del archivo de acceso directo es:
```
$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk
```
**nota**
Al quitar la tarea `setWallpaper`, no elimina este archivo de acceso directo. Para obtener más información, consulte [`setWallpaper`La tarea no está habilitada pero el fondo de pantalla se restablece al reiniciar](ec2launchv2-troubleshooting.md#ec2launchv2-troubleshooting-wallpaper-resets).
**Etapas:** puede configurar el fondo de pantalla durante las etapas `PreReady` y `UserData`.
**Frecuencia:** `always`
**Configuración de fondo de pantalla**
Puede utilizar los siguientes ajustes para configurar su fondo de pantalla.
**Entradas**
Introduzca los parámetros que proporcione y los atributos que puede configurar para configurar el fondo de pantalla:
**ruta (cadena)**
(Obligatorio) La ruta del nombre del archivo de imagen local en formato .jpg que se va a utilizar en la imagen de fondo de pantalla.
**atributos (lista de cadenas)**
(Opcional) Puede agregar uno o más de los siguientes atributos a su fondo de pantalla:
+ `architecture`
+ `availabilityZone`
+ `hostName`
+ `instanceId`
+ `instanceSize`
+ `privateIpAddress`
+ `publicIpAddress`
+ `ipv6Address`
**instanceTags**
(Opcional) Puede utilizar exactamente una de las opciones siguientes para esta configuración.
+ **AllTags** (cadena) (Todas las etiquetas): agregue todas las etiquetas de instancia a su fondo de pantalla.
```
instanceTags: AllTags
```
+ **InstanceTags** (lista de cadenas) (Etiquetas de instancias): especifica una lista de nombres de etiquetas de instancia para agregarlos al fondo de pantalla. Por ejemplo:
```
instanceTags:
- Tag 1
- Tag 2
```
**Ejemplo**
El siguiente ejemplo muestra las entradas de configuración del fondo de pantalla que establecen la ruta del archivo de la imagen de fondo del fondo de pantalla, junto con las etiquetas de instancia denominadas `Tag 1` y `Tag 2`, y los atributos que incluyen el nombre de host, el ID de la instancia y las direcciones IP públicas y privadas de la instancia.
```
task: setWallpaper
inputs:
path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
attributes:
- hostName
- instanceId
- privateIpAddress
- publicIpAddress
instanceTags:
- Tag 1
- Tag 2
```
**nota**
Debe habilitar las etiquetas en los metadatos para que se muestren en el fondo de pantalla. Para obtener más información acerca de las etiquetas y metadatos de instancias, consulte [Visualización de etiquetas para las instancias de EC2 mediante los metadatos de la instancia](work-with-tags-in-IMDS.md).
## startSsm
Comienza el servicio Systems Manager (SSM) siguiendo Sysprep.
*Frecuencia*: siempre
*AllowedStages* — `[PostReady, UserData]`
*Entradas*: ninguna
*Ejemplo*
```
task: startSsm
```
## sysprep
Restablece el estado del servicio, actualiza `unattend.xml`, desactiva RDP y ejecuta Sysprep. Esta tarea sólo se ejecuta después de que se hayan completado todas las demás tareas.
*Frecuencia*: una vez
*AllowedStages* — `[UserData]`
*Entradas* —
`clean`: (booleano) limpia los registros de instancia antes de ejecutar Sysprep
`shutdown`: (booleano) cierra la instancia después de ejecutar Sysprep
*Ejemplo*
```
task: sysprep
inputs:
clean: true
shutdown: true
```
## writeFile
Escribe un archivo en un destino.
*Frecuencia*: consulte *Entradas*
*AllowedStages* — `[PostReady, UserData]`
*Entradas* —
`frequency`: (cadena) uno entre `once` y `always`
`destination`: (cadena) ruta en la que escribir el contenido
`content`: (cadena) texto para escribir en el destino
*Ejemplo*
```
task: writeFile
inputs:
- frequency: once
destination: C:\Users\Administrator\Desktop\booted.txt
content: Windows Has Booted
```
# Solución de problemas con el agente EC2Launch v2
En esta sección, se muestran escenarios de solución de problemas comunes para EC2Launch v2, información sobre cómo ver los registros de eventos de Windows y los mensajes y la salida del registro de la consola.
**Topics**
+ [Escenarios habituales](#ec2launchv2-troubleshooting-scenarios)
+ [Registros de eventos de Windows](#ec2launchv2-windows-event-logs)
+ [Salida del registro de la consola de EC2Launch v2](#ec2launchv2-console-output)
## Situaciones comunes de solución de problemas
En esta sección se muestran las situaciones comunes de solución de problemas y los pasos para la resolución.
**Topics**
+ [El servicio no puede configurar el fondo de pantalla](#ec2launchv2-troubleshooting-wallpaper)
+ [El servicio no puede ejecutar datos de usuario](#ec2launchv2-troubleshooting-user-data)
+ [El servicio ejecuta una tarea sólo una vez](#ec2launchv2-troubleshooting-task-once)
+ [El servicio no puede ejecutar una tarea](#ec2launchv2-troubleshooting-task-failed)
+ [El servicio ejecuta datos de usuario más de una vez](#ec2launchv2-troubleshooting-user-data-more-than-once)
+ [Las tareas programadas de EC2Launch v1 no se pueden ejecutar después de la migración a EC2Launch v2](#ec2launchv2-troubleshooting-scheduled-tasks-migration)
+ [El servicio inicializa un volumen EBS que no está vacío](#ec2launchv2-troubleshooting-ebs-initialize)
+ [`setWallpaper`La tarea no está habilitada pero el fondo de pantalla se restablece al reiniciar](#ec2launchv2-troubleshooting-wallpaper-resets)
+ [Servicio atascado en estado de ejecución](#ec2launchv2-troubleshooting-service-stuck-running)
+ [`agent-config.yml` no válido impide que se abra el cuadro de diálogo de configuración de EC2Launch v2](#ec2launchv2-troubleshooting-invalid-agent-config)
+ [`task:executeScript should be unique and only invoked once`](#ec2launchv2-troubleshooting-executescript)
### El servicio no puede configurar el fondo de pantalla
**Resolución**
1. Compruebe que `%AppData%\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\setwallpaper.lnk` existe.
1. Compruebe `%ProgramData%\Amazon\EC2Launch\log\agent.log` si se ha producido algún error.
### El servicio no puede ejecutar datos de usuario
**Causa posible**: el servicio puede haber devuelto un error antes de ejecutar los datos de usuario.
**Resolución**
1. Compruebe `%ProgramData%\Amazon\EC2Launch\state\previous-state.json`.
1. Compruebe si `boot`, `network`, `preReady` y `postReadyLocalData` se han marcado como éxito.
1. Si una de las etapas devolvió un error, compruebe si hay errores específicos en `%ProgramData%\Amazon\EC2Launch\log\agent.log`.
### El servicio ejecuta una tarea sólo una vez
**Resolución**
1. Compruebe la frecuencia de la tarea.
1. Si el servicio ya se ejecutó después de Sysprep y la frecuencia de la tarea está establecida en `once`, la tarea no se ejecutará de nuevo.
1. Configure la frecuencia de la tarea como `always` si desea que se ejecute cada vez que se ejecute EC2Launch v2.
### El servicio no puede ejecutar una tarea
**Resolución**
1. Compruebe las últimas entradas en `%ProgramData%\Amazon\EC2Launch\log\agent.log`.
1. Si no se han producido errores, pruebe a ejecutar el servicio manualmente desde `"%ProgramFiles%\Amazon\EC2Launch\EC2Launch.exe" run` para ver si las tareas se realizan correctamente.
### El servicio ejecuta datos de usuario más de una vez
**Resolución**
Los datos de usuario se gestionan de forma diferente entre EC2Launch v1 y EC2Launch v2. EC2Launch v1 ejecuta los datos de usuario como una tarea programada en la instancia cuando configura `persist` como `true`. Si `persist` se establece en `false`, la tarea no está programada incluso cuando se cierra con un reinicio o se interrumpe mientras se ejecuta.
EC2Launch v2 ejecuta los datos de usuario como una tarea de agente y realiza un seguimiento de su estado de ejecución. Si los datos de usuario emiten un reinicio del equipo o si los datos de usuario se interrumpieron durante la ejecución, el estado de ejecución persiste como `pending` y los datos de usuario se ejecutarán de nuevo en el siguiente arranque de la instancia. Si deseas evitar que el script de datos del usuario se ejecute más de una vez, haz que el script sea idempotente.
El siguiente ejemplo de scripts idempotentes establece el nombre del equipo y se une 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
```
### Las tareas programadas de EC2Launch v1 no se pueden ejecutar después de la migración a EC2Launch v2
**Resolución**
La herramienta de migración no detecta ninguna tarea programada que esté vinculada a scripts de EC2Launch v1; por lo tanto, no configura automáticamente dichas tareas en EC2Launch v2. Para configurar dichas tareas, edita el archivo [`agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-task-configuration) o utiliza el [Cuadro de diálogo configuración de EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui). Por ejemplo, si una instancia tiene una tarea programada que ejecuta `InitializeDisks.ps1`, después de ejecutar la herramienta de migración debe especificar los volúmenes que desea iniciar en el cuadro de diálogo configuración de EC2Launch v2. Consulte el paso 6 del procedimiento para [Cambiar la configuración mediante el cuadro de diálogo de configuración de EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui).
### El servicio inicializa un volumen EBS que no está vacío
**Resolución**
Antes de inicializar un volumen, EC2Launch v2 intenta detectar si está vacío. Si un volumen no está vacío, omite la inicialización. Los volúmenes que se detecten como no vacíos no se inicializan. Un volumen se considera vacío si los primeros 4 KB de un volumen están vacíos, o si un volumen no tiene un [diseño de unidad reconocible por Windows](https://learn.microsoft.com/en-us/windows/win32/api/winioctl/ns-winioctl-drive_layout_information_ex). Un volumen que se inicializó y formateó en un sistema Linux no tiene un diseño de unidad reconocible por Windows, por ejemplo MBR o GPT. Por lo tanto, se considerará vacío e inicializado. Si desea conservar estos datos, no dependa de la detección de unidades vacías de EC2Launch v2. En lugar de ello, especifique los volúmenes que desea inicializar en el [cuadro de diálogo de configuración de EC2Launch v2](ec2launch-v2-settings.md#ec2launch-v2-ui) (consulte el paso 6) o en [`agent-config.yml`](ec2launch-v2-task-definitions.md#ec2launch-v2-initializevolume).
### `setWallpaper`La tarea no está habilitada pero el fondo de pantalla se restablece al reiniciar
La tarea `setWallpaper` crea el archivo de acceso directo `setwallpaper.lnk` en la carpeta de startup de cada usuario existente. Este archivo de acceso directo se ejecuta cuando el usuario inicia sesión por primera vez después del arranque de la instancia. Configura la instancia con un fondo de pantalla personalizado que muestra los atributos de la instancia. Tenga en cuenta que quitar la tarea `setWallpaper` no elimina este archivo de acceso directo. Elimine manualmente este archivo o mediante un script.
La ruta del acceso directo es:
`$env:SystemDrive/Users//AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk`
**Resolución**
Elimine manualmente este archivo o mediante un script.
**Ejemplo de script de PowerShell para eliminar un archivo de acceso directo**
```
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
}
}
}
```
### Servicio atascado en estado de ejecución
**Descripción**
EC2Launch v2 se bloquea y presenta mensajes de registro (`agent.log`) similares a los siguientes:
```
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.
```
**Causa posible**
SAC está habilitado y utiliza el puerto serie. Para obtener más información, consulte [Usar SAC para solucionar problemas de su instancia de Windows](troubleshoot-using-serial-console.md#troubleshooting-sac).
**Resolución**
Pruebe los siguientes pasos para resolver este problema:
+ Desactive el servicio que esté utilizando el puerto serie.
+ Si desea que el servicio siga utilizando el puerto serie, escriba scripts personalizados para realizar tareas del agente de inicialización e invóquelas como tareas programadas.
### `agent-config.yml` no válido impide que se abra el cuadro de diálogo de configuración de EC2Launch v2
**Descripción**
La configuración de EC2Launch v2 intenta analizar el archivo `agent-config.yml` antes de abrir el cuadro de diálogo. Si el archivo de configuración YAML no sigue el esquema admitido, el cuadro de diálogo mostrará el siguiente error:
`Unable to parse configuration file agent-config.yml. Review configuration file. Exiting application.`
**Resolución**
1. Compruebe que el archivo de configuración sigue el [esquema admitido](ec2launch-v2-settings.md#ec2launch-v2-schema-agent-config).
1. Si desea comenzar desde cero, copie el archivo de configuración predeterminado en `agent-config.yml`. Puede utilizar el [ejemplo `agent-config.yml`](ec2launch-v2-settings.md#ec2launch-v2-example-agent-config) que se proporciona en la sección Task Configuration (Configuración de tareas).
1. También puede comenzar de nuevo eliminando `agent-config.yml`. La configuración de EC2Launch v2 genera un archivo de configuración vacío.
### `task:executeScript should be unique and only invoked once`
**Descripción**
No es posible repetir una tarea en la misma etapa.
**Resolución**
Algunas tareas deben introducirse como una matriz, como [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript) y [**executeProgram**](ec2launch-v2-task-definitions.md#ec2launch-v2-executeprogram). Para ver un ejemplo de cómo escribir el script como una matriz, consulte [**executeScript**](ec2launch-v2-task-definitions.md#ec2launch-v2-executescript).
## Registros de eventos de Windows
EC2Launch v2 publica registros de eventos de Windows para eventos importantes, como el inicio del servicio, la preparación de Windows para empezar a funcionar y el éxito y el error de la tarea. Los identificadores de eventos identifican de forma única un evento en particular. Cada evento contiene información de etapa, tarea y nivel, así como una descripción. Puede establecer desencadenadores para eventos específicos mediante el identificador de evento.
Los ID de eventos proporcionan información sobre un evento e identifican de forma única algunos eventos. El dígito menos significativo de un ID de evento indica la gravedad de un evento.
| Evento | Dígito menos significativo |
| --- | --- |
| Success | . . .0 |
| Informational | . . .1 |
| Warning | . . .2 |
| Error | . . .3 |
Los eventos relacionados con el servicio que se generan cuando se inicia o se detiene el servicio incluyen un identificador de evento de un solo dígito.
| Evento | Identificador de un solo dígito |
| --- | --- |
| Success | 0 |
| Informational | 1 |
| Warning | 2 |
| Error | 3 |
Los mensajes de eventos para eventos `EC2LaunchService.exe` comienzan por `Service:`. Los mensajes de eventos para eventos `EC2Launch.exe` no comienzan por `Service:`.
Los ID de eventos de cuatro dígitos incluyen información sobre la fase, la tarea y la gravedad de un evento.
**Topics**
+ [Formato de ID de evento](#ec2launchv2-windows-event-logs-format)
+ [Ejemplos de ID de evento](#ec2launchv2-windows-event-logs-id-examples)
+ [Esquema de registro de eventos de Windows](#ec2launch-v2-windows-event-logs-schema)
### Formato de ID de evento
La siguiente tabla muestra el formato del identificador de un evento de EC2Launch v2.
| 3 | 2 1 | 0 |
| --- | --- | --- |
| S | T | L |
Las letras y números de la tabla representan el tipo de evento y las definiciones siguientes.
| Tipo de evento | Definición |
| --- | --- |
| S (Etapa) | 0 - Mensaje de nivel de servicio 1 - Arranque 2 - Red 3 - Pre-Ready 5 - Windows está listo 6 - PostReady 7 - Datos de usuario |
| T (Tarea) | Las tareas representadas por los dos valores correspondientes son distintas para cada etapa. Para ver la lista completa de eventos, consulte [Esquema de registro de eventos de Windows](#ec2launch-v2-windows-event-logs-schema). |
| L (Nivel del evento) | 0 - Éxito 1 - Informativo 2 - Advertencia 3 - Error |
### Ejemplos de ID de evento
A continuación se presentan identificadores de evento de ejemplo.
+ `5000`: Windows está listo para usar
+ `3010`: la tarea de activación de Windows en la etapa PreReady se ha realizado correctamente
+ `6013`: la tarea Establecer fondo de pantalla en la etapa PostReady Local Data encontró un error
### Esquema de registro de eventos de Windows
| ID de mensaje/evento | Mensaje de 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 |
## Salida del registro de la consola de EC2Launch v2
Esta sección contiene una salida del registro de la consola de ejemplo de EC2Launch v2 y muestra todos los mensajes de error del registro de la consola de EC2Launch v2 para ayudarle a solucionar problemas. Para obtener más información sobre la salida de la consola de instancias y cómo acceder a ella, consulte [Salida de la consola de instancias](troubleshoot-unreachable-instance.md#instance-console-console-output).
**Topics**
+ [Salida del registro de la consola de EC2Launch v2](#ec2launchv2-console-log-output)
+ [Mensajes de registro de la consola de EC2Launch v2](#ec2launchv2-console-log-messages)
### Salida del registro de la consola de EC2Launch v2
A continuación, se muestra una salida del registro de la consola de ejemplo de EC2Launch v2. Algunos valores de este ejemplo se sustituyen por texto representativo entre llaves.
```
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", ...}
```
### Mensajes de registro de la consola de EC2Launch v2
A continuación, se muestra una lista de todos los mensajes de registro de la consola de EC2Launch v2.
```
Error EC2Launch service is stopping. {error message}
```
Detalles del error de servicio detenido:
+ `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}
```
El siguiente mensaje es un bloque de información que contiene detalles de la 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}
```
Los mensajes de telemetría de EC2Launch v2 incluyen los valores de las propiedades de telemetría de lanzamiento. A partir de la versión 2.2.63, los datos de telemetría de agentes de EC2 se formatean como un objeto JSON.
```
EC2LaunchTelemetry: {telemetry property}
```
```
{"type":"EC2AgentTelemetry","agentId":"WindowsLaunchAgentV2" ... }
```
# Historiales de versiones de EC2Launch v2
**Topics**
+ [Historial de versiones de EC2Launch v2](#ec2launchv2-version-history)
## Historial de versiones de EC2Launch v2
Para asegurarse de que tiene instalado el agente de lanzamiento más reciente, consulte [Instalar la versión más reciente de EC2Launch v2](ec2launch-v2-install.md). Puede recibir notificaciones cuando se publiquen nuevas versiones del agente EC2Launch v2. Para obtener más información, consulte [Suscripción a las notificaciones del agente de inicialización de Windows de EC2](launch-agents-subscribe-notifications.md).
En la siguiente tabla, se describen las versiones de EC2Launch v2 publicadas.
| Versión | Detalles | Fecha de la versión |
| --- | --- | --- |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 de marzo de 2026 |
| 2.3.237 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 25 de febrero de 2026 |
| 2.3.108 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 29 de diciembre de 2025 |
| 2.3.56 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 de noviembre de 2025 |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15 de septiembre de 2025 |
| 2.2.63 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 29 de julio de 2025 |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 14 de mayo de 2025 |
| 2.0.2107 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 27 de marzo de 2025 |
| 2.0.2081 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 de febrero de 2025 |
| 2.0.2046 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 de octubre de 2024 |
| 2.0.1981 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 de agosto de 2024 |
| 2.0.1948 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 1 de julio de 2024 |
| 2.0.1924 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10 de junio de 2024 |
| 2.0.1914 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 de junio de 2024 |
| 2.0.1881 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 de mayo de 2024 |
| 2.0.1815 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 de marzo de 2024 |
| 2.0.1739 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 17 de enero de 2024 |
| 2.0.1702 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 de enero de 2024 |
| 2.0.1643 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 de octubre de 2023 |
| 2.0.1580 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 5 de septiembre de 2023 |
| 2.0.1521 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 de julio de 2023 |
| 2.0.1303 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 3 de mayo de 2023 |
| 2.0.1245 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 de marzo de 2023 |
| 2.0.1173 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 de febrero de 2023 |
| 2.0.1121 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 de enero de 2023 |
| 2.0.1082 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7 de diciembre de 2022 |
| 2.0.1011 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 11 de noviembre de 2022 |
| 2.0.1009 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 de noviembre de 2022 |
| 2.0.982 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31 de octubre de 2022 |
| 2.0.863 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 de julio de 2022 |
| 2.0.698 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 30 de enero de 2022 |
| 2.0.674 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 15 de noviembre de 2021 |
| 2.0.651 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 7 de octubre de 2021 |
| 2.0.592 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 31 de agosto de 2021 |
| 2.0.548 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 de agosto de 2021 |
| 2.0.470 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 20 de julio de 2021 |
| 2.0.285 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 8 de marzo de 2021 |
| 2.0.207 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 2 de febrero de 2021 |
| 2.0.160 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 4 de diciembre de 2020 |
| 2.0.153 | Agrega la funcionalidad de Sysprep en UserData. | 3 de noviembre de 2020 |
| 2.0.146 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 6 de octubre de 2020 |
| 2.0.124 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 10 de septiembre de 2020 |
| 2.0.104 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/ec2launchv2-versions.html) | 12 de agosto de 2020 |
| 2.0.0 | Versión inicial. | 30 de junio de 2020 |