EC2Launch 任务验证 EC2Launch 版本 EC2Launch 目录结构配置 EC2Launch 将 Sysprep 与 EC2Launch 结合使用

使用 EC2Launch 配置 Windows 实例

EC2Launch 是一组 Windows PowerShell 脚本，用于替换 Windows Server 2016 及更高版本 AMI 上的 EC2Config 服务。

EC2Launch 任务
安装最新版本的 EC2Launch
验证 EC2Launch 版本
EC2Launch 目录结构
配置 EC2Launch
将 Sysprep 与 EC2Launch 结合使用
EC2Launch 版本历史记录

EC2Launch 任务

在初始实例启动期间，默认情况下 EC2Launch 执行以下任务：

设置用来呈现实例相关信息的新墙纸。
设置计算机名称。
向 Amazon EC2 控制台发送实例信息。
向 EC2 控制台发送 RDP 证书指纹。
设置管理员账户的随机密码。
添加 DNS 后缀。
动态扩展操作系统分区以包含所有未分区的空间。
执行用户数据 (如果指定)。有关指定用户数据的更多信息，请参阅与实例用户数据配合使用。
设置持久静态路由以访问元数据服务和 KMS 服务器。

重要

如果从此实例创建了自定义 AMI，则捕获这些路由作为操作配置的一部分，并且从 AMI 启动的任意新实例将保留相同的路由，而不论其子网放置如何。要更新路由，请参阅在启动自定义 AMI 时更新 Server 2016 及更高版本的元数据/KMS 路由。

以下任务有助于保持与 EC2Config 服务的向后兼容。在启动期间，您还可以配置 EC2Launch 来执行以下任务：

初始化辅助 EBS 卷。
将 Windows 事件日志发送到 EC2 控制台日志。
将 Windows 已可供使用 消息发送到 EC2 控制台。

有关 Windows Server 2019 的更多信息，请参阅 Microsoft.com 上的比较 Windows Server 版本中的功能。

验证 EC2Launch 版本

使用以下 Windows PowerShell 命令验证已安装的 EC2Launch 版本。


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

EC2Launch 目录结构

默认情况下，EC2Launch 安装在根目录 C:\ProgramData\Amazon\EC2-Windows\Launch 中的 Windows Server 2016 及更高版本 AMI 上。

注意

默认情况下，Windows 会隐藏 C:\ProgramData 下的文件和文件夹。要查看 EC2Launch 目录和文件，必须在 Windows 资源管理器中键入路径，或者更改文件夹属性以显示隐藏的文件和文件夹。

Scripts — 包含组成 EC2Launch 的 PowerShell 脚本。
Module — 包含用于生成与 Amazon EC2 相关的脚本的模块。
Config — 包含您可以自定义的脚本配置文件。
Sysprep — 包含 Sysprep 资源。
Settings — 包含一个适用于 Sysprep 图形用户界面的应用程序。
Logs — 包含脚本生成的日志文件。

配置 EC2Launch

在您的实例首次初始化后，您可以配置 EC2Launch 以再次运行并执行不同的启动任务。

任务

配置初始化文件
计划 EC2Launch 在每次启动时运行
初始化驱动器并映射盘符
将 Windows 事件日志发送到 EC2 控制台
在成功启动后发送 Windows 已准备就绪消息

配置初始化文件

指定 LaunchConfig.json 文件中的设置以启用或禁用以下初始化任务：

设置计算机名称。
设置新墙纸。
添加 DNS 后缀列表。
扩展引导卷大小。
设置管理员密码。

配置初始化设置

在要配置的实例上，在文本编辑器中打开以下文件：C:\ProgramData\Amazon\EC2-Windows\Launch\Config\LaunchConfig.json。
根据需要更新以下设置并保存您的更改。仅当 adminPassword 为 adminPasswordtype 时，在 Specify 中提供密码。
```
{
  "setComputerName": false,
  "setWallpaper": true,
  "addDnsSuffixList": true,
  "extendBootVolumeSize": true,
  "handleUserData": true,                      
  "adminPasswordType": "Random | Specify | DoNothing",
  "adminPassword":  "password that adheres to your security policy (optional)"
}
```
密码类型定义如下：

Random

EC2Launch 生成一个密码并使用用户的密钥对其进行加密。系统会在实例启动后禁用此设置，以便在重新启动或停止再启动实例后该密码仍然存在。

Specify

EC2Launch 使用您在 adminPassword 中指定的密码。如果密码不满足系统要求，EC2Launch 会生成随机密码。该密码以明文方式存储在 LaunchConfig.json 文件中，并且在 Sysprep 设置管理员密码时会被删除。EC2Launch 使用用户的密钥对密码进行加密。

