产品文档
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
查看 PDF

为 亚马逊 WorkSpaces Core 托管实例创建预备映像

July 9, 2026
投稿者: 
C C

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

关键步骤

  1. 创建映像的定义以及最初的映像版本。
  2. 从初始映像版本创建映像版本。

使用 Web Studio 管理控制台

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

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

  1. 在 Web Studio 中，导航到“映像”节点，然后单击“创建映像定义”。在“简介”页面上单击“下一步”。
  2. 在“映像定义”页面上，指定映像定义的“操作系统类型”和“会话类型”。

  3. 在“映像”页面上，选择“资源”（仅列出适用于所设置连接的资源）、一个用作创建映像版本模板的主映像，以及一个用于捕获硬件属性的计算机配置文件。选择一个计算机配置文件以从 VM 实例或启动模板版本捕获硬件属性。

    注意：

    • 在选择映像之前，请验证主映像是否已安装 VDA 2311 或更高版本并且 VDA 上已安装 MCSIO 驱动程序。
    • 实例元数据服务 (IMDS) V2 仅受支持，IMDS V1 不受支持。有关信息，请参阅 实例元数据服务版本 2 的工作原理。
  4. 在“计算机规格”页面上，选择计算机大小。默认选择计算机配置文件（在“映像”页面上选择）的计算机大小。
  5. 在“NIC”页面上，为准备映像选择或添加 NIC。对于每个 NIC，选择一个关联的 VPC 子网。
  6. 在“版本描述”页面上，输入所创建的初始映像版本的描述。
  7. 在“摘要”页面上，检查映像定义和所创建的初始映像版本的详细信息。输入映像定义的名称和描述。单击“完成”。

创建映像版本

映像版本提供了管理特定映像的不同迭代或更新的能力。此功能使得您能够针对不同的用途维护映像的多个版本。

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

注意：

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

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

注意：

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

使用 PowerShell 命令行工具

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

  1. 使用 Test-ProvImageDefinitionNameAvailable command 检查可用的映像定义名称。例如，

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
<!--NeedCopy-->

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

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

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

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

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

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

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

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

    注意：

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

  6. 使用 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 托管实例在同一 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 账户共享。

重要注意事项

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

先决条件

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

  • 您的环境必须是亚马逊 WorkSpaces Core 托管实例环境。
  • 您必须在同一个 AWS 账户下配置多个托管单元（每个单元可以绑定到不同的可用区）和主机连接（每个连接可以绑定到不同的区域）。

使用 Web Studio UI 界面进行配置

您可以使用 Web Studio UI 在绑定到不同托管单元的可用区之间共享准备好的映像。

共享准备好的映像

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

取消共享准备好的映像

  1. 在 Web Studio 的 映像 节点上，选择您要取消共享的准备好的映像版本。
  2. 在顶部导航栏中选择 管理映像共享 以管理所选映像版本的映像共享。

  3. 清除与您希望停止共享映像版本的一个或多个资源（可用区）相关的复选框。

    注意：

    资源不得再与共享映像版本关联，也不得从共享映像版本创建任何目录。任何要删除的、从共享映像版本创建的目录都必须首先删除。

  4. 单击 保存 以取消在已清除的可用区之间共享资源。映像版本将更新，使其不再在这些可用区中共享。

使用 PowerShell 命令行工具进行配置

此外，您可以使用 PowerShell 命令在与不同托管单元关联的可用区之间共享准备好的映像。

共享准备好的映像

  1. 确保您拥有要共享的准备好的映像的 ImageVersionSpecUid。您可以使用 PowerShell 中的 Get-ProvImageVersionSpec 或类似的 Get- 命令检索此信息。
  2. 确定要使准备好的映像可用的可用区（可以是相同或不同的区域）的 HostingUnitName。这是您为该特定可用区配置的托管单元的名称。

  3. 运行 Add-ProvImageVersionSpecHostingUnit 命令： 使用以下 PowerShell 命令。将 <ImageVersionSpecUid> 替换为映像的 Uid，将 <targetHostingUnitName> 替换为目标可用区中要共享映像版本规范的托管单元的名称：

    Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->
  4. 成功执行后，您可以在 Web Studio UI 中看到映像的状态，表明您已将其与指定的托管单元共享。

取消共享准备好的映像

  1. 确保您拥有要取消共享的准备好的映像的 ImageVersionSpecUid。
  2. 确定要从中删除共享映像的可用区的 HostingUnitName。

  3. 运行 Remove-ProvImageVersionSpecHostingUnit 命令： 使用以下 PowerShell 命令。将 <ImageVersionSpecUid> 替换为映像的 Uid，将 <targetHostingUnitName> 替换为目标可用区中要取消共享映像版本规范的托管单元的名称：

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
<!--NeedCopy-->

后续步骤

更多信息

为 亚马逊 WorkSpaces Core 托管实例创建预备映像
July 9, 2026
投稿者: 
C C
July 9, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.