本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # EC2Launch v2 版本歷程記錄 **Topics** + [EC2Launch v2 版本歷史記錄](#ec2launchv2-version-history) ## EC2Launch v2 版本歷史記錄 要確保您已安裝最新的啟動代理程式，請參閱 [安裝最新版本的 EC2Launch v2](ec2launch-v2-install.md)。您會在 EC2Launch v2 代理程式有新版本發佈時收到通知。如需詳細資訊，請參閱[訂閱 EC2 Windows 啟動代理程式通知](launch-agents-subscribe-notifications.md)。 下表說明 EC2Launch v2 的發行版本。 | 版本 | 詳細資訊 | 發行日期 | | --- | --- | --- | | 2.5.2 | + 修正自訂憑證和群組政策部署憑證的 RDP 憑證驗證失敗的問題。 | 2026 年 8 月 5 日 | | 2.5.1 | + 改善啟用休眠時的錯誤偵測。 | 2026 年 6 月 3 日 | | 2.5.0 | + 更新序列連接埠邏輯，以在序列連接埠無法使用時繼續代理程式任務。
+ 已將 EC2 Windows 公用程式裝置驅動程式版本新增至執行個體主控台輸出。
+ 已移除未使用的凳子日誌檔案。
+ 寫入執行個體主控台輸出時最佳化驅動程式查詢。 | 2026 年 5 月 4 日 | | 2.4.0 | + 透過移除備援 `console.log`、 `err.log` 檔案來簡化代理程式記錄。
+ 透過新增日誌輪換、將日誌大小限制為 1 MB，並將時間精確度提高到毫秒，來增強客服人員日誌記錄功能。
+ 已移除 Hyper-V 狀態查詢和相關的執行個體主控台輸出。 | 2026 年 3 月 5 日 | | 2.3.237 | + 修正特定 Visual C\+\+ 執行時間版本與代理程式遙測函數之間不相容所造成的代理程式當機問題。 | 2026 年 2 月 25 日 | | 2.3.108 | + 已將 IPv6 地址顯示新增至桌布。如需記憶體和網路屬性，請參閱 [AWS 文件](https://aws.amazon.com/ec2/instance-types/)。 | 2025 年 12 月 29 日 | | 2.3.56 | + 修正 EC2Launch v2 未正確處理預先設定持久性網路路由的問題。 | 2025 年 11 月 4 日 | | 2.3.5 | + 新增路由時，透過 IMDS 改進主要網路介面偵測功能。 | 2025 年 9 月 15 日 | | 2.2.63 | + 更新了啟動代理程式，以改進 [遙測](ec2launch-v2.md#ec2launch-v2-telemetry)。 | 2025 年 7 月 29 日 | | 2.1.1 | + 新增對 IPv6 的完整支援。 | 2025 年 5 月 14 日 | | 2.0.2107 | + 增強了路由新增功能，以處理介面上未配置 IPv4 或 IPv6 位址的場景。 | 2025 年 3 月 27 日 | | 2081 年 2 月 0 日 | + 修正未正確擷取或驗證 RDP 憑證資訊的問題。已新增功能，可視需要自動啟動遠端桌面服務。
+ 調整了 EC2Launch v2 服務許可，以修正查詢服務狀態時發生的問題。 | 2025 年 2 月 4 日 | | 2046 年 2 月 0 日 | + 更新 `agent-config.yml` 檔案中的桌布路徑，以使用預設作業系統桌布路徑。
+ 新增遙測以監控代理程式發生錯誤的位置。
+ 更新代理程式日誌訊息。 | 2024 年 10 月 3 日 | | 2.0.1981 | + 已更新針對非管理員使用者的 `EC2Launch.exe` CLI 命令錯誤訊息。 | 2024 年 8 月 6 日 | | 2.0.1948 | + 新增遙測以監控管理員密碼選項的使用情況。
+ 已修改 EC2Launch 許可。 | 2024 年 7 月 1 日 | | 2.0.1924 | + 已更新 EC2Launch 設定 UI。
+ 已更新桌布 CLI 命令。
+ 已更新 EC2Launch 安裝程式。 | 2024 年 6 月 10 日 | | 2.0.1914 | + 新增具有未指定閘道地址的路由 (適用於 IPv4 的 `0.0.0.0` 或適用於 IPv6 的 `::`)。
+ 一律新增 IPv4 和 IPv6 路由。
+ 修正未指定 `Administrator` 使用者名稱時新增至 `agent-config.yml` 檔案的問題。
+ 已修改 EC2Launch v2 許可。 | 2024 年 6 月 5 日 | | 2.0.1881 | + 已將加密密碼選項新增至 `setAdminAccount` 任務。
+ 已將 CLI 命令新增至 agent-config.yml 中的加密靜態密碼。
+ 已修正 XML 在使用管理員許可執行時，使用者資料未新增 PowerShell 引數的問題。如需詳細資訊，請參閱[Amazon EC2 如何處理 Windows 執行個體的使用者資料](user-data.md#ec2-windows-user-data)。
+ 已調整當使用 `LocalSystem` 許可執行時，`executeScript` 任務和使用者資料指令碼的 PowerShell 引數。當引數為空時，代理程式會使用下列預設值：`-ExecutionPolicy Unrestricted`。
+ 防止將重複的驅動程式版本列印到主控台日誌。 | 2024 年 5 月 8 日 | | 2.0.1815 | + 已調整錯誤處理，以在 sysprep 之前失敗關鍵設定問題。
+ 已修正桌布和主機名稱任務在執行個體上使用不正確的 IP 位址，並將多個 IP 位址指派給主要網路介面的問題。
+ 桌布和主機名稱工作已變更為先從 IMDS 取得私有 IP，如果 IMDS 已停用，則回到 WMI。
+ 已修正 `initializeVolume` 任務因暫時性錯誤導致 `sc1` 磁碟區無法初始化的問題。 | 2024 年 3 月 6 日 | | 2.0.1739 | + 已修正 Windows Administrator 使用者執行的 `executeScript` 工作無法擷取結束代碼的問題。 | 2024 年 1 月 17 日 | | 2.0.1702 | + 將 `Telemetry.log` 許可限制為 `read-execute`，僅適用於標準使用者。
+ 將 EC2Launch Windows 服務設定為在啟動失敗時重新啟動。
+ 透過記錄 `route.exe` `stderr` 輸出，使 `add-routes` 故障可操作。
+ 修正當路由指標超出 [1, 9999] 範圍時發生的問題。
+ 為數種新的執行個體類型新增了桌布支援。
+ 修正以 Windows 管理員使用者身分執行並將輸出傳送至 `stderr` 的使用者資料指令碼所造成的問題。 | 2024 年 1 月 4 日 | | 2.0.1643 | + 將 `ebsnvme-id.exe` 工具更新至 1.1.0.7 版。
+ 修正以 'metal-\*' 開頭 (例如 metal-48x1) 的金屬執行個體類型的接收端調整 (RSS) 和接收佇列深度設定的問題。
+ 已移除對封鎖代理程式之 XML 使用者資料命令進行報告的遙測事件。
+ 已更新 `setDnsSuffix` 任務，以根據登錄項目限制網域名稱轉移：`HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Dnscache\Parameters\DomainNameDevolutionLevel`。
+ 新增一個公有任務以及可新增網路路由的 CLI。
+ *注意* – 這是正式支援 Windows Server 2012 的最新版本。
+ *注意* – 這是正式支援 32 位元作業系統的最新版本。 | 2023 年 10 月 4 日 | | 2.0.1580 | + 修改日誌檔案許可時，已變更啟動代理程式處理錯誤的方式。
+ 已新增連線至序列埠資源的逾時時間。如果序列埠正在使用中，則逾時允許啟動代理程式繼續執行。 | 2023 年 9 月 5 日 | | 2.0.1521 | + 已棄用 `EC2Launch.exe`、**reset** 和 **sysprep** 命令的 `—block` 旗標。
+ `EC2Launch.exe` 已更新，可偵測並處理內嵌 `executeScript` 任務中使用的 **reset** 和 **sysprep** 命令。這些命令會導致代理程式在 `executeScript` 任務執行後停止執行。
+ 已更新 XML 使用者資料指令碼，預設情況下會內嵌執行。
+ 啟用 XML 使用者資料指令碼，以使用新的 `detach` 標籤在分離狀態下執行。如需詳細資訊，請參閱[使用者資料指令碼](user-data.md#user-data-scripts)。
+ 對代理程式日誌進行了下列變更。 更新代理程式日誌訊息。 從代理程式日誌中移除 `executeScript` 內容和輸出。 從代理程式日誌中移除 `executeProgram` 引數和輸出。
+ 對主控台日誌進行了下列變更。 為主控台日誌新增 `EnableSCSIPersistentReservations` 值。 | 2023 年 7 月 3 日 | | 2.0.1303 | + 新增網絡路由時新增了額外的錯誤處理和日誌行。
+ 在 PreReady 階段中已允許 `executeScript` 和 `executeProgram` 任務。
+ 已更新 `executeProgram` 任務，以產生類似於 executeScript 任務輸出的輸出檔案。如需詳細資訊，請參閱[executeProgram](ec2launch-v2-task-definitions.md#ec2launch-v2-executeprogram)。
+ 已新增遙測，以監控 XML 使用者資料中封鎖代理程式命令的使用情況。 | 2023 年 5 月 3 日 | | 2.0.1245 | + 以純文字形式記錄當機呼叫堆疊，改善當機的可見性。
+ 已新增 EventLog 服務作為啟動相依性，以在 Amazon EC2Launch 服務啟動速度比 EventLog 服務更快時修正當機問題。
+ 讓 XML 使用者資料在 PostReady 階段之前從代理程式組態檔案 (例如 EC2Launch v1 和 EC2Config) 中執行。
+ 已新增 YAML 使用者資料 1.1 版，讓使用者資料在 PostReady 階段之前從代理程式組態檔案中執行 (YAML 使用者資料 1.0 版在 PostReady 階段之後從代理程式組態檔案中執行)。 | 2023 年 3 月 8 日 | | 2.0.1173 | + 新增一個可選功能以在桌布上顯示執行個體標籤。如需詳細資訊，請參閱[setWallpaper](ec2launch-v2-task-definitions.md#ec2launch-v2-setwallpaper)。
+ 未正確設定 Elastic Graphics 的安全群組時，會新增錯誤處理。
+ 修復未啟用執行個體中繼資料服務時的逾時。 | 2023 年 2 月 6 日 | | 2.0.1121 | + 修正未指派公有 IPv4 地址時會將 404 錯誤列印至桌布的問題。
+ 修復當裝置的磁碟機代號設為 `D` 時磁碟區檔案系統格式為 `RAW` 而非 `NTFS` 的問題。
+ 修復 NVMe SSD 磁碟區錯誤識別為 EBS 磁碟區的問題。
+ 修復在停用 IMDS 後啟動 Windows 時的錯誤。 | 2023 年 1 月 4 日 | | 2.0.1082 | + 修正停用 IMDS 時 `setWallpaper`:`privateIpAddress` 欄位為空白的問題。
+ 修正停用 IMDS 時將主機名稱設定為私有 IPv4 地址的問題。
+ 修正在 Windows Server 2012 上初始化磁碟區的問題。
+ 修正設定巨型訊框的問題。
+ 修正執行個體啟動時未指定 SSH 金鑰時的錯誤。
+ 修正 Windows 沒有 'ReleaseId' 登錄機碼時 Windows Server 2012 上的錯誤。 | 2022 年 12 月 7 日 | | 2.0.1011 | + 修正 PnPDeviceID 為空白時尋找網路轉接器的邏輯。 | 2022 年 11 月 11 日 | | 2.0.1009 | + 使用 PCI 區段資訊來選取主控台連接埠。 | 2022 年 11 月 8 日 | | 2.0.982 | + 新增重試邏輯以獲取 RDP 資訊。
+ 修正 `d2.8xlarge` 執行個體的磁碟區初始化期間的錯誤。
+ 修正在重新啟動後可能會選取錯誤網路轉接器的問題。
+ 當 ACPI SPCR 無法使用時，移除誤報錯誤訊息。 | 2022 年 10 月 31 日 | | 2.0.863 | + 更新 IMDS 等待邏輯，以僅傳出 IMDSv2 請求。
+ 新增邏輯，將磁碟機代號指派給已初始化但未掛載的磁碟區。
+ 當 key pair type 不受支援時，印出更詳細的錯誤訊息。
+ 修復 3010 重新啟動的程式碼錯誤。
+ 新增檢查無效 base64 編碼的使用者資料功能。 | 2022 年 7 月 6 日 | | 2.0.698 | + 修復了執行指令碼時日誌輸出中的錯字。 | 2022 年 1 月 30 日 | | 2.0.674 | + 遙測會上傳已啟用/已停用的隱私權控制。
+ 修正 `index out of bounds` 錯誤。
+ 在 `sysprep` 期間移除桌布捷徑。 | 2021 年 11 月 15 日 | | 2.0.651 | + 新增邏輯以在安裝 EC2Launch v2 期間，解除安裝舊式代理程式。
+ 修正根磁碟區未列為磁碟區 0 時的 `list-volume` CLI 問題。 | 2021 年 10 月 7 日 | | 2.0.592 | + 修正錯誤以正確報告階段狀態。
+ 當日誌檔關閉時，移除錯誤的警示錯誤訊息。
+ 新增遙測。 | 2021 年 8 月 31 日 | | 2.0.548 | + 為十六進位 IP 主機名稱新增開頭的零。
+ 修正 `enableOpenSsh` 任務的檔案許可。
+ 修正 sysprep 命令當機。 | 2021 年 8 月 4 日 | | 2.0.470 | + 修正在網路階段中等待 DHCP 指派 IP 給執行個體的錯誤。
+ 修正 `SearchList` 登錄機碼不存在時的 `setDnsSuffix` 錯誤。
+ 修正 `setDnsSuffix` 中 DNS 轉移邏輯中的錯誤。
+ 在中繼重新開機後新增網路路由。
+ 允許 `initializeVolume` 重新用字母標示現有磁碟區。
+ 從版本子命令中移除額外的資訊。 | 2021 年 7 月 20 日 | | 2.0.285 | + 在分離的程序中新增了執行使用者指令碼的選項。
+ 舊式使用者資料 (XML 使用者資料) 現在會在分離的程序中執行，這與之前啟動代理程式類似的行為。
+ 將 CLI 標記新增至 `sysprep` 和 `reset` 命令，這可讓其在服務停止之前進行封鎖。
+ 限制組態資料夾許可。 | 2021 年 3 月 8 日 | | 2.0.207 | + 將選擇性 `hostName` 欄位新增至 `setHostName` 工作。
+ 修正重新開機錯誤。重新啟動任務 `executeScript` 並將 `executeProgram` 標記為執行中。
+ 在狀態命令中新增更多傳回碼。
+ 新增引導服務，以修正在執行 `t2.nano` 執行個體類型時的啟動問題。
+ 修正全新安裝模式，以移除安裝程式未追蹤的檔案。 | 2021 年 2 月 2 日 | | 2.0.160 | + 修正 `validate` 命令，以偵測無效的階段名稱。
+ 在 `addroutes` 任務中新增 `w32tm resync` 命令。
+ 修正變更 DNS 尾碼搜尋順序的問題。
+ 新增檢查條件，以更詳細地報告無效的使用者資料。 | 2020 年 12 月 4 日 | | 2.0.153 | 在 UserData 中新增 Sysprep 功能。 | 2020 年 11 月 3 日 | | 2.0.146 | + 修正在非英文 AMI 上的 RootExtend 的問題。
+ 授與使用者群組寫入日誌檔案的權限。
+ 為 GPT 磁碟區建立 MS 預留的磁碟分割。
+ 在 Amazon EC2Launch 設定中，新增清單磁碟區命令和磁碟區下拉式清單。
+ 新增 get-agent-config 命令，用於列印 yaml 或 json 格式的 agent-config.yml 檔案。
+ 如果沒有偵測到公開金鑰，則清除靜態密碼。 | 2020 年 10 月 6 日 | | 2.0.124 | + 新增在桌布上顯示作業系統版本的選項。
+ 初始化加密的 EBS 磁碟區。
+ 為沒有本機 DNS 名稱的 VPC 新增路由。 | 2020 年 9 月 10 日 | | 2.0.104 | + 如果不存在，則建立 DNS 尾碼搜尋清單。
+ 如果沒有要求，則可略過休眠。 | 2020 年 8 月 12 日 | | 2.0.0 | 初始版本。 | 2020 年 6 月 30 日 |