DoNothing

EC2Launch 使用您在 unattend.xml 文件中指定的密码。如果未在 unattend.xml 中指定密码，管理员账户会被禁用。
在 Windows PowerShell 中运行以下命令，以便安排脚本作为 Windows 计划任务运行。该脚本将在下次启动期间执行一次，然后禁止这些任务再次运行。
```
PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -Schedule
```

计划 EC2Launch 在每次启动时运行

您可以计划 EC2Launch 在每次启动时运行，而不是仅仅在首次启动时运行。

要允许 EC2Launch 在每次启动时运行，请执行以下操作：

打开 Windows PowerShell 并运行以下命令：


PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -SchedulePerBoot

或者，使用以下命令运行可执行文件：
```
PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Settings\Ec2LaunchSettings.exe
```
然后选择 Run EC2Launch on every boot。您可以为 EC2 实例指定 Shutdown without Sysprep 或 Shutdown with Sysprep。

注意

当您允许 EC2Launch 在每次启动时运行，下次 EC2Launch 运行时将对 LaunchConfig.json 进行以下更改：

AdminPasswordType 将设置回 DoNothing，这样就不在每次启动时更改密码。
除非用户数据的 persist 设置为 true，否则 HandleUserData 将设置回 false。有关用户数据脚本的更多信息，请参阅 Amazon EC2 用户指南中的用户数据脚本。

与此类似，如果您不希望在下次启动时重置密码，则应在重新启动之前将 AdminPasswordType 设置为 DoNothing。

初始化驱动器并映射盘符

在 DriveLetterMappingConfig.json 文件中指定设置以将盘符映射到您的 EC2 实例上的卷。如果驱动器尚未初始化和分区，则脚本将执行此操作。

将盘符映射到卷

在文本编辑器中打开 C:\ProgramData\Amazon\EC2-Windows\Launch\Config\DriveLetterMappingConfig.json 文件。

指定以下卷设置并保存您的更改：


{
  "driveLetterMapping": [
    {
      "volumeName": "sample volume",
      "driveLetter": "H"
    }
  ]
}

打开 Windows PowerShell 并使用以下命令来运行初始化磁盘的 EC2Launch 脚本：
```
PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeDisks.ps1
```
要在每次实例启动时初始化磁盘，请添加 -Schedule 标记，如下所示：
```
PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeDisks.ps1 -Schedule
```

将 Windows 事件日志发送到 EC2 控制台

在 EventLogConfig.json 文件中指定设置，以便将 Windows 事件日志发送到 EC2 控制台日志。

配置设置来发送 Windows 事件日志

在实例上，在文本编辑器中 C:\ProgramData\Amazon\EC2-Windows\Launch\Config\EventLogConfig.json 打开文件。

配置以下日志设置并保存您的更改：


{
  "events": [
    {
      "logName": "System",
      "source": "An event source (optional)",
      "level": "Error | Warning | Information",
      "numEntries": 3
    }
  ]
}

在 Windows PowerShell 中运行以下命令，以便每当实例启动时系统都安排脚本作为 Windows 计划任务运行。
```
PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SendEventLogs.ps1 -Schedule
```
日志可能需要三分钟或更长时间才会显示在 EC2 控制台日志中。

在成功启动后发送 Windows 已准备就绪消息

在每次启动后，EC2Config 服务会向 EC2 控制台发送“Windows 已准备就绪”消息。EC2Launch 仅在初次启动后发送此消息。为了实现与 EC2Config 服务的向后兼容，您可以安排 EC2Launch 在每次启动时发送此消息。在实例上，打开 Windows PowerShell 并运行以下命令。系统会安排脚本作为 Windows 计划任务运行。


PS C:\> C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SendWindowsIsReady.ps1 -Schedule

将 Sysprep 与 EC2Launch 结合使用

Sysprep 简化了重复执行 Windows Server 2016 及更高版本自定义安装的过程。EC2Launch 为 Sysprep 提供一个默认回复文件和各种批处理文件，来自动执行并保护您的 AMI 上的映像准备过程。您可以选择性地修改这些文件。这些文件默认位于以下目录：C:\ProgramData\Amazon\EC2-Windows\Launch\Sysprep。

重要

不要使用 Sysprep 创建实例备份。Sysprep 会删除系统特定信息。如果您删除此信息，可能会给实例备份带来意想不到的后果。

用于 Sysprep 的 EC2Launch 回复文件和批处理文件包括：

Unattend.xml: 这是默认应答文件。如果您运行 SysprepInstance.ps1 或者在用户界面中选择 ShutdownWithSysprep，系统会从该文件中读取设置。
BeforeSysprep.cmd: 自定义此批处理文件，以便在 EC2Launch 运行 Sysprep 前执行命令。
SysprepSpecialize.cmd: 自定义此批处理文件，以便在 Sysprep 专门化阶段期间运行命令。

