在 EC2 Windows 執行個體啟動期間,使用 EC2Launch v1 代理程式執行工作 - Amazon Elastic Compute Cloud

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

在 EC2 Windows 執行個體啟動期間,使用 EC2Launch v1 代理程式執行工作

EC2Launch是一組視窗 PowerShell 腳本,取代了視窗EC2Config服務器 2016 年和 2019 上的服務AMIs。其中許多AMIs仍然可用。EC2Launchv2 是所有受支援 Windows 版本的最新啟動代理程式,它會取代EC2Config和EC2Launch。如需詳細資訊,請參閱使用 EC2Launch v2 代理程式在 EC2 Windows 執行個體啟動期間執行工作

注意

若要EC2Launch與配合使用IMDSv2,此版本必須是 1.3.2002730 或更新版本。

您可以使用下列 Windows PowerShell 命令來驗證的已安裝版本EC2Launch。

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

EC2Launch任務

EC2Launch在初始執行個體啟動期間,預設會執行下列工作:

  • 設定呈現執行個體資訊的新桌面。

  • 將電腦名稱設定為執行個體的私人IPv4位址。

  • 將執行個體資訊傳送到 Amazon EC2 主控台。

  • 將RDP憑證指紋傳送至EC2主控台。

  • 為管理員帳戶設定隨機密碼。

  • 添加DNS後綴。

  • 動態擴充作業系統分割區,以包含任何未分割的空間。

  • 執行使用者資料 (若指定)。如需指定使用者資料的詳細資訊,請參閱使用使用者資料輸入啟動執行個EC2體時執行指令

  • 設置持久靜態路由以訪問元數據服務和服務 AWS KMS 器。

    重要

    如果從此執行個體建立自訂AMI,則會擷取這些路由做為作業系統組態的一部分,而從中啟動的任何新執行個體都AMI將保留相同的路由,而不論子網路位置為何。若要更新路由,請參閱在啟動自訂時,更新伺服器 2016 及更新版本的中繼資料/KMS路由 AMI

下列工作有助於維護與EC2Config服務的回溯相容性。您也可以設定EC2Launch為在啟動期間執行下列工作:

  • 初始化輔助EBS磁碟區。

  • 將 Windows 事件記錄檔傳送至主EC2控台記錄檔。

  • Windows 已準備就緒可以使用的消息發送到EC2控制台。

如需 Windows Server 2019 的詳細資訊,請參閱 Microsoft.com 上的比較 Windows Server 版本功能

EC2Launch 目錄結構

EC2Launch默認情況下安裝在視窗服務器 2016 和更高版本AMIs的根目錄中C:\ProgramData\Amazon\EC2-Windows\Launch

注意

根據預設,Windows 會將檔案和資料夾隱藏在 C:\ProgramData 下。若要檢視EC2Launch目錄和檔案,您必須在 Windows 檔案總管中輸入路徑,或變更資料夾內容以顯示隱藏的檔案和資料夾。

Launch 目錄包含下列子目錄。

  • Scripts— 包含構成的 PowerShell 指令碼EC2Launch。

  • Module— 包含用於建置與 Amazon 相關指令碼的模組EC2。

  • Config – 含有您可以自訂的指令碼組態檔案。

  • Sysprep – 含有 Sysprep 資源。

  • Settings – 含有 Sysprep 圖形使用者介面的應用程式。

  • Library— 包含EC2啟動代理程式的共用程式庫。

  • Logs – 含有指令碼產生的日誌檔案。

遙測

遙測是其他資訊,可協 AWS 助您進一步瞭解您的需求、診斷問題,並提供可改善 AWS 服務體驗的功能。

EC2Launch版本1.3.2003498和更新版本會收集遙測資料,例如使用量度和錯誤。這些資料是從執EC2Launch行所在的 Amazon EC2 執行個體收集而來。這包括所有AMIs擁有的視窗 AWS。

下列類型的遙測收集方式EC2Launch:

  • 用量資訊 – 代理程式命令、安裝方法和排程的執行頻率。

  • 錯誤和診斷資訊 – 代理程式安裝和執行錯誤代碼。

收集資料的範例:

2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true 2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true 2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1 2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5 2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2 2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0

預設為啟用遙測。您可隨時停用遙測收集。如果啟用遙測,則EC2Launch會傳送遙測資料,而不需要其他客戶通知。

您選擇啟用或停用遙測收集。

您可以選擇加入或退出遙測收集。您選取加入或退出遙測收集,以確保我們遵守您的遙測選項。

遙測可見性

啟用遙測後,它會顯示在 Amazon EC2 主控台輸出中,如下所示:

2021/07/15 21:44:12Z: Telemetry: <Data>
停用執行個體的遙測

若要藉由設定系統環境變數來停用遙測,請以管理員身分執行下列命令:

setx /M EC2LAUNCH_TELEMETRY 0

若要在安裝期間停用遙測,請執行 install.ps1,如下所示:

. .\install.ps1 -EnableTelemetry:$false