产品文档

Citrix Virtual Apps and Desktops

查看 PDF

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

April 8, 2026

投稿者:

C C

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

主要步骤

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

使用 Web Studio

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

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

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

创建映像版本

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

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

注意：

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

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

注意：

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

使用 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

```

创建映像定义、映像版本和准备好的映像版本规范的完整 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 托管实例在同一 AWS 区域或不同区域中，跨不同可用区（与不同托管单元关联）共享单个准备好的映像。这使您可以使用一个准备好的映像在各种可用区和区域中创建和更新 MCS 计算机目录。当跨不同区域中的不同可用区共享时，准备好的映像版本将从原始区域复制到目标区域。

您可以维护单个准备好的映像，并使用它在与不同托管单元关联的多个可用区和区域中创建和更新计算机目录。这显著降低了映像管理开销，确保了跨部署的一致性，并简化了预配过程。您还可以使用来自不同可用区或区域的准备好的映像无缝更新现有计算机目录。

用例

集中式映像管理： 您在一个可用区（例如，us-east-1a）中创建准备好的映像。然后，您可以将此映像共享到同一 us-east-1 AWS 区域中的其他可用区（例如，us-east-1b）或不同 us-west-1 区域中的 us-west-1a。这允许单个映像服务于多个托管单元，并为您简化了维护。
高效的目录创建和更新： 您可以使用在 AZ 1（例如，us-east-1a）中创建的准备好的映像在 AZ 1 中创建新目录。将此映像共享到 AZ 2（例如，us-east-1b）后，您可以在 AZ 2 中使用共享映像在 AZ 2 中创建和更新目录。
跨托管单元和托管连接部署： 如果您的环境在相同或不同的 AWS 区域和 AWS 账户下有多个托管单元，则可以在这些托管单元之间高效地共享准备好的映像。

限制

在同一 AWS 账户中共享： 在当前实施中，您无法跨不同的 AWS 账户共享。

重要注意事项

删除顺序： 要删除原始准备好的映像版本规范，您必须首先删除其所有共享映像版本规范。或者，您必须同时删除原始规范和共享规范。
映像版本依赖性： 当您删除映像版本时，必须首先删除依赖于该特定映像版本的任何共享配置。您从原始（未共享）映像创建的目录可以保持不变。
目录向后兼容性： 您可以更新在此功能推出之前部署的现有计算机目录。使用您在与最初部署目录的可用区或区域不同的可用区或区域中创建的准备好的映像。
完全删除： 当您删除准备好的映像时，您将无法再在您共享或最初创建它的任何可用区中使用它。此外，在删除所有与准备好的映像版本关联的目录之前，无法删除准备好的映像版本。

先决条件

在配置或使用此功能之前，请确保满足以下条件：

您的环境必须是 Amazon WorkSpaces Core 托管实例环境。
您必须在同一个 AWS 账户下配置多个托管单元（每个托管单元可以与不同的可用区关联）和主机连接（每个主机连接可以与不同的区域关联）。

使用 Web Studio UI 进行配置

您可以使用 Web Studio UI 跨与不同托管单元关联的可用区共享准备好的映像。

共享准备好的映像

导航到 Web Studio 的“映像”节点，然后选择要与其他可用区共享的准备好的映像版本。
在顶部导航栏中选择“管理映像共享”以管理所选映像版本的映像共享。
在“管理映像共享”页面上，选择一个或多个要共享映像版本的资源。这些资源可以位于与原始映像版本不同的可用区中。
单击“保存”以在其他可用区中的资源中共享映像版本。映像版本将更新，以便在您选择的不同资源之间共享。完成后，使用映像版本在共享映像版本的可用区中创建目录。

删除准备好的映像的共享

在 Web Studio 的“映像”节点上，选择要取消共享的准备好的映像版本。
在顶部导航栏中选择“管理映像共享”以管理所选映像版本的映像共享。
清除要停止共享映像版本的一个或多个资源（可用区）的复选框。

注意：

这些资源不得再有任何与共享映像版本关联并从中创建的目录。必须首先删除从要删除的共享映像版本创建的任何目录。
单击“保存”以取消共享已清除可用区中的资源。映像版本将更新，以便不再在这些可用区中共享。

使用 PowerShell 进行配置

或者，您可以使用 PowerShell 命令跨与不同托管单元关联的可用区共享准备好的映像。

共享准备好的映像

确保您拥有要共享的准备好的映像的 ImageVersionSpecUid。您可以使用 Get-ProvImageVersionSpec 或 PowerShell 中类似的 Get- 命令检索此信息。
确定要使准备好的映像可用的可用区（可以是相同或不同区域）的 HostingUnitName。这是您为该特定可用区配置的托管单元的名称。
运行 Add-ProvImageVersionSpecHostingUnit 命令： 使用以下 PowerShell 命令。将 <ImageVersionSpecUid> 替换为映像的 Uid，将 <targetHostingUnitName> 替换为要共享映像版本规范的目标可用区中的托管单元的名称：
```
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

```
成功执行后，您可以在 Web Studio UI 中看到映像的状态，指示您已将其与指定的托管单元共享。

删除准备好的映像的共享

确保您拥有要取消共享的准备好的映像的 ImageVersionSpecUid。
确定要从中删除共享映像的可用区的 HostingUnitName。
运行 Remove-ProvImageVersionSpecHostingUnit 命令： 使用以下 PowerShell 命令。将 <ImageVersionSpecUid> 替换为映像的 Uid，将 <targetHostingUnitName> 替换为要从中删除映像版本规范共享的目标可用区中的托管单元的名称：
```
Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>

```

后续步骤

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

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

主要步骤

使用 Web Studio

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

创建映像版本

使用 PowerShell

跨可用区和区域共享准备好的映像

用例

限制

重要注意事项

先决条件

使用 Web Studio UI 进行配置

共享准备好的映像

删除准备好的映像的共享

使用 PowerShell 进行配置

共享准备好的映像

删除准备好的映像的共享

后续步骤

更多信息

在本文中