EC2Launch version history - Amazon Elastic Compute Cloud

EC2Launch version history

Windows AMIs starting with Windows Server 2016 include a set of Windows Powershell scripts called EC2Launch. EC2Launch performs tasks during the initial instance boot. For information about the EC2Launch versions included in AWS Windows AMIs, see AWS Windows AMI version history.

To download and install the latest version of EC2Launch, see Install the latest version of EC2Launch.

You can receive notifications when new versions of the EC2Launch agent are released. For more information, see Subscribe to EC2 Windows launch agent notifications.

The following table describes the released versions of EC2Launch. Note that the version format changed after version 1.3.610.

Version Details Release date
1.3.2005065
  • Fixed an issue where RDP certificate information was not properly retrieved or validated. Added functionality to automatically start the Remote Desktop Services if needed.

22 October 2024
1.3.2005008
  • Updated Set-Wallpaper to fall back to a solid color background if the default wallpaper image is not found.

6 August 2024
1.3.2004959
  • Updated installer logic to prevent unsupported installation on Windows Server 2025 or later.

2 July 2024
1.3.2004891
  • Fixed an issue where HandleUserData was not set to false as expected.

  • Added an Encrypted password option to LaunchConfig.json.

  • Changed Settings UI behavior to encrypt the user specified password by default.

  • Added SetAdminPasswordConfig.ps1 to convert the Specify password option to the Encrypted password option in the agent configuration file.

31 May 2024
1.3.2004617
  • Fixed an error when setting the wallpaper.

15 January 2024
1.3.2004592
  • Updated access permissions set by install.ps1 for %ProgramData%\Amazon\EC2-Windows\Launch.

  • Restricted EC2Launch folder/file access to read-execute only for standard user accounts.

  • Changed the agent to stop waiting for the Instance Metadata Service (IMDS) to initialize if IMDS is not enabled for the instance.

  • Added a five minute timeout when waiting for the IMDS to initialize.

  • Changed the agent to write telemetry to the instance console log before the Windows is Ready message instead of after.

  • Added wallpaper support to several new instance types.

For more information about access permissions and user account permissions of EC2Launch directories, see EC2Launch directory structure.

2 January 2024
1.3.2004491
  • Added telemetry to monitor usage of the Specify admin password option.

9 November 2023
1.3.2004462
  • Added flush after every write to the serial console.

18 October 2023
1.3.2004438
  • Limit domain name devolution based on registry entry: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Dnscache\Parameters\DomainNameDevolutionLevel.

  • Limited UserdataExecution.log permissions to Administrators only.

  • Added error messages in the Windows Event Log when log initialization fails.

4 October 2023
1.3.2004256
  • Added EnableSCSIPersistentReservations value to console log.

  • Added retry capability for Get-ConsolePort.

7 July 2023
1.3.2004052
  • Fixed an error that occurred when no SSH key is specified at instance launch.

  • Updated to retry starting the AmazonSSMAgent Windows service on failure.

  • Updated to fail SysprepInstance.ps1 if BeforeSysprep.cmd fails with a non-zero exit code.

8 March 2023
1.3.2003975
  • Fixed issue impacting Packer AMI builds where SysprepInstance.ps1 returns a $LastErrorCode of 1.

24 December 2022
1.3.2003961
  • Fixed issue where explicitly specified administrator passwords are overwritten with a random password on fast-launched instances.

  • Fixed issue where SSM Agent fails to start on smaller instance types.

  • Fixed an issue where the instance console log contains RDPCERTIFICATE-THUMBPRINT: 00000000000000000000000 instead of a valid RDP certificate thumbprint value.

6 December 2022
1.3.2003923
  • Fixes logic for finding network adapter when PnPDeviceID is empty.

9 November 2022
1.3.2003919
  • Updated Get-ConsolePort to use PCI segment information.

  • Fixed issue where an incorrect network adapter can be selected after reboot.

  • Fixed start-SSM-Agent timeout logic.

  • Fixed backwards compatibility for Send-AdminCredentials function alias.

8 November 2022
1.3.2003857
  • Prioritizes adapters with a default gateway when the primary network adapter is selected.

  • Extended in-memory password encryption.

3 October 2022
1.3.2003824
  • Fixed error during setComputerName.

  • Added logic to skip Windows activation when a BYOL billing code is detected.

  • Added in-memory password encryption.

  • Fixed error during volume initialization on m6id.4xlarge.

30 August 2022
1.3.2003691
  • Updated IMDS wait logic to make only IMDSv2 requests.

  • Fixed bug impacting eGPU installation.

21 June 2022
1.3.2003639
  • Added network-adapter wait logic to prevent use before initialization.

  • Fixed minor issues.