将 Sysprep 与 EC2Launch 一起运行

在 Windows Server 2016 及更高版本的完整安装（带有桌面体验）上，可以通过手动方式或者使用 EC2 Launch Settings 应用程序将 Sysprep 与 EC2Launch 一起运行。

使用 EC2Launch Settings 应用程序运行 Sysprep

在 Amazon EC2 控制台中，找到或创建 Windows Server 2016 或更高版本 AMI。
从该 AMI 中启动 Windows 实例。
连接到您的 Windows 实例并对其进行自定义。
搜索并运行 EC2LaunchSettings 应用程序。默认情况下它位于以下内容：C:\ProgramData\Amazon\EC2-Windows\Launch\Settings。
根据需要选中或清除选项。这些设置存储在 LaunchConfig.json 文件中。
对于 Administrator Password，请执行以下操作之一：
- 选择 Random。EC2Launch 生成一个密码并使用用户的密钥对其进行加密。系统会在实例启动后禁用此设置，以便在重新启动或停止再启动实例后该密码仍然存在。
- 选择 Specify 并键入一个符合系统要求的密码。该密码以明文方式存储在 LaunchConfig.json 文件中，并且在 Sysprep 设置管理员密码时会被删除。如果现在就关闭，则会立即设置密码。EC2Launch 使用用户的密钥对密码进行加密。
- 选择 DoNothing 并在 unattend.xml 文件中指定密码。如果未在 unattend.xml 中指定密码，管理员账户会被禁用。
选择 Shutdown with Sysprep (使用 Sysprep 关闭)。

手动使用 EC2Launch 运行 Sysprep

在 Amazon EC2 控制台中找到或创建您要复制的 Windows Server 2016 或更高版本数据中心版 AMI。
启动并连接到您的 Windows 实例。
自定义实例。
在 LaunchConfig.json 文件中指定设置。默认情况下，该文件位于 C:\ProgramData\Amazon\EC2-Windows\Launch\Config 目录中。

对于 adminPasswordType，指定下列值之一：

Random

EC2Launch 生成一个密码并使用用户的密钥对其进行加密。系统会在实例启动后禁用此设置，以便在重新启动或停止再启动实例后该密码仍然存在。

Specify

EC2Launch 使用您在 adminPassword 中指定的密码。如果密码不满足系统要求，EC2Launch 会生成随机密码。该密码以明文方式存储在 LaunchConfig.json 文件中，并且在 Sysprep 设置管理员密码时会被删除。EC2Launch 使用用户的密钥对密码进行加密。

DoNothing

EC2Launch 使用您在 unattend.xml 文件中指定的密码。如果未在 unattend.xml 中指定密码，管理员账户会被禁用。
(可选) 在 unattend.xml 和其他配置文件中指定设置。如果您计划参与安装，则无需在这些文件中进行更改。这些文件默认位于以下目录：C:\ProgramData\Amazon\EC2-Windows\Launch\Sysprep。
在 Windows PowerShell 中，运行 ./InitializeInstance.ps1 -Schedule。默认情况下，该脚本位于以下目录中：C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts。该脚本安排实例在下次启动期间初始化。您必须先运行此脚本，然后再在下一个步骤中运行 SysprepInstance.ps1 脚本。
在 Windows PowerShell 中，运行 ./SysprepInstance.ps1。默认情况下，该脚本位于以下目录中：C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts。

您会退出实例并且实例会关闭。如果您在 Amazon EC2 控制台中查看实例页面，实例状态会从 running 变为 stopping，然后变为 stopped。此时，从该实例创建 AMI 是安全的。

在启动自定义 AMI 时更新 Server 2016 及更高版本的元数据/KMS 路由

要在启动自定义 AMI 时更新 Server 2016 及更高版本的元数据/KMS 路由，请执行下列操作之一：

运行 EC2LaunchSettings GUI (C:\ProgramData\Amazon\EC2-Windows\Launch\Settings\Ec2LaunchSettings.exe) 并选择相应选项以便在使用 Sysprep 的情况下关闭。
在创建 AMI 之前，运行 EC2LaunchSettings 并在未使用 Sysprep 的情况下关闭。这会将 EC2 启动初始化任务设置为在下次引导时运行，从而根据实例的子网设置路由。
在从 PowerShell 创建 AMI 之前，手动重新计划 EC2 启动初始化任务。

重要

在重新计划任务之间记录默认的密码重置行为。

Javascript 在您的浏览器中被禁用或不可用。

要使用 AWS 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

配置实例

安装 EC2Launch