为 Amazon WorkSpaces Core 托管实例创建准备好的映像

September 12, 2025

投稿者:

创建准备好的映像以创建 MCS 计算机目录。您可以使用以下方式创建准备好的映像：

Studio
PowerShell 命令

关键步骤

创建映像定义和初始映像版本。
从初始映像版本创建映像版本。

使用 Studio

创建映像定义和初始映像版本

要创建映像定义和初始映像版本，请执行以下操作：

在 Studio 中，转到“映像”节点，然后单击“创建映像定义”。在“简介”页面上单击“下一步”。
在“映像定义”页面上，为映像定义指定“操作系统类型”和“会话类型”。
在“映像”页面上，选择“资源”（仅列出适用于所设置连接的资源）、用作创建映像版本模板的主映像，以及用于捕获硬件属性的计算机配置文件。选择一个计算机配置文件以从 VM 实例或启动模板版本捕获硬件属性。
注意：
- 在选择映像之前，请验证主映像是否已安装 VDA 2311 或更高版本，并且 VDA 上已安装 MCSIO 驱动程序。
- 仅支持实例元数据服务 (IMDS) V2，不支持 IMDS V1。有关信息，请参阅实例元数据服务版本 2 的工作原理。
在“计算机规范”页面上，选择计算机大小。默认情况下，将选择计算机配置文件（在“映像”页面上选择）的计算机大小。
在“NIC”页面上，为准备映像选择或添加 NIC。对于每个 NIC，选择关联的 VPC 子网。
在“版本描述”页面上，输入所创建的初始映像版本的描述。
在“摘要”页面上，检查映像定义和所创建的初始映像版本的详细信息。输入映像定义的名称和描述。单击“完成”。

创建映像版本

映像版本允许管理特定映像的不同迭代或更新。此功能使您能够为不同目的维护映像的多个版本。

要从初始映像版本创建映像版本，请执行以下操作：

注意：

所有映像版本的托管单元必须相同。

转到“映像”节点，选择一个映像版本或映像定义，然后单击“创建映像版本”。
在“映像定义”页面上，可以更改托管单元，并重新选择该映像版本的主映像和计算机配置文件。
如果希望映像版本的配置与初始配置的映像版本不同，请在“创建映像版本”对话框的“计算机规范”和“NIC”页面上配置设置。
添加映像版本的描述。单击“完成”。

注意：

如果映像版本创建因任何原因失败，底部的“故障排除”选项卡将提供“重试”选项。

使用 PowerShell

创建准备好的映像版本规范的详细 PowerShell 命令如下：

使用 Test-ProvImageDefinitionNameAvailable 命令检查可用的映像定义名称。例如：
```
Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>

```

使用 New-ProvImageDefinition 命令创建映像定义。例如：

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
<!--NeedCopy-->

使用 Add-ProvImageDefinitionConnection 命令在指定的托管连接中为映像定义创建新配置。

Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn
<!--NeedCopy-->

使用 New-ProvImageVersion 命令创建映像版本。例如：

New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
<!--NeedCopy-->

使用 Add-ProvImageVersionSpec 命令将主映像版本规范添加到映像版本。例如：

Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName wsc-MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”"
<!--NeedCopy-->

注意：

对于一个托管单元，您只能向一个映像版本添加一个主映像版本规范。

使用 New-ProvImageVersionSpec 命令从主映像版本规范创建准备好的映像版本规范。SourceImageVersionSpecUid 参数派生自 Add-ProvImageVersionSpec 命令。例如：

New-ProvImageVersionSpec
-SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
-MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously
<!--NeedCopy-->

创建映像定义、映像版本和准备好的映像版本规范的完整 PowerShell 命令示例：

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
 
 
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName wsc-CustomProperties $CustomProperties
 
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
 
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”
 
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName wsc
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid
<!--NeedCopy-->

注意：

映像定义中的所有映像版本规范必须属于同一托管单元。

一个映像版本只能有一个主映像版本规范和一个准备好的映像版本规范。

所有映像版本规范都必须具有计算机配置文件。

后续步骤

有关创建 Amazon WorkSpaces Core 托管实例目录的信息，请参阅创建 Amazon WorkSpaces Core 托管实例目录