安裝最新版本的 EC2Launch v2

您可使用以下其中一種方法，在 EC2 執行個體上安裝 EC2Launch v2 代理程式：

• 從 Amazon S3 下載代理程式並使用視窗進行安裝 PowerShell。如需下載 URL，請參閱 在 Amazon S3 上下載 EC2Launch v2。

• 透過 SSM Distributor 進行安裝。

• 從 EC2 Image Builder 元件進行安裝。

• 從已預先安裝 EC2Launch v2 的 AMI 啟動執行個體。

警告

AmazonEC2Launch.msi 會解除安裝先前版本的 EC2 啟動服務，例如 EC2Launch (v1) 和 EC2Config。

如需了解安裝步驟，請選取符合您偏好方法的索引標籤。

Windows PowerShell

若要使用 Windows 安裝最新版本的 EC2Launch v2 代理程式 PowerShell，請依照下列步驟執行。

1. 建立您的本機目錄。

   New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory

2. 為您的下載位置設定 URL。使用您將使用的 Amazon S3 URL 執行以下命令。如需下載 URL，請參閱 在 Amazon S3 上下載 EC2Launch v2

   $Url = "Amazon S3 URL/AmazonEC2Launch.msi"

3. 使用以下複合命令來下載和安裝代理程式：

   $DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
   Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
   msiexec /i "$DownloadFile"

4. 若要驗證安裝情況，請檢查 msi 檔案是否存在於您執行個體的 EC2Launch v2 目錄中 (C:\ProgramData\Amazon\EC2Launch)。

AWS Systems Manager Distributor

您可以從  AWS Systems Manager  Distributor 安裝 AWSEC2Launch-Agent 套件。如需有關如何從 Systems Manager Distributor 安裝套件的指示，請參閱《AWS Systems Manager  使用者指南》中的安裝或更新套件。

EC2 Image Builder component

您可以在使用 EC2 Image Builder 建置自訂映像時，安裝 ec2launch-v2-windows 元件。如需如何使用 EC2 Image Builder 建置自訂映像的指示，請參閱 EC2 Image Builder 使用者指南中的使用 EC2 Image Builder 主控台精靈建立映像管道。

AMI

EC2Launch v2 預設會預先安裝在以下 Windows Server 2022 和 UEFI AMI 上：

• Windows_Server-2022-English-Full-Base

• Windows_Server-2022-English-Core-Base

• 所有其他語言的 Windows Server 2022 AMI

• 安裝 SQL 的 Windows Server 2022 AMI

• Windows_Server-2022-English-Core-EKS_Optimized

EC2Launch v2 也已預先安裝在下列 Windows Server AMI 上。您可以在 Amazon EC2 主控台找到這些 AMI，或使用下列搜尋字首： AWS CLI 中的 EC2LaunchV2-。

• EC2LaunchV2-Windows_Server-2019-English-Core-Base

• EC2LaunchV2-Windows_Server-2019-English-Full-Base

• EC2LaunchV2-Windows_Server-2016-English-Core-Base

• EC2LaunchV2-Windows_Server-2016-English-Full-Base

• EC2LaunchV2-Windows_Server-2012_R2_RTM-English-Full-Base

• EC2LaunchV2-Windows_Server-2012_RTM-English-Full-Base

在 Amazon S3 上下載 EC2Launch v2

若要安裝最新版本 EC2Launch v2，請從下列其中一個位置下載安裝程式：

注意

我們即將汰除 32 位元的安裝連結。建議您使用 64 位元的安裝連結來安裝 EC2Launch v2。如果您需要 32 位元的啟動代理程式，請使用 EC2Config。

• 64 位元 - https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi

• 32 位元— https://s3.amazonaws.com/amazon-ec2launch-v2/windows/386/latest/AmazonEC2Launch.msi

設定安裝選項

在安裝或升級 EC2Launch v2 時，您可以使用 EC2Launch v2 安裝對話方塊或命令列 shell 中的 msiexec 命令來設定安裝選項。

首次在執行個體上執行 EC2Launch v2 安裝程式時，該安裝程式會初始化執行個體上的啟動代理程式設定，如下所示：

• 安裝程式會建立本機路徑，並將啟動代理程式檔案寫入該路徑。這有時被稱為全新安裝。

