本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 故障診斷映像建置器
<a name="troubleshooting-image-builder"></a>

以下是使用 Amazon WorkSpaces 應用程式映像建置器時可能發生的問題。

**Topics**
+ [我無法從映像建置器連線到網際網路。](#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)
+ [映像助理 `create-image` 操作失敗，並出現存取 PrewarmManifest.txt 遭拒的錯誤訊息](#create-image-cli-operation-fails)

## 我無法從映像建置器連線到網際網路。
<a name="troubleshooting-01"></a>

根據預設，映像建置器無法與網際網路通訊。若要解決此問題，請在具備網際網路存取的 VPC 子網路中啟動您的映像建置器。您可以使用 [NAT 閘道](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html)從您的 VPC 子網路啟用網際網路存取。或者，您可以在 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\$1Script.ps1"

**注意**  
若要允許指定的指令碼開啟應用程式，您必須覆寫 PowerShell 指令碼執行政策。若要執行此作業，請將 **-ExecutionPolicy Bypass** 新增到啟動參數。

## 我想要將 ClickOnce 應用程式開放給使用者使用。
<a name="clickonce-applications"></a>

若要讓您的 WorkSpaces 應用程式使用者使用 ClickOnce 應用程式，您必須先以管理員身分在映像建置器上安裝應用程式，然後再以範本使用者身分安裝應用程式。因為 ClickOnce 應用程式需要使用者專屬的安裝，您必須以範本使用者身分安裝您的應用程式，才能讓使用者從機群執行個體啟動應用程式。若要以管理員身分安裝 ClickOnce 應用程式，再以範本使用者身分進行安裝，請執行這些步驟。

1. 在 https：//[https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home) 開啟 WorkSpaces 應用程式主控台。

1. 在左側導覽窗格中，選擇 **Images (映像)**、**Image Builder (映像建置器)**。

1. 在清單中，選取您希望使用的映像建置器，然後以管理員身分登入它。

1. 建立批次檔案，在使用者描述檔中呼叫 `appref-ms` 檔案。使用 %APPDATA% 環境變數取代 C:\$1Users\$1username\$1AppData\$1Roaming。以下是範例批次檔案呼叫：

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

1. 在映像建置器桌面上開啟映像助理。

1. 在 **Configure Apps (設定應用程式)** 頁面上，選擇 **Switch user (切換使用者)**。

1. 在 **Local User (本機使用者)** 標籤中，選擇 **Template User (範本使用者)**。

1. 在您以範本使用者身分登入後，請再次安裝應用程式。

1. 在映像建置器桌面上開啟映像助理。

1. 在 **Configure Apps (設定應用程式)** 頁面上，開啟 ClickOnce 應用程式來驗證其已正常運作。在完成測試後，選擇 **Switch user (切換使用者)**。

1. 以管理員身分重新登入，然後在映像助理中執行必要步驟來完成建立您的映像。

## 當我連線到映像建置器時，我看到一個登入畫面，要求我輸入 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>

請檢查您的應用程式是否需要提升的使用者權限或任何通常只有管理員才具備的特殊許可。映像建置器測試模式對映像建置器執行個體具有與最終使用者在 WorkSpaces 應用程式測試機群上相同的有限許可。若您的應用程式需要提升的許可，他們便無法在映像建置器測試模式中啟動。

## 應用程式無法連線到我 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 應用程式服務使用的任何程序。我們建議您在建立映像並嘗試搭配機群使用該映像之前，先在映像建置器測試模式中測試您的應用程式。

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

在開始建立映像之前，請確認您未對 WorkSpaces 應用程式服務進行任何變更。再次嘗試建立您的映像。若仍失敗，請聯絡 AWS 支援。如需詳細資訊，請參閱 [AWS 支援 中心](https://console.aws.amazon.com/support/home#/)。

## 映像助理 `create-image` 操作失敗，並出現存取 PrewarmManifest.txt 遭拒的錯誤訊息
<a name="create-image-cli-operation-fails"></a>

已使用更高的權限建立應用程式最佳化資訊清單。若要建立映像，請執行下列任一項動作，然後再試一次：
+ 使用管理員權限執行映像助理命令列界面 (CLI) 可執行檔 (Image-Assistant.exe)。
+ 刪除應用程式最佳化資訊清單檔案。