本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 映像生成器故障排除
<a name="troubleshooting-image-builder"></a>

以下是您在使用 Amazon WorkSpaces 应用程序映像生成器时可能出现的问题。

**Topics**
+ [我无法从我的映像生成器连接到 Internet。](#troubleshooting-01)
+ [当我尝试安装应用程序时，出现一个错误，指示操作系统版本不受支持。](#troubleshooting-02)
+ [我想使用 Windows PowerShell 脚本来打开我的应用程序。](#use-powershell-launch-application)
+ [我想向用户提供 ClickOnce 应用程序。](#clickonce-applications)
+ [当我连接到映像生成器时，出现一个登录屏幕，要求我按 Ctrl\$1Alt\$1Delete 以登录。但我的本地计算机截获了键盘输入。](#troubleshooting-03)
+ [当我在管理员模式和测试模式之间切换时，我发现需要输入密码。我不知道如何获取密码。](#troubleshooting-04)
+ [我在添加已安装的应用程序时收到错误。](#troubleshooting-05)
+ [在映像生成器中意外退出后台服务并且断开连接。我现在无法连接到该映像生成器。](#troubleshooting-06)
+ [应用程序无法在测试模式下启动。](#troubleshooting-07)
+ [应用程序无法连接到 VPC 中的网络资源。](#troubleshooting-08)
+ [我自定义了我的映像生成器桌面，但在从我创建的映像启动实例集后，在连接到会话时我的更改不可用。](#troubleshooting-09)
+ [我的应用程序在启动时缺少命令行参数。](#troubleshooting-10)
+ [在安装防病毒应用程序后，我无法将映像与实例集结合使用。](#troubleshooting-11)
+ [我的映像创建失败。](#troubleshooting-12)
+ [Image Assistant `create-image` 操作失败，并显示一条错误消息，提示访问 PrewarmManifest .txt 被拒绝](#create-image-cli-operation-fails)

## 我无法从我的映像生成器连接到 Internet。
<a name="troubleshooting-01"></a>

默认情况下，映像生成器无法与 Internet 进行通信。要解决此问题，请在可访问 Internet 的 VPC 子网中启动您的映像生成器。您可以从使用 [NAT 网关](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html)的 VPC 子网启用 Internet 访问权。或者，您可以在您的 VPC 中配置互联网网关，然后将弹性 IP 地址附加到映像生成器。有关更多信息，请参阅 [Amazon WorkSpaces 应用程序的联网和访问](managing-network.md)。

## 当我尝试安装应用程序时，出现一个错误，指示操作系统版本不受支持。
<a name="troubleshooting-02"></a>

只有可以安装在 Windows Server 2016、Windows Server 2019、Windows Server 2022 和 Windows Server 2025 上的应用程序才能添加到 WorkSpaces 应用程序映像中。检查其中一个操作系统是否支持您的应用程序（视您的映像生成器而定）。

## 我想使用 Windows PowerShell 脚本来打开我的应用程序。
<a name="use-powershell-launch-application"></a>

您可以使用 Windows PowerShell 脚本在队列实例中打开应用程序。您可能希望在应用程序打开之前执行此操作来配置应用程序或环境。要为您的应用程序启动 Windows PowerShell 脚本，请在图像助手中指定 PowerShell .exe 文件。导航到 `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`，并指定以下启动参数：

-file “C:\$1Path\$1To\$1PowerShell\$1 Script.ps1"

**注意**  
要允许指定的脚本打开应用程序，必须覆盖 PowerShell 脚本执行策略。为此，请将 **-ExecutionPolicy Bypass** 添加到启动参数中。

## 我想向用户提供 ClickOnce 应用程序。
<a name="clickonce-applications"></a>

要向 ClickOnce 应用程序用户提供 WorkSpaces 应用程序，必须先以管理员身份在映像生成器上安装该应用程序，然后以模板用户身份安装该应用程序。由于 ClickOnce 应用程序需要特定于用户的安装，因此您必须以模板用户身份安装应用程序，以便用户能够从队列实例启动应用程序。要以管理员身份和模板用户身份安装 ClickOnce 应用程序，请执行以下步骤。

1. 在[https://console.aws.amazon.com/appstream2/家](https://console.aws.amazon.com/appstream2/home)中打开 WorkSpaces 应用程序控制台。

1. 在左侧导航窗格中，依次选择**映像**和**映像生成器**。

1. 在列表中，选择要使用的映像生成器，然后以管理员身份登录。

1. 在用户配置文件中创建调用 `appref-ms` 文件的批处理文件。使用 %APPDATA% 环境变量来替换 C:\$1Users\$1username\$1\$1 AppData Roaming。以下是示例批处理文件调用：

   ```
   explorer "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Company\ClickOnce.appref-ms"
   ```

1. 在映像生成器桌面上，打开 Image Assistant。

1. 在 **Configure Apps (配置应用程序)** 页面上，选择 **Switch user (切换用户)**。

1. 在 **Local User (本地用户)** 选项卡上，选择 **Template User (模板用户)**。

1. 以模板用户身份登录后，再次安装该应用程序。

1. 在映像生成器桌面上，打开 Image Assistant。

1. 在 “**配置应用程序**” 页面上，打开 ClickOnce 应用程序以验证其是否正常运行。完成测试后，选择 **Switch user (切换用户)**。

1. 以管理员身份重新登录，并在 Image Assistant 中执行所需步骤以完成映像的创建。

## 当我连接到映像生成器时，出现一个登录屏幕，要求我按 Ctrl\$1Alt\$1Delete 以登录。但我的本地计算机截获了键盘输入。
<a name="troubleshooting-03"></a>

您的客户端可能会在本地截获特定的组合键，而不是将其发送到映像生成器会话。要以可靠的方式将 Ctrl\$1Alt\$1Delete 组合键发送到映像生成器，请依次选择 **Admin Commands (管理员命令)** 和 **Send Ctrl\$1Alt\$1Delete (发送 Ctrl\$1Alt\$1Delete)**。映像生成器会话工具栏的右上角将显示 **Admin Commands** 菜单。

## 当我在管理员模式和测试模式之间切换时，我发现需要输入密码。我不知道如何获取密码。
<a name="troubleshooting-04"></a>

WorkSpaces 应用程序通常会将您登录到您自动选择的用户模式。在某些情况下，可能无法自动执行切换。如果要求输入密码，请依次选择 **Admin Commands** 和 **Log me in**。这将以安全方式将一次性密码发送到映像生成器，并将该密码粘贴到 **Password** 字段中。

## 我在添加已安装的应用程序时收到错误。
<a name="troubleshooting-05"></a>

检查您的应用程序类型是否受支持。您可以添加 `.exe`、`.lnk` 和 `.bat` 类型的应用程序。

检查您的应用程序是否安装在 `C:\Users` 文件夹层次结构下。任何安装在 `C:\Users` 下的应用程序均不受支持。安装应用程序时，请选择 `C:\` 下的其他安装文件夹。

## 在映像生成器中意外退出后台服务并且断开连接。我现在无法连接到该映像生成器。
<a name="troubleshooting-06"></a>

尝试停止映像生成器，重新启动它并再次与之连接。如果问题仍然存在，您必须启动 (创建) 新的映像生成器。请不要停止映像生成器实例上正在运行的任何后台服务。这样做可能会中断您的映像生成器会话或干扰映像创建。

## 应用程序无法在测试模式下启动。
<a name="troubleshooting-07"></a>

检查您的应用程序是需要提升的用户权限还是需要通常仅提供给管理员的任何特殊权限。Image Builder 测试模式对映像生成器实例的有限权限与最终用户在 WorkSpaces 应用程序测试队列上的权限相同。如果您的应用程序需要提升的权限，它们不会在“Image Builder Test (映像生成器测试)”模式中启动。

## 应用程序无法连接到 VPC 中的网络资源。
<a name="troubleshooting-08"></a>

检查映像生成器是否已在正确的 VPC 子网中启动。您可能还需要验证您的 VPC 中的路由表是否配置为允许连接。

## 我自定义了我的映像生成器桌面，但在从我创建的映像启动实例集后，在连接到会话时我的更改不可用。
<a name="troubleshooting-09"></a>

在创建映像时，不会保留作为本地用户会话一部分保存的更改，例如时间设置。要保留任何本地用户会话更改，可将其添加到映像生成器实例上的本地组策略。

## 我的应用程序在启动时缺少命令行参数。
<a name="troubleshooting-10"></a>

您可以在使用映像生成器向映像添加应用程序时提供命令行参数。如果应用程序的启动参数不会针对每个用户发生更改，则您可以在将应用程序添加到映像生成器实例中的映像时输入这些参数。

如果每次启动时的启动参数不同，您可在使用 `CreateStreamingURL` API 时以编程方式传递这些参数。在 API 字段中设置 `sessionContext` 和 `applicationID` 参数。在启动应用程序时，sessionContext 作为命令行选项包含。

如果必须实时计算启动参数，您可以使用脚本启动应用程序。在使用计算的参数启动应用程序之前，您可以在脚本中分析 `sessionContext` 参数。

## 在安装防病毒应用程序后，我无法将映像与实例集结合使用。
<a name="troubleshooting-11"></a>

在创建映像之前，您可以使用映像生成器在 WorkSpaces 应用程序堆栈上安装任何工具，包括防病毒程序。但是，这些程序不应阻塞任何网络端口或停止 WorkSpaces 应用程序服务使用的任何进程。建议您先在“Image Builder Test (映像生成器测试)”模式中测试应用程序，然后再创建映像并尝试将其与实例集结合使用。

## 我的映像创建失败。
<a name="troubleshooting-12"></a>

在开始创建映像之前，请确认您没有对 WorkSpaces 应用程序服务进行任何更改。重新尝试创建映像；如果失败，请联系 AWS 支持。有关更多信息，请参阅 [AWS 支持 中心](https://console.aws.amazon.com/support/home#/)。

## Image Assistant `create-image` 操作失败，并显示一条错误消息，提示访问 PrewarmManifest .txt 被拒绝
<a name="create-image-cli-operation-fails"></a>

应用程序优化清单是使用提升的权限创建的。要创建映像，请执行以下任一操作，然后重试：
+ 使用管理员权限运行 Image Assistant 命令行界面 (CLI) 可执行文件 (Image-Assistant.exe)。
+ 删除应用程序优化清单文件。