• 安裝程式會建立 EC2LAUNCH_TELEMETRY 環境變數 (若尚無)，並根據您的組態進行設定。

如需有關設定的詳細資訊，請選取符合您將使用的設定方法的索引標籤。

Amazon EC2Launch Setup dialog

在安裝或升級 EC2Launch v2 時，您可以透過 EC2Launch v2 安裝對話方塊來設定以下安裝選項。

基本安裝選項

傳送遙測

在您將此功能納入安裝對話方塊中時，安裝程式會將 EC2LAUNCH_TELEMETRY 環境變數的值設定為 1。若您停用傳送遙測，安裝程式會將環境變數設定為 0。

在 EC2Launch v2 代理程式執行時，其會讀取 EC2LAUNCH_TELEMETRY 環境變數，決定是否要上傳遙測資料。若值等於 1，則會上傳資料。若不是，則不會上傳。

預設組態

EC2Launch v2 的預設組態為覆寫本機啟動代理程式 (若已具備)。首次在執行個體上執行安裝時，預設組態會執行全新安裝。若您在初始安裝時停用預設組態，則安裝會失敗。

若再次在執行個體上執行安裝，您可以停用預設組態，執行不會取代 %ProgramData%/Amazon/EC2Launch/config/agent-config.yml 檔案的升級。

範例：使用遙測來升級 EC2Launch v2

以下範例會顯示設定為升級目前安裝及啟用遙測的 EC2Launch v2 設定對話方塊。此組態會在不取代代理程式組態檔案的情況下執行安裝，並將 EC2LAUNCH_TELEMETRY 環境變數設定為 1。

Command line

在安裝或升級 EC2Launch v2 時，您可以使用命令列 shell 中的 msiexec 命令來設定以下安裝選項。

ADDLOCAL 參數值

基本 (必填)

安裝啟動代理程式。如果 ADDLOCAL 參數中不存在此值，則安裝結束。

全新

當您在 ADDLOCAL 參數中納入 Clean 值時，安裝程式會將代理程式組態檔案寫入以下位置：%ProgramData%/Amazon/EC2Launch/config/agent-config.yml。如果代理程式組態檔案已存在，則會覆寫檔案。

當您將 Clean 值放在 ADDLOCAL 參數之外時，安裝程式會執行不會取代代理程式組態檔案的升級。

遙測

當您在 ADDLOCAL 參數中納入 Telemetry 值時，安裝程式會將 EC2LAUNCH_TELEMETRY 環境變數設為 1。

當您將 Telemetry 值放在 ADDLOCAL 參數之外時，安裝程式會將環境變數設為 0。

在 EC2Launch v2 代理程式執行時，其會讀取 EC2LAUNCH_TELEMETRY 環境變數，決定是否要上傳遙測資料。若值等於 1，則會上傳資料。若不是，則不會上傳。

範例：使用遙測安裝 EC2Launch v2

& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q

確認 EC2Launch v2 版本

請用下列程序之一確認執行個體上安裝的 EC2Launch v2 版本。

Windows PowerShell

使用視窗驗證已安裝的 EC2 啟動 v2 版本 PowerShell，如下所示。

1. 從 AMI 啟動執行個體，並連線至執行個體。

2. 在中執行下列命令， PowerShell 以驗證 EC2Launch v2 的已安裝版本：

   & "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version

Windows Control Panel

在 Windows 控制台中確認已安裝的 EC2Launch v2 版本，如下所示。

1. 從 AMI 啟動執行個體，並連線至執行個體。

2. 開啟 Windows 控制台，然後選擇程式和功能。

3. 從已安裝程式清單中，找出 Amazon EC2Launch。其版本編號將出現在 Version (版本) 欄中。

如需 Windows AMIs 內含之 EC2Launch v2 版本的資訊，請參閱 AWS 視窗 AMI。

如需 EC2Launch v2 的最新版本，請參閱 EC2Launch v2 版本歷史記錄。

如需 EC2Launch v2 遷移工具的最新版本，請參閱 EC2Launch v2 遷移工具版本歷史記錄。

您會在 EC2Launch v2 服務有新版本發佈時收到通知。如需詳細資訊，請參閱 訂閱 EC2Launch v2 服務通知。