本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用映像建置器匯入已驗證的 Windows ISO 磁碟映像 Windows 作業系統 ISO 檔案是一種磁碟映像檔案，其中包含特定版本 Windows 作業系統的完整安裝套件。Microsoft 會直接從其網站或透過授權經銷商提供官方 Windows 作業系統 ISO 檔案以供下載。為了避免潛在的惡意軟體或未經授權的版本，請從信任且合法的來源取得 ISO 檔案。 EC2 Image Builder 使用`build-image-from-iso`匯入工作流程匯入 ISO 磁碟檔案，並從中建立次要磁碟區。組態完成後，Image Builder 會擷取從匯入建立之磁碟區的快照，並使用它來建立 Amazon Machine Image (AMI)。 ## ISO 磁碟映像匯入支援的作業系統 Image Builder 支援下列 Windows 作業系統 ISO 磁碟映像： + Windows 11 企業版 25H2 (x64) + Windows 11 Enterprise 24H2 版 (x64) + Windows 11 Enterprise 23H2 版 (x64) Image Builder 不支援下列 Windows 作業系統 ISO 磁碟映像： + 長期服務管道 (LTSC) 映像 + 從 Windows Media Creation Tool 建立的 ISO 磁碟映像 + 評估影像 ## 匯入 ISO 磁碟映像的先決條件 **注意** 在匯入程序期間，建置執行個體會從 Amazon S3 下載 AWS 驅動程式、EC2Launch v2 和 Systems Manager Agent，以及從公有網際網路下載 [Microsoft Defender](https://go.microsoft.com/fwlink/?linkid=2144531)。這些元件會預先暫存至輸出 AMI。建置執行個體也會與 Amazon EC2、Amazon CloudWatch Logs 和 SSM APIs 通訊。 如果您的 VPC 不在 中`us-east-1`，則建置執行個體需要公有網際網路存取 （例如，透過 NAT Gateway)，才能從全域 Amazon S3 端點 () 下載 AWS 驅動程式`ec2-windows-drivers-downloads.s3.amazonaws.com`。如果沒有公有網際網路存取，這些下載會失敗，而且匯入程序會失敗。 如果您的 VPC 位於 中`us-east-1`，則 Amazon S3 Gateway 端點足以下載驅動程式。下載驅動程式不需要 NAT Gateway。 不過，無論區域為何，Microsoft Defender 都需要公有網際網路存取才能下載。如果建置執行個體沒有網際網路存取，匯入仍會成功，但輸出 AMI 上未安裝 Microsoft Defender。 如需最低必要 VPC 端點和 S3 URLs的清單，請參閱 [私有 VPC 的最低網路需求](#iso-import-network-requirements)。 若要匯入 ISO 磁碟映像，您必須符合下列先決條件： + 磁碟映像的作業系統必須是映像建置器支援的作業系統。如需支援的作業系統清單，請參閱 [ISO 磁碟映像匯入支援的作業系統](#iso-import-supported-os)。 + 為了確保您可以匯入 ISO 映像，請從 Microsoft 365 管理中心下載映像。 + 您必須先將 ISO 磁碟檔案上傳至相同 中的 Amazon S3， AWS 帳戶 並在 AWS 區域 其中執行匯入，然後才能執行匯入程序。 + 副檔名對匯入程序區分大小寫，且必須是 `.ISO`。如果您的副檔名是小寫，請執行下列其中一個命令來重新命名它： ------ #### [ Command ] ``` aws s3 cp s3://{{amzn-s3-demo-bucket}}/{{Win11_24H2_English}}.iso s3://{{amzn-s3-demo-bucket}}/{{Win11_24H2_English}}.ISO ``` ------ #### [ PowerShell ] ``` Copy-S3Object -BucketName {{amzn-s3-demo-bucket}} -Key {{Win11_24H2_English}}.iso -DestinationKey {{Win11_24H2_English}}.ISO ``` ------ + Microsoft 授權不會自動包含在匯入中。您必須自備授權 (BYOL)。如需 Microsoft 軟體授權的詳細資訊，請參閱 Amazon Web Services 上的[授權](https://aws.amazon.com/windows/faq/#licensing-q)和 Microsoft 常見問答集頁面。 ** + 匯入程序使用兩個不同的 IAM 角色： **執行角色** 此角色授予 Image Builder AWS 服務 代表您呼叫 的許可。您可以指定[AWSServiceRoleForImageBuilder](security-iam-awsmanpol.md#sec-iam-manpol-AWSServiceRoleForImageBuilder)服務連結角色，其中包含執行角色所需的許可，也可以建立自己的角色。 **執行個體描述檔角色** 此角色會授予 服務在 EC2 執行個體上執行之動作的許可。您可以在基礎設施組態資源中指定執行個體描述檔角色。將下列受管政策連接至執行個體描述檔角色，以確保您擁有匯入程序所需的所有許可： + [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilder.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/EC2InstanceProfileForImageBuilder.html) + [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonSSMManagedInstanceCore.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonSSMManagedInstanceCore.html) 如需詳細資訊，請參閱[管理映像建置器基礎設施組態](manage-infra-config.md)。 ## 選用匯入設定 您可以在匯入 ISO 磁碟映像時選擇性地設定下列設定。這些設定會控制匯入影像的安全開機、UEFI 資料和影像索引選擇。 **安全開機** 安全開機是一項 UEFI 安全功能，可確保在開機程序期間只執行受信任的軟體。預設會針對 ISO 磁碟映像匯入啟用安全開機。如果您需要使用自訂未簽署驅動程式進行測試或舊版應用程式相容性，您可以停用安全開機。 **自訂 UEFI 資料** 您可以提供自訂 UEFI 資料 Blob 做為 Base64-encoded字串，以便在開機程序期間使用，而非 Image Builder 產生的預設 UEFI 資料。您只能在啟用安全開機時指定自訂 UEFI 資料 （預設值）。資料最多可達 64 KB。 您可以使用 GitHub 網站上的 [python-uefivars](https://github.com/awslabs/python-uefivars) 工具來檢查和修改 UEFI 資料。如需詳細資訊，請參閱 [Amazon EC2 執行個體的 UEFI 變數](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/uefi-variables.html)。 **影像索引** Windows ISO 檔案可以包含具有多個影像索引`.wim`的檔案，其中每個索引代表不同的 Windows 版本 （例如 Home 或 Pro)。根據預設，Image Builder 會使用 ISO 檔案的第一個有效映像索引。您可以指定以單一為基礎的影像索引，以從多版本 ISO 檔案選取特定版本。 ## 將 ISO 磁碟映像匯入映像建置器 開始匯入程序之前，請確定您已符合所有 [先決條件](#iso-import-prereq)。 匯入程序會在映像上安裝下列軟體和驅動程式： + EC2Launch v2 + AWS Systems Manager 代理程式 + AWS NVMe 驅動程式 + AWS ENA 網路驅動程式 + AWS PCI 序列驅動程式 + EC2 Windows 公用程式驅動程式 + Microsoft Defender 更新套件 匯入程序會在映像上進行下列組態更新： + 將系統設定為使用 Amazon Time 伺服器。 選擇索引標籤以檢視您偏好方法的匯入步驟： ------ #### [ Console ] 若要使用映像建置器主控台匯入 ISO 磁碟映像，請遵循下列步驟： 1. 開啟 EC2 Image Builder 主控台，位於 [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。 1. 從導覽窗格中選擇**影像**。 1. 若要開啟匯入對話方塊，請選擇**匯入映像**。 1. 輸入下列**一般資訊**： + 為您的映像指定唯一的**名稱**。 + 指定基礎映像的**版本**。使用下列格式：`major.minor.patch`。 1. 選擇匯入類型：**ISO 匯入**。 1. 輸入下列 **ISO 匯入組態**詳細資訊。完成後，請選擇**匯入映像**。 + **S3 URI** – 輸入 ISO 磁碟檔案的儲存位置。若要瀏覽檔案，請選擇**瀏覽 S3**。 + **IAM 角色** – 若要將 IAM 角色與您的匯入組態建立關聯，請從 **IAM 角色**下拉式清單中選取角色，或選擇**建立新角色**以建立新的角色。如果您建立新的角色，IAM 角色主控台頁面會在單獨的索引標籤中開啟。 您可以指定[AWSServiceRoleForImageBuilder](security-iam-awsmanpol.md#sec-iam-manpol-AWSServiceRoleForImageBuilder)服務連結角色，也可以指定自己的自訂角色來存取服務。 1. 您可以選擇性地為匯入設定下列進階設定。如需這些設定的詳細資訊，請參閱 [選用匯入設定](#iso-import-optional-settings)。 + **安全開機** – 預設會啟用安全開機。若要停用匯入映像的安全開機，請清除**安全開機**核取方塊。 + **自訂 UEFI 資料** – 若要提供自訂 UEFI 資料 Blob，請輸入 Base64-encoded字串。此選項僅在啟用安全開機時可用。 + **影像索引** – 若要從多版本 ISO 檔案選取特定 Windows 版本，請輸入以一個為基礎的影像索引。 1. 您可以選擇將標籤新增至映像建置器映像資源。在此處新增標籤不會將標籤新增至您的 AMI。 1. **ISO 基礎設施組態**會定義映像建置器啟動的執行個體設定，以託管匯入程序。您可以使用 Image Builder 根據服務預設值建立的基礎設施組態，也可以使用現有的基礎設施組態。如需詳細資訊，請參閱[管理映像建置器基礎設施組態](manage-infra-config.md)。 若要建立新的基礎設施組態，請選擇**建立基礎設施組態**。這會在單獨的索引標籤中開啟。建立新資源之後，您可以返回匯入組態，然後選擇**使用現有的基礎設施組態**。 1. 若要開始匯入程序，請選擇**匯入映像**。 匯入完成後，您的映像會出現在您擁有的映像清單中。如需詳細資訊，請參閱[列出影像](image-details-list.md#list-images)。 ------ #### [ AWS CLI ] 下列範例示範如何從 ISO 磁碟檔案匯入映像，並使用 從中建立 AMI AWS CLI。 以下是我們在此範例中指定的參數摘要： + **name** （字串，必要） – 要從匯入建立為輸出之映像建置器映像資源的名稱。 + **semanticVersion** （字串，必要） – 輸出映像的語意版本，指定以下格式的版本，每個位置都有數值來表示特定版本：..。例如 `1.0.0`。若要進一步了解映像建置器資源的語意版本控制，請參閱[Image Builder 中的語意版本控制](ibhow-semantic-versioning.md)。 + **description** （字串） – 映像配方的描述。 + **executionRole** （字串） – IAM 角色的名稱或 Amazon Resource Name (ARN)，授予 Image Builder 執行工作流程動作以從 Microsoft ISO 檔案匯入映像的存取權。您可以指定[AWSServiceRoleForImageBuilder](security-iam-awsmanpol.md#sec-iam-manpol-AWSServiceRoleForImageBuilder)服務連結角色，也可以指定自己的自訂角色來存取服務。 + **platform** （字串，必要） – ISO 磁碟映像的作業系統平台。有效值包括 `Windows`。 + **osVersion** （字串，必要） – ISO 磁碟映像的作業系統版本。有效值包括 `Microsoft Windows 11`。 + **infrastructureConfigurationArn** （字串，必要） – 用於啟動建置 ISO 映像之 EC2 執行個體的基礎設施組態資源的 Amazon Resource Name (ARN)。 + **uri** （字串，必要） – 存放在 Amazon S3 中 ISO 磁碟檔案的 URI。 + **registerImageOptions** （物件） – 設定匯入映像的安全開機和 UEFI 設定。包含下列欄位： + **secureBootEnabled** （布林值） – 指定是否為輸出 AMI 啟用安全開機。預設值為 `true`。若要停用自訂未簽署驅動程式的安全開機，請將此值設定為 `false`。 + **uefiData** （字串） – 非揮發性 UEFI 變數存放區的 Base64-encoded表示。您只能在 `secureBootEnabled`為 `true`或未指定 時指定此參數。 + **windowsConfiguration** （物件） – ISO 匯入的 Windows 特定組態設定。包含下列欄位： + **imageIndex** （整數） – 以 1 為基礎的索引，指定要從多版本 Windows ISO 檔案安裝的 Windows 版本。Windows ISO 可以包含具有多個影像索引`.wim`的檔案，每個都代表不同的版本。 ``` aws imagebuilder import-disk-image \ --name "{{example-iso-disk-import}}" \ --semantic-version "{{1.0.0}}" \ --description "{{Import an ISO disk image}}" \ --execution-role "{{AWSServiceRoleForImageBuilder}}" \ --platform "Windows" \ --os-version "Microsoft Windows 11" \ --infrastructure-configuration-arn "arn:aws:imagebuilder:{{us-east-1}}:{{111122223333}}:infrastructure-configuration/{{example-infrastructure-configuration-123456789abc}}" \ --uri "s3://{{amzn-s3-demo-source-bucket}}/{{examplefile.ISO}}" \ --register-image-options '{"secureBootEnabled": {{true}}, "uefiData": "{{custom-base64-encoded-uefi-data}}"}' \ --windows-configuration '{"imageIndex": {{1}}}' ``` 匯入完成後，您的映像會出現在您擁有的映像清單中。如需詳細資訊，請參閱[列出影像](image-details-list.md#list-images)。 ------ #### [ PowerShell ] 下列範例示範如何從 ISO 磁碟檔案匯入映像，並使用 PowerShell 從中建立 AMI。 以下是我們在此範例中指定的參數摘要： + **name** （字串，必要） – 要從匯入建立為輸出之映像建置器映像資源的名稱。 + **semanticVersion** （字串，必要） – 輸出映像的語意版本，指定以下格式的版本，每個位置都有數值來表示特定版本：..。例如 `1.0.0`。若要進一步了解映像建置器資源的語意版本控制，請參閱[Image Builder 中的語意版本控制](ibhow-semantic-versioning.md)。 + **description** （字串） – 映像配方的描述。 + **executionRole** （字串） – IAM 角色的名稱或 Amazon Resource Name (ARN)，授予 Image Builder 執行工作流程動作以從 Microsoft ISO 檔案匯入映像的存取權。您可以指定[AWSServiceRoleForImageBuilder](security-iam-awsmanpol.md#sec-iam-manpol-AWSServiceRoleForImageBuilder)服務連結角色，也可以指定自己的自訂角色來存取服務。 + **platform** （字串，必要） – ISO 磁碟映像的作業系統平台。有效值包括 `Windows`。 + **osVersion** （字串，必要） – ISO 磁碟映像的作業系統版本。有效值包括 `Microsoft Windows 11`。 + **infrastructureConfigurationArn** （字串，必要） – 用於啟動建置 ISO 映像之 EC2 執行個體的基礎設施組態資源的 Amazon Resource Name (ARN)。 + **uri** （字串，必要） – 存放在 Amazon S3 中 ISO 磁碟檔案的 URI。 + **registerImageOptions** （物件） – 設定匯入影像的安全開機和 UEFI 設定。包含下列欄位： + **secureBootEnabled** （布林值） – 指定是否為輸出 AMI 啟用安全開機。預設值為 `true`。若要停用自訂未簽署驅動程式的安全開機，請將此值設定為 `false`。 + **uefiData** （字串） – 非揮發性 UEFI 變數存放區的 Base64-encoded表示。您只能在 `secureBootEnabled`為 `true`或未指定 時指定此參數。 + **windowsConfiguration** （物件） – ISO 匯入的 Windows 特定組態設定。包含下列欄位： + **imageIndex** （整數） – 以 1 為基礎的索引，指定要從多版本 Windows ISO 檔案安裝的 Windows 版本。Windows ISO 可以包含具有多個影像索引`.wim`的檔案，每個都代表不同的版本。 ``` Import-EC2IBDiskImage ` -Name "{{example-iso-disk-import}}" ` -SemanticVersion "{{1.0.0}}" ` -Description "{{Import an ISO disk image}}" ` -ExecutionRole "{{AWSServiceRoleForImageBuilder}}" ` -Platform "Windows" ` -OsVersion "Microsoft Windows 11" ` -InfrastructureConfigurationArn "arn:aws:imagebuilder:{{us-east-1}}:{{111122223333}}:infrastructure-configuration/{{example-infrastructure-configuration-123456789abc}}" ` -Uri "s3://{{amzn-s3-demo-source-bucket}}/examplefile.ISO" ` -RegisterImageOptions_SecureBootEnabled {{$true}} ` -RegisterImageOptions_UefiData "{{custom-base64-encoded-uefi-data}}" ` -WindowsConfiguration_ImageIndex {{1}} ``` 匯入完成後，您的映像會出現在您擁有的映像清單中。如需詳細資訊，請參閱[列出影像](image-details-list.md#list-images)。 ------ ## 從輸出 AMI 啟動執行個體 您現在可以使用輸出 AMI 做為一般 AMI，並從中啟動執行個體。當您從輸出 AMI 啟動執行個體時，Windows 作業系統會執行 Sysprep Specialize 來完成執行個體組態。 **注意** 本頁所述的網路需求僅適用於匯入建置程序。匯入成功完成後，從輸出 AMI 啟動執行個體會遵循標準 Amazon EC2 網路需求。成功匯入並不保證成功啟動執行個體，您的啟動仍可能會根據您的網路組態失敗。 ## 私有 VPC 的最低網路需求 **必要的 VPC 端點：** | Endpoint | Type | 用途 | | --- | --- | --- | | com.amazonaws.{{{region}}}.s3 | 閘道 | 存取 Amazon S3 儲存貯體 (EC2Launch v2、SSM Agent、您的 ISO；如果在 中也是驅動程式us-east-1) | | com.amazonaws.{{{region}}}.ec2 | 介面 | 建立快照並描述磁碟區 | | com.amazonaws.{{{region}}}.logs | 介面 | 將建置日誌寫入 CloudWatch Logs | | com.amazonaws.{{{region}}}.ssm | 介面 | SSM API 呼叫 (SendCommand、DescribeInstanceInformation) | | com.amazonaws.{{{region}}}.ssmmessages | 介面 | SSM Agent 資料通道 （接收命令、傳送輸出） | | com.amazonaws.{{{region}}}.ec2messages | 介面 | SSM 代理程式訊息輪詢 | **外部區域的其他需求`us-east-1`：** | 資源 | 用途 | | --- | --- | | NAT 閘道 | 提供網際網路存取，以便從 下載驅動程式ec2-windows-drivers-downloads.s3.amazonaws.com。如果沒有這樣做，匯入程序將會失敗。 | **匯入期間存取的 Amazon S3 端點：** + `https://ec2-windows-drivers-downloads.s3.amazonaws.com/NVMe/Latest/AWSNVMe.zip` + `https://ec2-windows-drivers-downloads.s3.amazonaws.com/ENA/Latest/AwsEnaNetworkDriver.zip` + `https://ec2-windows-drivers-downloads.s3.amazonaws.com/AWSPCISerialDriver/Latest/AWSPCISerialDriver.zip` + `https://ec2-windows-drivers-downloads.s3.amazonaws.com/EC2WinUtil/Latest/EC2WinUtil.zip` + `https://amazon-ec2launch-v2-{{{region}}}.s3.dualstack.{{{region}}}.amazonaws.com/windows/amd64/latest/AmazonEC2Launch.msi` + `https://amazon-ssm-{{{region}}}.s3.{{{region}}}.amazonaws.com/latest/windows_amd64/AmazonSSMAgentSetup.exe` 這表示匯入在私有子網路中操作所需的最低組態。根據您的 VPC 設定和所需結果，您可能需要額外的網路組態，以允許建置執行個體和 VPC 端點之間的流量。 ## 後續步驟 您可以像任何其他 AMI 一樣使用輸出 AMI – 直接從中啟動執行個體，或在 Image Builder 中將其用作基礎映像，以進一步建置和自訂。如需詳細資訊，請參閱[使用映像建置器建立自訂映像](create-images.md)。 ## 對 ISO 磁碟映像匯入進行故障診斷 如果您的 ISO 磁碟映像匯入失敗，您可以使用 Amazon CloudWatch Logs 來識別匯入錯誤的位置。Image Builder 會在建置完成後，將建置日誌串流至 CloudWatch Logs。若要尋找匯入的日誌，請使用下列日誌群組和串流，將 {{ImageName}} 取代為您提供映像的名稱： **LogGroup：** `/aws/imagebuilder/{{ImageName}}` **LogStream：** `{{ImageVersion}}/{{ImageBuildVersion}}` 如需 CloudWatch Logs 中映像建置器日誌的詳細資訊，請參閱[使用 Amazon CloudWatch Logs 監控映像建置器日誌](monitor-cwlogs.md)。如需其他故障診斷指引，請參閱 [疑難排解映像建置器問題](troubleshooting.md)。