10 May 2022
1.3.2003498
  • Added telemetry.

  • Added shortcut to Settings UI.

  • Formatted PowerShell scripts.

  • Fixed issue with shutdown occurring before BeforeSysprep.cmd completes.

31 January 2022
1.3.2003411 Changed password generation logic to exclude passwords with low complexity. 04 August 2021
1.3.2003364 Updated Install-EgpuManager with IMDSv2 support. 07 June 2021
1.3.2003312
  • Added log lines before and after setMonitorAlwaysOn setting.

  • Added AWS Nitro Enclaves package version to console log.

04 May 2021
1.3.2003284 Improved permission model by updating location for storing user data to LocalAppData. 23 March 2021
1.3.2003236
  • Updated method for setting user password in Set-AdminAccount and Randomize-LocalAdminPassword.

  • FixedInitializeDisks to check whether disk is set to read only before setting it to writable.

11 February 2021
1.3.2003210 Localization fix for install.ps1. 7 January 2021
1.3.2003205 Security fix for install.ps1 to update permissions on %ProgramData%AmazonEC2-WindowsLaunchModuleScripts directory. 28 December 2020
1.3.2003189 Added w32tm resync after adding routes. 4 December 2020
1.3.2003155 Updated instance type information. 25 August 2020
1.3.2003150 Added OsCurrentBuild and OsReleaseId to console output . 22 April 2020
1.3.2003040 Fixed IMDS version 1 fallback logic. 7 April 2020

1.3.2002730

Added support for IMDS V2. 3 March 2020

1.3.2002240

Fixed minor issues. 31 October 2019

1.3.2001660

Fixed automatic login issue for users without password after first time executing Sysprep. 2 July 2019

1.3.2001360

Fixed minor issues. 27 March 2019

1.3.2001220

All PowerShell scripts signed. 28 February 2019

1.3.2001200

Fixed issue with InitializeDisks.ps1 where running the script on a node in a Windows Server Failover Cluster would format drives on remote nodes whose drive letter matched the local drive letter. 27 February 2019

1.3.2001160

Fixed missing wallpaper in Windows 2019. 22 February 2019

1.3.2001040

  • Added plugin for setting the monitor to never turn off to fix ACPI issues.

  • SQL Server edition and version written to console.

21 January 2019

1.3.2000930

Fix for adding routes to metadata on ipv6-enabled ENIs. 2 January 2019

1.3.2000760

  • Added default configuration for RSS and Receive Queue settings for ENA devices.

  • Disabled hibernation during Sysprep.

5 December 2018

1.3.2000630

  • Added route 169.254.169.253/32 for DNS server.

  • Added filter of setting Admin user.

  • Improvements made to instance hibernation.

  • Added option to schedule EC2Launch to run on every boot.

9 November 2018

1.3.2000430.0

  • Added route 169.254.169.123/32 to AMZN time service.

  • Added route 169.254.169.249/32 to GRID license service.

  • Added timeout of 25 seconds when attempting to start Systems Manager.

19 September 2018

1.3.200039.0

  • Fixed improper drive lettering for EBS NVME volumes.

  • Added additional logging for NVME driver versions.

15 August 2018

1.3.2000080

Fixed minor issues.

1.3.610

Fixed issue with redirecting output and errors to files from user data.

1.3.590

  • Added missing instances types in the wallpaper.

  • Fixed an issue with drive letter mapping and disk installation.

1.3.580

  • Fixed Get-Metadata to use the default system proxy settings for web requests.

  • Added a special case for NVMe in disk initialization.

  • Fixed minor issues.

1.3.550

Added a -NoShutdown option to enable Sysprep with no shutdown.

1.3.540

Fixed minor issues.

1.3.530

Fixed minor issues.

1.3.521

Fixed minor issues.

1.3.0

  • Fixed a hexadecimal length issue for computer name change.

  • Fixed a possible reboot loop for computer name change.

  • Fixed an issue in wallpaper setup.

1.2.0

  • Update to display information about installed operating system (OS) in EC2 system log.

  • Update to display EC2Launch and SSM Agent version in EC2 system log.

  • Fixed minor issues.

1.1.2

  • Update to display ENA driver information in EC2 system log.

  • Update to exclude Hyper-V from primary NIC filter logic.

  • Added AWS KMS server and port into registry key for KMS activation.

  • Improved wallpaper setup for multiple users.

  • Update to clear routes from persistent store.

  • Update to remove the z from availability zone in DNS suffix list.

  • Update to address an issue with the <runAsLocalSystem> tag in user data.

1.1.1

Initial release.