本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 管理您的 Amazon WorkSpaces 应用程序图片
可用图像列在 WorkSpaces 应用程序控制台的**映像注册表**中，并按可见性进行分类，如下所示：
+ **公开**-由所有和提供的基础映像 AWS。基础映像包括最新的 Windows 操作系统和 WorkSpaces 应用程序代理软件。您可以使用基本映像来创建包含自己的应用程序的新映像。有关发布的基本映像的信息 AWS，请参阅[WorkSpaces 应用程序基础映像和托管映像更新发行说明](base-image-version-history.md)。
+ **私有** — 由您创建和拥有且未与其他 AWS 账户共享的图片。
+ **与他人共享** — 您创建和拥有的图片，以及您与同一 AWS 地区的一个或多个 AWS 账户共享的图片。当您与其他 AWS 账户共享图像时，您可以指定该映像是可用于映像生成器（创建新映像）、用于队列，还是两者兼而有之。
+ **与我共享** — 由同一 AWS 地区的另一个 AWS 账户创建和拥有并与您的 AWS 账户共享的图片。根据所有者在与您的账户共享映像时提供的权限，您可将此映像用于映像生成器、实例集或两者。
**Topics**
+ [在 Amazon WorkSpaces 应用程序中删除私有镜像](delete-private-image.md)
+ [在 Amazon WorkSpaces 应用程序中将您拥有的图像复制到其他 AWS 区域](copy-image-different-region.md)
+ [在 Amazon WorkSpaces 应用程序中与其他 AWS 账户共享您拥有的图片](share-image-with-another-account.md)
+ [停止在 Amazon WorkSpaces 应用程序中共享您拥有的图片](stop-sharing-image-with-all-accounts.md)
+ [保留您的 Amazon WorkSpaces 应用程序图片 Up-to-Date](keep-image-updated.md)
+ [亚马逊 WorkSpaces 应用程序上的 Windows 更新和防病毒软件](windows-update-antivirus-software.md)
+ [以编程方式在 Amazon WorkSpaces 应用程序中创建新映像](create-image-programmatically.md)
+ [在 Amazon 应用程序中管理您的图片上包含许可的 WorkSpaces 应用程序](license-included-applications.md)
+ [导入图片](import-image.md)
+ [导出图片](export-image.md)
# 在 Amazon WorkSpaces 应用程序中删除私有镜像
当您不再需要私有映像时，可将其删除。您无法删除舰队使用或与其他 AWS 账号共享的图片。要删除实例集使用或已共享的映像，您必须先从所有实例集中删除映像并删除所有映像共享权限。删除映像后无法恢复。
**删除私有映像**
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在导航窗格中，选择 **Images** (映像) 和 **Image Registry** (映像注册表)。
1. 在映像列表中，选择要删除的私有映像。
1. 选择**操作**、**删除**，然后再次选择**删除**。
将从映像注册表中移除并实际删除该映像。
# 在 Amazon WorkSpaces 应用程序中将您拥有的图像复制到其他 AWS 区域
**重要**
对于亚太地区（马来西亚）、欧洲（米兰）、欧洲（西班牙）和以色列（特拉维夫）AWS 区域：仅支持 WorkSpaces 应用代理版本为 2025 年 on/after 10 月 2 日发布的图像或使用 2025 年 on/after 9 月 5 日发布的托管更新的图像进行跨区域镜像复制。旧版本不符合在区域间复制的条件。更新您的图像以满足这些最低版本要求，从而启用跨区域复制功能。
您可以将自己拥有的图像复制到另一个 AWS 区域。在不同 AWS 区域使用相同的映像可以帮助简化应用程序在 WorkSpaces 应用程序上的全球部署。通过将应用程序部署在地理位置最接近用户的地 AWS 区，您可以帮助为用户提供响应速度更快的体验。
**将您拥有的图像复制到另一个 AWS 区域**
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在导航窗格中，选择 **Images** (映像) 和 **Image Registry** (映像注册表)。
1. 在图像列表中，选择要复制到其他 AWS 区域的图像。
1. 选择 **Actions** (操作) 和 **Copy** (复制)。
1. 在**复制图像**对话框的**目标区域**中，选择要将图像复制到的 AWS 区域。
1. 在 **Destination region (目标区域)** 中为映像键入一个唯一名称和说明（可选）。
1. 选择 **Copy Image (复制映像)**。
# 在 Amazon WorkSpaces 应用程序中与其他 AWS 账户共享您拥有的图片
WorkSpaces 应用程序镜像是一种区域资源，因此您可以与同一 AWS 区域内的其他 AWS 账户共享您拥有的映像。这样做在许多情况下都很有用。例如，如果您使用不同的 AWS 账户将开发资源和生产资源分开，则可以使用开发账户创建映像。然后，您可以与您的生产账户共享该映像。如果贵组织是独立软件供应商 (ISV)，则可与您的客户共享优化的映像。已安装和配置所需应用程序的优化映像让您的客户能够快速开始使用应用程序，无需自己安装和配置这些应用程序。
当您与其他 AWS 账户共享镜像时，您可以指定目标账号是可以使用队列中的镜像，还是可以通过创建镜像生成器来创建新镜像。您将继续拥有您共享的映像。这样，您可以根据需要为共享映像添加、更改或删除权限。
如果您与一个账户共享映像并向该账户授予实例集权限，则共享映像可用于创建或更新该账户中的实例集。如果您之后删除这些权限，该账户将无法再使用该映像。对于账户中使用共享映像的实例集，将所需容量设置为 0，这样可防止创建新实例集实例。现有会话将继续，直到流式传输会话结束。对于要创建的新实例集实例，必须用有效映像更新该账户中的实例集。
如果您与一个账户共享映像并向该账户授予映像生成器权限，则共享映像可用于在该账户中创建映像生成器和映像。如果您之后删除这些权限，映像生成器和从您的映像中创建的映像将不受影响。
**重要**
与账户共享映像后，您无法控制映像生成器或该账户中基于您的映像创建的映像。因此，仅当您希望允许该账户创建映像副本并在您停止共享映像后保留副本访问权限的情况下，才向该账户授予映像生成器权限。
**与其他 AWS 账号共享您拥有的图片**
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在导航窗格中，选择 **Images** (映像) 和 **Image Registry** (映像注册表)。
1. 在映像列表中，选择要共享的映像。
1. 依次选择 **Actions (操作)**、**Share (共享)**。
1. 在 **Share image (共享映像)** 对话框中，选择 **Add account (添加账户)**。
1. 键入您要与之共享图片的账户的 12 位数 AWS 账户 ID，然后选择该账户是否可以执行以下一项或两项操作：
+ 使用映像来启动映像生成器（如果您要创建新映像）。
+ 将映像用于实例集。
要从账户列表中删除已与之共享映像的账户，请在要删除的账户对应的行中，选择 **Use for fleet (用于实例集)** 选项右边的 X 图标。
1. 要与更多 AWS 账户共享图片，请对要与之共享图片的每个账户重复步骤 6。
1. 选择 **Share Image (共享映像)**。
**添加或更新您拥有的映像的映像共享权限**
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在导航窗格中，选择 **Images** (映像) 和 **Image Registry** (映像注册表)。
1. 在映像列表中，选择要更改其权限的映像。
1. 在映像列表下方，针对您选择的映像选择 **Permissions (权限)** 选项卡，然后选择 **Edit (编辑)**。
1. 在 “**编辑图像权限**” 对话框中，根据需要为一个或多个 AWS 账户选择或清除以下一个或两个图像共享选项。如果您针对一个账户清除全部两个选项，将不再与该账户共享映像。
+ 使用映像来启动映像生成器（如果您要创建新映像）。
+ 将映像用于实例集。
要从账户列表中删除已与之共享映像的账户，请在要删除的账户对应的行中，选择 **Use for fleet (用于实例集)** 选项右边的 X 图标。
1. 要编辑更多 AWS 账户的图像共享权限，请对要更新权限的每个账户重复步骤 5。
1. 选择 **Update image sharing permissions (更新映像共享权限)**。
# 停止在 Amazon WorkSpaces 应用程序中共享您拥有的图片
请按照以下步骤停止与任何其他 AWS 账户共享您拥有的图片。
**停止与任何其他 AWS 账号共享您拥有的图片**
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在导航窗格中，选择 **Images** (映像) 和 **Image Registry** (映像注册表)。
1. 在映像列表中，选择要更改其权限的映像。
1. 在映像列表下方，针对您选择的映像选择 **Permissions (权限)** 选项卡，然后选择 **Edit (编辑)**。
1. 在 “**编辑图像权限**” 对话框中，在与之共享图像的所有 AWS 账户所在的行中，选择 “**用于队列**” 选项右侧的 X 图标。
1. 选择 **Update image sharing permissions (更新映像共享权限)**。
# 保留您的 Amazon WorkSpaces 应用程序图片 Up-to-Date
您可以通过执行以下任一操作 up-to-date来保留 WorkSpaces 应用程序映像：
+ [使用托管 WorkSpaces 应用程序图像更新更新映像](keep-image-updated-managed-image-updates.md)— 此更新方法提供最新的操作系统更新和驱动程序更新，以及最新的 WorkSpaces 应用程序代理软件。
+ [使用托管 WorkSpaces 应用程序代理版本更新 WorkSpaces 应用程序代理软件](keep-image-updated-manage-image-versions.md)— 此更新方法提供最新的 WorkSpaces 应用程序代理软件。
# 使用托管 WorkSpaces 应用程序图像更新更新映像
WorkSpaces Applications 提供了一种自动更新映像的方法，包括最新的操作系统更新、许可证中包含的应用程序更新、驱动程序更新和 WorkSpaces 应用程序代理软件。通过托管 WorkSpaces 应用程序映像更新，您可以选择要更新的映像。 WorkSpaces 应用程序在同一个 AWS 账户和区域中创建映像生成器来安装更新并创建新映像。创建新映像后，您可以在预生产队列上对其进行测试，然后再更新生产队列或与其他 AWS 账户共享映像。
**注意**
托管 WorkSpaces 应用程序映像更新适用于微软 Windows 服务器、红帽企业 Linux 和 Rocky Linux 操作系统。
**注意**
创建新映像后，您负责维护操作系统的更新。为此，您可以继续使用托管 WorkSpaces 应用程序映像更新。
您负责维护 Amazon EC2 Windows 半虚拟化 (PV) 驱动程序、ENA 驱动程序和 AWS NVMe 驱动程序的更新。有关如何更新驱动程序的更多信息，请参阅[管理 EC2 实例的设备驱动程序](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/manage-device-drivers.html)。
您还负责维护应用程序及其依赖项。要添加其他应用程序、更新现有应用程序或更改映像设置，您必须启动并重新连接到您创建映像时所用的映像生成器。或者，如果已删除该映像生成器，请启动基于您的映像的新映像生成器。然后，进行更改并创建新映像。
## 先决条件
以下是使用托管的映像更新的先决条件和注意事项。
+ 确保您的 WorkSpaces 应用程序账户配额（也称为限制）足以支持创建新的映像生成器和新映像。要申请增加配额，你可以使用 Service Quotas 控制台，网址为[https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/)。有关默认 WorkSpaces 应用程序配额的信息，请参阅[亚马逊 WorkSpaces 应用程序服务配额](limits.md)。
+ 您必须拥有所更新的映像。您无法更新与您共享的映像。
+ 当 WorkSpaces 应用程序创建映像生成器来安装最新的操作系统更新、驱动程序更新和 WorkSpaces 应用程序代理软件并创建新映像时，您需要为映像生成器实例的更新付费。
+ 支持的映像必须使用在 2017-07-24T00:00:00Z 或更高版本上发布的基本映像创建。
+ 支持英语和日语两种显示语言。有关更多信息，请参阅 [指定默认显示语言](configure-default-display-language.md)。
+ 使用最新版本的 SSM 代理。有关版本信息，请参阅 [WorkSpaces 应用程序基础映像和托管映像更新发行说明](base-image-version-history.md)。有关安装信息，请参阅[在适用于 Windows Server 的 EC2 实例上手动安装 SSM 代理](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html)。
## 如何使用托管 WorkSpaces 应用程序图像更新来更新映像
要使用最新的补丁、驱动程序更新和 WorkSpaces 应用程序代理软件更新应用程序映像，请执行以下步骤。 WorkSpaces
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在导航窗格中，选择 **Images** (映像) 和 **Image Registry** (映像注册表)。
1. 在映像列表中，选择要更新的映像。验证映像的状态是否为**可用**。
1. 选择**操作**、**更新**。
1. 在**更新映像**对话框中，执行以下操作：
+ 在 “**新图像名称**” 中，输入一个在 AWS 账户和区域中唯一的图像名称。图片名称不能以 “Amazon”、“”AWS或 “” 开头AppStream。
+ 在**新映像显示名称**中，您可以选择输入要为映像显示的名称。
+ 在**新映像描述**中，您可以选择提供对映像的描述。
+ 在**标签**中，您可以选择**添加标签**，然后键入标签的键和值。要添加更多标签，请重复此步骤。有关更多信息，请参阅 [标记您的 Amazon WorkSpaces 应用程序资源](tagging-basic.md)。
1. 选择**更新映像**。
如果您当前的映像已经是最新的，则会有一条消息通知您。
1. 在导航窗格中，依次选择**映像**和**映像生成器**。
1. 在映像生成器列表中，验证是否有新的映像生成器处于**正在更新**状态。该映像生成器的名称包含一个随机的 10 位数后缀。
该映像生成器是您在步骤 5 中为新映像选择的实例系列中尺寸最小的一个。未指定子网，因为映像生成器未连接到您的虚拟私有云（VPC）。
1. 选择**映像注册表**，验证您的新映像是否出现在列表中。
创建映像时，控制台的映像注册表中的映像状态将显示为**正在创建**。
1. 创建映像后， WorkSpaces 应用程序将执行鉴定流程，以验证映像是否按预期运行。
在此期间，该映像生成器（也用于此流程）将显示在**映像生成器**列表中，其状态为**等待资格认证**。
1. 成功完成资格认证流程后，控制台顶部会显示**成功**消息，并且映像注册表中该映像的状态显示为**可用**。
此外， WorkSpaces 应用程序创建的映像生成器会自动删除。
**注意**
根据操作系统更新的数量，映像更新可能需要几个小时才能完成。如果某个问题导致无法更新映像，则映像名称旁边会出现一个带有感叹号的红色图标，并且映像注册表中该映像的状态显示为**失败**。如果出现这种情况，请选择该映像，选择**通知**选项卡，然后查看所有错误通知。有关更多信息，请参阅文档的[映像内部服务](troubleshooting-notification-codes.md#troubleshooting-notification-codes-image)部分中有关通知代码故障排除的信息。
如果认证过程不成功， WorkSpaces 应用程序创建的映像生成器仍会自动删除。
1. WorkSpaces Applications 创建新映像后，在预生产队列上测试映像。在确认应用程序按预期工作后，使用新映像更新生产实例集。
# 使用托管 WorkSpaces 应用程序代理版本更新 WorkSpaces 应用程序代理软件
WorkSpaces Applications 提供了一种使用更新的 WorkSpaces 应用程序代理软件自动更新映像生成器的方法。这样一来，您可以在发布新版本的代理时创建新映像。之后，您可以在更新生产实例集之前测试该映像。有关如何管理 WorkSpaces 应用程序代理软件的更多信息，请参阅[管理 WorkSpaces 应用程序代理版本](base-images-agent.md)。
**注意**
您负责安装和维护 Windows 操作系统、应用程序及其依赖项的更新。
要使用最新的 Windows 操作系统更新来更新 WorkSpaces 应用程序映像，请执行以下任一操作：
+ 每次发布新映像时，都会在最新的基本映像上安装应用程序。
+ 在现有映像生成器上安装 Windows 操作系统、应用程序及其依赖项的更新。
+ 在现有映像生成器上安装来自现有映像的 Windows 操作系统、应用程序及其依赖项的更新。
使用最新的 Windows 操作系统、应用程序及其依赖项以及 WorkSpaces 应用程序代理软件创建新映像后，请在开发队列上测试该映像。在确认应用程序按预期工作后，使用新映像更新生产实例集。
# 亚马逊 WorkSpaces 应用程序上的 Windows 更新和防病毒软件
WorkSpaces 应用程序流式处理实例是非永久性的。当用户流式传输会话结束时，A WorkSpaces pplications 会终止该会话使用的实例，并根据您的扩展策略，在队列中预置一个新实例来替换该实例。所有实例集实例均从同一映像预配置。由于映像一旦创建便无法更改，因此用户流式传输会话中使用的所有实例集实例仅具有在创建映像时已安装在基础映像上的 Windows 和应用程序更新。此外，由于用于流式传输会话的实例集实例在会话结束时终止，因此在流式传输会话期间对 Windows 或对该实例上的应用程序所做的任何更新将不会由同一用户或其他用户保留到以后的会话中。
**注意**
如果您为堆栈启用了应用程序设置持久性， WorkSpaces 则如果这些配置更改存储在用户的 Windows 配置文件中，则应用程序将保留 Windows 和用户对未来会话所做的应用程序配置更改。但是，应用程序设置持久性功能仅保留 Windows 和应用程序配置设置。它不会在流实例上保留对 Windows 或应用程序的软件更新。
出于这些原因， WorkSpaces 应用程序对 WorkSpaces 应用程序实例上的 Windows 更新和防病毒软件采用以下方法。
## Windows 更新
默认情况下， WorkSpaces 应用程序基础映像上未启用 Windows 更新。如果您在映像生成器上启用 Windows 更新，然后尝试创建映像，则 Image Assistant 将显示警告并在映像创建过程中禁用 Windows 更新。为确保您的实例集实例安装了最新的 Windows 更新，我们建议您在映像生成器上安装 Windows 更新，创建新映像，并定期使用新映像更新实例集。
## 杀毒软件
如果您选择在映像上安装杀毒软件，则建议您不要为杀毒软件启用自动更新。否则，杀毒软件可能会在用户会话期间尝试使用最新的定义文件或其他更新来进行自身更新。这可能会影响性能。此外，对杀毒软件所做的任何更新将不会在当前用户会话之后继续存在。为了确保您的实例集实例始终具有最新的杀毒更新，我们建议您执行以下任一操作：
+ 更新映像生成器并定期创建新映像（例如，通过使用 [Image Assistant CLI](https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html) 操作）。
+ 使用将扫描或其他操作委托给 always-up-to-date外部服务器的防病毒应用程序。
**注意**
即使您没有为杀毒软件启用自动更新，杀毒软件也可能执行硬盘扫描或其他操作，这些操作可能会在用户会话期间影响您的实例集实例的性能。
在 2019 年 9 月 10 日当天或之后发布的 WorkSpaces 应用程序 Windows Server 2022/2019/2016 基础映像上，Windows Defender 默认处于未启用状态。在 2019 年 6 月 24 日发布的 WorkSpaces 应用程序 Windows Server 2016 和 Windows Server 2019 基础映像上，Windows Defender 默认处于启用状态。
**手动启用 Windows Defender**
如果未对您的基本映像启用 Windows Defender，您可以手动启用它。为此，请完成以下步骤。
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在左侧导航窗格中，依次选择**映像**和**映像生成器**。
1. 选择要在其上启用 Windows Defender 的映像生成器，验证它是否处于 **Running (正在运行)** 状态，然后选择 **Connect (连接)**。
1. 使用本地**管理员**账户或具有本地管理员权限的域账户登录到映像生成器。
1. 打开注册表编辑器。
1. 导航到注册表中的以下位置：**HKLM\$1 SOFTWARE\$1 Policies\$1 Microsoft\$1 Windows Defender\$1**。DisableAntiSpyware
1. 要编辑此注册表项，请双击或右键单击该注册表项，然后选择 **Modify (修改)**。
1. 在 **Edit DWORD (32-bit) Value (编辑 DWORD (32 位) 值)** 对话框的 **Value data (值数据)** 中，将 **1** 更改为 **0**。
1. 选择**确定**。
1. 关闭注册表编辑器。
1. 打开 Microsoft 管理控制台 (MMC) **Services (服务)** 管理单元 (`services.msc`)。
1. 在服务列表中，执行以下任一操作。
如果你使用的是微软 Windows Server 2022/2025，请执行以下任一操作：
+ 右键单击 **Microsoft Defender 防病毒服务**，然后选择**启动**。
+ 双击 **Microsoft Defender 防病毒服务**，在属性对话框中选择**启动**，然后选择**确定**。
如果您使用的是 Microsoft Windows Server 2019 或 2016，请执行以下任一操作：
+ 右键单击 **Windows Defender Antivirus Service (Windows Defender 防病毒服务)**，然后选择 **Start (启动)**。
+ 双击 **Windows Defender Antivirus Service (Windows Defender 防病毒服务)**，在属性对话框中选择 **Start (启动)**，然后选择 **OK (确定)**。
1. 关闭 **Services (服务)** 管理单元。
# 以编程方式在 Amazon WorkSpaces 应用程序中创建新映像
您可以通过连接到映像生成器并使用 Image Assistant 命令行界面 (CLI) 操作，以编程方式创建 WorkSpaces 应用程序映像。有关更多信息，请参阅 [使用镜像助手 CLI 操作以编程方式创建您的 Amazon WorkSpaces 应用程序映像](programmatically-create-image.md)。
# 在 Amazon 应用程序中管理您的图片上包含许可的 WorkSpaces 应用程序
你可以使用应用程序流式传输以下 Microsoft 许可附带的 WorkSpaces 应用程序。您可以在 Windows 映像上安装这些应用程序，使用此自定义映像创建实例集，然后流式传输这些应用程序。以下所有应用程序均支持 32 位和 64 位架构：
+ 微软 Office LTSC 专业版 Plus 2021/2024
+ 微软 Visio LTSC 专业版 2021/2024
+ 微软 Project 专业版 2021/2024
+ 微软 Office LTSC 标准 2021/2024
+ 微软 Visio LTSC 标准 2021/2024
+ 2021/2024 年微软 Project 标准
**重要**
Microsoft Office、Visio 和 Project 必须遵循相同的版本。例如，您不能将 2021 应用程序与 2024 应用程序混合使用。
Microsoft Office、Visio 和 Project 必须遵循相同的架构。例如，您不能将 32 位应用程序与 64 位应用程序混合使用。
微软 Windows Server 2022 和 2025 支持微软 Office、Visio 和 Project 2021 Standard/Professional versions are supported on Microsoft Windows Server 2019/2022/2025. Microsoft Office, Visio, and Project 2024 Standard/Professional 版本。
要启用此功能，必须使用使用 2025 年 10 月 2 日当 WorkSpaces 天或之后发布的 WorkSpaces 应用代理的 Applications Image Builder。有关更多信息，请参阅 [管理 WorkSpaces 应用程序代理版本](base-images-agent.md)。或者，您的映像必须使用 2025 年 10 月 3 日当天或之后发布的托管 WorkSpaces 应用程序映像更新。有关更多信息，请参阅 [保留您的 Amazon WorkSpaces 应用程序图片 Up-to-Date](keep-image-updated.md)。
出站 TCP 端口 1688 在所有流式传输实例的管理网络接口上必须处于打开状态。
所有通过由具有一个或多个许可应用程序的映像提供支持的实例集进行流式传输的用户都需要按月为这些应用程序付费，无论使用情况如何。应用程序授权功能不限制特定用户的访问权限。
Image Builder 上随附许可证的应用程序未激活，因为它们是出于管理目的而安装的。当用户通过实例集实例流式传输时，这些应用程序便会激活。
**Topics**
+ [在映像上查看已安装随附许可证的应用程序列表](view-list-image.md)
+ [在映像生成器上查看随附许可证的应用程序列表](view-list-apps.md)
+ [安装或卸载随附许可证的应用程序](install-uninstall-apps.md)
+ [在映像生成器上为随附许可证的应用程序启用更新功能](updates-image-builder.md)
+ [在映像生成器上使用 PowerShell 为随附许可证的应用程序启用更新功能](enable-updates-managed-powershell.md)
+ [在映像生成器上使用托管映像更新为随附许可证的应用程序启用更新功能](enable-updates-managed.md)
# 在映像上查看已安装随附许可证的应用程序列表
**在映像上查看已安装随附许可证的应用程序列表**
要在映像上查看已安装随附许可证的应用程序列表，请按照以下步骤操作。
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在左侧导航窗格中选择**映像**，然后选择**映像注册表**选项卡。
1. 选择一个映像，然后选择**查看详细信息**。
1. 在**随附许可证的应用程序**下查看所有已安装应用程序的列表。
# 在映像生成器上查看随附许可证的应用程序列表
**在映像生成器上查看随附许可证的应用程序列表**
要在映像生成器上查看随附许可证的应用程序列表，请按照以下步骤操作。
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在左侧导航窗格中选择**映像**，然后选择**映像生成器**选项卡。
1. 选择一个映像生成器，然后选择**查看详细信息**。
1. 在**随附许可证的应用程序**下查看应用程序及其状态列表。
# 安装或卸载随附许可证的应用程序
**安装或卸载随附许可证的应用程序**
要在映像上安装或卸载一个或多个随附许可证的应用程序，请按照以下步骤操作。
1. 完成下列选项之一：
+ 启动映像生成器并配置随附许可证的应用程序。有关更多信息，请参阅 [启动映像生成器来安装和配置流应用程序](tutorial-image-builder-create.md)。
+ 在映像生成器上管理随附许可证的应用程序。有关更多信息，请参阅 [使用第三方 SAML 2.0 身份提供商的基于属性的应用程序授权](application-entitlements-saml.md)。
1. 如果您拥有使用一个或多个随附许可证的应用程序创建的映像，可以使用此映像来创建实例集。连接到该实例集的用户可以访问这些应用程序。
**重要**
所有通过由具有一个或多个许可应用程序的映像提供支持的实例集进行流式传输的用户都需要按月为这些应用程序付费，无论使用情况如何。应用程序授权功能不限制特定用户的访问权限。
如果您在安装或卸载随附许可证的应用程序期间遇到故障，您将在 Image Builder 的详细信息页面上看到故障状态。要解决这些问题，我们建议您连接到 Image Builder 并启用详细日志记录功能。有关更多信息，请参阅 [How to enable Microsoft 365 Apps for enterprise logging](https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/diagnostic-logs/how-to-enable-office-365-proplus-uls-logging)。如果在查看日志并进行故障排除后问题仍然存在，请联系 AWS 支持 寻求帮助。
# 在映像生成器上为随附许可证的应用程序启用更新功能
**在映像生成器上为随附许可证的应用程序启用更新功能**
默认情况下，系统会禁用所有随附许可证的应用程序的更新功能。您可以使用包含其中一个或多个应用程序的映像在映像生成器上为这些应用程序启用更新功能。实例集实例的更新功能处于禁用状态，以防止在会话设置期间进行安装。
您可以通过三个选项在映像生成器上为随附许可证的应用程序启用更新功能。
要在映像生成器上使用应用程序菜单为随附许可证的应用程序启用更新功能，请按照以下步骤操作。
1. 打开任意随附许可证的应用程序。
1. 依次选择**文件**、**账户**、**更新选项**和**启用更新**。
# 在映像生成器上使用 PowerShell 为随附许可证的应用程序启用更新功能
要在映像生成器上使用 PowerShell 为随附许可证的应用程序启用更新功能，请按照以下步骤操作。
+ 以管理员身份运行以下命令： PowerShell
`Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Office\ClickToRun\Configuration" -Name UpdatesEnabled -Value True `
# 在映像生成器上使用托管映像更新为随附许可证的应用程序启用更新功能
要在映像生成器上使用托管映像更新为随附许可证的应用程序启用更新功能，请按照以下步骤操作。
+ 使用托管映像更新接收随附 Microsoft 许可证的应用程序的更新。有关更多信息，请参阅
[使用托管 WorkSpaces 应用程序图像更新更新映像](keep-image-updated-managed-image-updates.md).
# 导入图片
您可以通过导入自定义镜像来创建 WorkSpaces 应用程序镜像 EC2 AMIs。下面将介绍操作方式：
1. 使用任何首选方法（包括 Im [EC2 age Builder](https://docs.aws.amazon.com/imagebuilder/)）自定义您的 EC2 AMI。
1. 将您的自定义 AMI 导入 WorkSpaces 应用程序以创建 WorkSpaces 应用程序映像
1. 或者，也可以使用 Image Builder 进行其他图像自定义
通过 AMI 导入创建的图像为`type = "custom"`，而 WorkSpaces 应用程序提供的图像则为`type = "native"`。
您可以将 stream.\$1 实例类型用于映像。`type = "native"`要使用以下任一实例类型，您必须导入您的 AMI 并使用创建映像`type = "custom"`。
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ 加速。 \$1
## 图像导入的先决条件
所有这些先决条件对于成功执行工作流程都很重要。下面列出了支持的 AMI 配置和其他强制性要求。
### 必需的 AMI 属性
EBS
+ 小于或等于 500GB 的大小
+ 您可以导入容量小于 200 GB 的 AMI，但是，导入的映像将至少使用 200GB。
+ GP2
+ 您可以导入具有 gp2 或 gp3 EBS 卷类型的 AMI，但是，导入的映像将使用 gp2。
+ 每张图像一卷
+ `/dev/sda1`根设备名称
+ 图像类型：机器
+ 架构：x86\$164
+ 虚拟化类型：HVM
+ 启动模式：UEFI
+ TPM Support：v2.0。这是必需的，请参阅-[https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/amiwindows-tpm.html\$1 查找启用 TPM ami-windows-tpm-find](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find) 的 AMI。
+ ENA Support：没错
+ 平台：Windows
+ 平台详情：Windows
### 操作系统属性
**Windows Server 2022/2025 全基版**
+ 不支持 Windows 服务器**核心**
+ 不支持带有 SQL Server 的 Windows
座席
+ EC2 启动 V2 版本 >= 2.1.1
+ 需要 SSM 代理
驱动程序
+ EC2 ENA 驱动程序版本 >= 2.9.0
+ EC2 NVMe 驱动程序版本 >= 1.6.0
图书馆 Support
+ .NET 框架 4.8 或更高版本
+ 默认安装在 Windows Server 2022/2025 中
+ PowerShell 5.1 或更高版本
+ 默认安装在 Windows Server 2022/2025 中
+ Windows 功能：不得安装远程桌面服务许可和远程桌面服务会话主机
+ 端口：端口 8000、8300 和 8443 必须处于解锁状态且未被占用
+ 启动模式：UEFI
如果你想将图像用于图形实例，例如加速.g4dn、accelated.g5、Accelated.G6 或加速.g6e，则需要在你的 AMI 上安装适当的 GRID 驱动程序。欲了解更多详情，请参阅 [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html)。如果驱动程序设置不正确，则可以进行流式传输，但是，显卡可能不可用。
**重要**
AMI 的 “所有者账户 ID” 必须是您的AWS账户 ID。您无法导入公有 EC2 AMI。
在导入图像之前，请执行任何 Windows 更新并禁用 Windows 自动更新。
目前 EC2 AMIs 不支持加密导入
### IAM 角色要求
**重要**
“创建具有以下权限的 IAM 角色以用于图像导入：
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowModifyImageAttributeWithTagCondition",
"Effect": "Allow",
"Action": "ec2:ModifyImageAttribute",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
}
]
}
```
为此 IAM 角色添加以下信任关系
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## 导入图像
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在左侧导航窗格中，选择 “**图像**”，然后选择 “**图像注册表**”。
1. 选择 “**导入图像**”。
1. **AMI ID**-输入要导入到 WorkSpaces 应用程序的 AMI ID。您也可以使用此字段搜索您的 AMI。
1. **图像名称**-为因导入操作而创建的图像输入唯一名称。
1. **显示名称***（可选）*-输入要为图像显示的。
1. **描述***（可选）*-输入图像的描述。
1. **IAM 角色**-选择您为映像导入创建的 IAM 角色。有关更多详细信息，请参阅[IAM 角色要求](#iam-role-requirements)。
1. **管理 WorkSpaces 应用程序代理**-如果您想始终使用最新的 WorkSpaces 应用程序代理版本，请选择此选项，您的流式处理实例将自动使用新代理版本发布AWS时提供的最新功能、性能改进和安全更新进行更新。
1. **运行时验证***（可选）*：选择此选项，服务将使用正在导入的图像预配置实例并运行流式测试。
+
**注意**
这些流式传输测试将在后台执行，您无法通过 WorkSpaces 应用程序客户端连接到此实例。
+ 我们建议您使用此选项来更确信您的图像适用于 WorkSpaces 应用程序。
+ 您将按该实例的小时价格计费。
+ 如果您在进行可能不会影响流式传输测试的细微更改后重新导入 AMI，并且如果上次通过运行时验证，则您导入了此 AMI，则可以避免运行时验证。
+ **选择实例类型***（可选）*：为运行流式测试选择正确的实例系列、类型和大小。建议您使用计划用于创建队列的相同实例。
1. **应用程序目录和启动性能清单***（可选）*：提供详细信息，以便为最终用户创建应用程序目录并提高应用程序的启动性能。
+ **应用程序目录**：要创建应用程序目录，请指定有关安装您的映像的应用程序的详细信息。对于您计划流式传输的每个应用程序，可以指定名称、显示名称、要启动的可执行文件和要显示的图标。
+ **启动性能**：向应用程序优化清单中添加文件可缩短应用程序在新队列实例上首次启动所需的时间。优化清单是每个应用程序的行分隔文本文件。
要了解更多信息，请参阅[应用程序详情](applications-details.md)。
1. **标签***（可选）*-选择 “**添加标签**”，然后键入标签的键和值。要添加更多标签，请重复此步骤。有关更多信息，请参阅 [标记您的 Amazon WorkSpaces 应用程序资源](tagging-basic.md)。
1. **导入图像**-查看您输入的所有信息，然后选择**导入图像**。服务将运行兼容性检查，以确保 AMI 与 WorkSpaces 应用程序兼容。
+ 如果静态检查失败，您将立即收到错误消息。
+ 如果静态检查通过，则您的导入请求将被提交，根据您选择的选项，创建新的 WorkSpaces 应用程序映像可能需要 30-60 分钟 `type = "custom"`
# 应用程序详情
应用程序详细信息包含有关预热清单和应用程序目录配置的信息。
## 应用程序 PreWarm 清单
在创建 WorkSpaces 应用程序映像时，您可以指定要向用户提供的应用程序。要加快应用程序的启动时间，您可以准备一份 PreWarm 清单。这本质上是用户启动应用程序时应用程序需要启动的文件目录。在实例配置期间，将在会话连接之前准备好这些文件，以加快用户会话中的应用程序启动时间。
在将预热清单导入应用程序环境之前，必须在 AMI 上预先创建。 WorkSpaces 您可以选择创建一个通用 Prewarm 清单文件，也可以为每个应用程序创建一个清单文件。这会改变您以后导入 AMI 的方式。
### 常见预热清单
对于您要预热的每个应用程序，请启动该应用程序并执行用户可能执行的任何初始交互。然后，使用以下命令瞄准存储应用程序数据的目录。
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
这会将针对每个应用程序进行优化的文件追加到公共`C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt`文件中。无需执行其他操作即可执行应用程序预热。 WorkSpaces 应用程序将在上述位置查找预热文件，如果存在则使用它。
此过程是可选的，随着预热清单大小的增加，队列配置时间也将增加。因此，请注意在优化和队列配置之间取得平衡。
### 特定于应用程序的清单
在图像导入期间，您可能希望为每个应用程序指定单独的应用程序清单文件，以便更轻松地跟踪每个应用程序的预热资产。为此，请执行与上述相同的步骤，但不要创建公用`C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt`文件，而是在您的 AMI 上为每个应用程序创建一个文件。
对于您要预热的每个应用程序，请启动该应用程序并执行用户可能执行的任何初始交互。然后，使用以下命令瞄准存储应用程序数据的目录。
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\PreWarm.txt" -encoding UTF8 -append
```
我们将在图像导入过程中使用这些应用程序预热文件。再说一遍，这是完全可选的。你可以选择使用此方法、Common Prewarm Manifest 方法，或者根本不使用预热清单。
## 应用程序目录配置
`AppCatalogConfig`它允许您在 AMI 导入期间指定要注册到 WorkSpaces 应用程序映像的应用程序。`AppCatalogConfig`是以下结构的应用程序配置对象的 JSON 列表。
```
[
{
"Name": "Rufus", //Required and must be unique among the list of applications
"DisplayName": "Rufus",
"AbsoluteAppPath": "Rufus", //Required
"AbsoluteIconPath": "Rufus",
"AbsoluteManifestPath": "Rufus",
"WorkingDirectory": "Rufus",
"LaunchParameters": "Rufus"
}
...
// Up to 50 applications total
]
```
每个应用程序的唯一必填字段是`Name`和`AbsoluteAppPath`。每个字段的详细信息如下：
姓名 [**必填**]
+ 给定名称供您的应用程序进行标识
+ 介于 1 到 100 个字符之间
+ 允许的字符正则表达式 `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ 在给定内容中必须是唯一的 AppCatalogConfig
DisplayName
+ 要向用户显示的给定应用程序的显示名称
+ 介于 0 到 100 个字符之间
+ 允许的字符正则表达式 `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`
AbsoluteAppPath [**必填**]
+ 用于启动应用程序的可执行文件的路径
+ 这是用户选择您的应用程序时将启动的可执行文件
+ 介于 1 到 32767 个字符之间
+ 此字符长度上限是为了支持 Windows 中的扩展文件路径。如果使用大于 260 个字符的文件路径，请确保您的 AMI 和应用程序已正确配置为支持 Windows 扩展文件路径。
+ 使用转义后的文件路径字符串，例如
+ `"C:\\Windows\\System32\\notepad.exe"`
AbsoluteManifestPath
+ 仅在您使用时适用 [特定于应用程序的清单](#application-specific-manifests)
+ 此应用程序的预热清单文件路径
+ 介于 0 到 32767 个字符之间
+ 此字符长度上限是为了支持 Windows 中的扩展文件路径。如果使用大于 260 个字符的文件路径，请确保您的 AMI 和应用程序已正确配置为支持 Windows 扩展文件路径。
+ 使用转义后的文件路径字符串，例如
+ `"C:\\Path\\To\\PrewarmManifest.txt"`
AbsoluteIconPath
+ AMI 上用于应用程序的图标文件的路径。
+ 流式传输到此图像时，将向用户显示此图标。
+ 如果未提供任何图标，则该图标将从可执行文件本身派生。
+ 请注意选择具有适当处理背景透明度的图标文件，以便为用户提供良好的客户体验
+ 使用 PNG 图片
+ 介于 1 到 32767 个字符之间
+ 此字符长度上限是为了支持 Windows 中的扩展文件路径。如果使用大于 260 个字符的文件路径，请确保您的 AMI 和应用程序已正确配置为支持 Windows 扩展文件路径。
+ 使用转义后的文件路径字符串，例如
+ `"C:\\Path\\To\\ApplicationIcon.png"`
WorkingDirectory
+ 用于启动应用程序的工作目录
+ 介于 0 到 32767 个字符之间
+ 此字符长度上限是为了支持 Windows 中的扩展文件路径。如果使用大于 260 个字符的文件路径，请确保您的 AMI 和应用程序已正确配置为支持 Windows 扩展文件路径。
+ 使用转义后的文件路径字符串，例如
+ `"C:\\Path\\To\\Working\\Directory"`
LaunchParameters
+ 用作中指定的可执行文件的启动参数的字符串 `AbsoluteAppPath`
+ 介于 0 到 1024 个字符之间
+ 使用带有所需启动参数完整列表的转义字符串，例如以下示例，该示例展示了如何使用 PowerShell 脚本作为应用程序，方法是将 PowerShell 可执行文件用作应用程序，并在启动参数中提供了脚本
+ AbsoluteAppPath
+ `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
+ LaunchParameters
+ `"-File \"C:\\Path\\To\\App\\Script.ps1\""`
### 样本 AppCatalogConfig
这是 Notepad、Google Chrome 和 Mozilla Firefox 的简短示例 AppCatalogConfig
```
[
{
"Name": "Notepad",
"DisplayName": "Notepad",
"AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
},
{
"Name": "Chrome",
"DisplayName": "Chrome",
"AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
"LaunchParameters": "https://www.amazon.com/"
},
{
"Name": "Firefox",
"DisplayName": "Firefox",
"AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
"LaunchParameters": "https://aws.amazon.com/"
}
]
```
# 导出图片
您可以导出要创建的图像 EC2 AMIs。稍后你可以 AMIs 返回[导入图片](import-image.md)这些镜像来创建 WorkSpaces 应用程序镜像。这可以帮助您使用自己的 AMI 自定义工具对图像进行自定义。
**注意**
在导出过程中，将从您的图像中移除以下组件
WorkSpaces 应用程序代理
微软许可证包括使用 Image Builder 添加的应用程序
只能导出微软 Windows Server 2022 和 2025 年映像。
## IAM 角色要求
**重要**
创建具有以下权限的 IAM 角色以用于导出导入：
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowCopyImage",
"Effect": "Allow",
"Action": "ec2:CopyImage",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
},
{
"Sid": "AllowCreateTags",
"Effect": "Allow",
"Action": "ec2:CreateTags",
"Resource": "*"
}
]
}
```
为此 IAM 角色添加以下信任关系
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## 导出映像
1. 在 [https://console.aws.amazon.com/appst WorkSpaces ](https://console.aws.amazon.com/appstream2) ream2 上打开应用程序控制台。
1. 在导航窗格中，选择 **Images** (映像) 和 **Image Registry** (映像注册表)。
1. 在镜像列表中，选择要导出的私有镜像。
1. 选择 “**操作**”、“**导出**”。
1. 在**导出映像**对话框中，键入 AMI 的唯一 **AMI 名称****和可选的 AMI 描述**。
1. **IAM 角色**-选择您为映像导出创建的 IAM 角色。
1. 选中 “在**导出中复制标签” 复选框，您可以选择将标签从图像复制**到 AMI。
1. 选择 “**导出图像**”。