

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

# 對 WorkSpaces 應用程式使用者問題進行故障診斷
<a name="troubleshooting-user-issues"></a>

## 啟用進階記錄
<a name="troubleshooting-advanced-logging"></a>

為了協助疑難排解使用者可能遇到的問題，您可以在任何 WorkSpaces 應用程式用戶端上啟用進階記錄。進階記錄會產生包含診斷資訊和偵錯層級詳細資料 (包括詳細效能資料) 的日誌。

**注意**  
若要 AWS 檢閱進階日誌檔案，並接收 WorkSpaces 應用程式用戶端問題的技術支援，請聯絡 支援。如需更多資訊，請參閱[AWS Support Center Console](https://console.aws.amazon.com/support/home#/)。

### 啟用 Web 存取的進階記錄
<a name="troubleshooting-advanced-logging-web"></a>

如果使用者使用 SAML、使用者集區或可存取 Application Catalogue 頁面，請遵循下列步驟：

1. 載入目錄頁面。

1. 開啟**開發人員工具**，然後選擇**主控台**索引標籤。

1. 在瀏覽器主控台中，輸入 **window.siteConfig.logLevel = "INFO"** ，然後選擇**輸入**。

1. 啟動應用程式，您應該會在**主控台**索引標籤上看到**記錄**。

1. 重現問題。

1. 在**主控台**索引標籤上按一下滑鼠右鍵，然後選擇**將所有訊息儲存至檔案**。

### 啟用 Windows 用戶端的進階記錄
<a name="troubleshooting-advanced-logging-windows"></a>

若要啟用 Windows 用戶端的進階記錄，請遵循下列步驟：

1. 在用戶端電腦上，前往 `%localappdata%\AppStreamClient\app-<versionID>`。

1. 在記事本`Log4Net.config`中開啟 。

1. 將日誌記錄的根層級從 **INFO** 變更為 **DEBUG**。

1. 儲存檔案。

1. 重新啟動 WorkSpaces 應用程式用戶端，然後再次嘗試連線。

1. 壓縮完整的資料夾`C:\Users\%USERNAME%\AppData\Local\Amazon\AppStreamClient\'`，從 收集日誌。

以下是使用者使用 WorkSpaces 應用程式時可能發生的特定問題。

**Topics**
+ [啟用進階記錄](#troubleshooting-advanced-logging)
+ [我使用者的 WorkSpaces 應用程式用戶端安裝失敗，他們收到一則訊息，指出需要 .NET Framework 4.6。](#troubleshooting-client-no-internet-net-framework-462-fails)
+ [使用者的 USB 驅動程式安裝在安裝 WorkSpaces 應用程式用戶端時失敗，現在他們無法將其 USB 裝置與 WorkSpaces 應用程式搭配使用。](#troubleshooting-client-no-internet-usb-driver-install-fails)
+ [我的 WorkSpaces 應用程式用戶端使用者每 60 分鐘就會與其 WorkSpaces 應用程式工作階段中斷連線。](#troubleshooting-client-users-disconnected-every-60-minutes)
+ [我的使用者無法在他們的本機裝置和串流工作階段之間複製和貼上。](#copy-paste-doesnt-work)
+ [在串流工作階段期間，使用者可能會無法使用某些鍵盤快速鍵。](#keyboard-shortcuts-dont-work)
+ [我的使用者繪圖板無法使用我部署的串流應用程式。](#troubleshooting-client-users-drawing-tablets-not-working)
+ [我的使用者在串流工作階段期間無法使用日文輸入法](#japanese-language-input-method-doesnt-work-for-users)
+ [我的使用者嘗試從應用程式目錄啟動應用程式時，出現有關已達串流工作階段數量上限的錯誤。](#troubleshooting-max-sessions)
+ [我的使用者看到黑色螢幕或桌面，且其應用程式未在彈性機群上啟動。沒有顯示任何錯誤。](#troubleshooting-black-screen)

## 我使用者的 WorkSpaces 應用程式用戶端安裝失敗，他們收到一則訊息，指出需要 .NET Framework 4.6。
<a name="troubleshooting-client-no-internet-net-framework-462-fails"></a>

當使用者安裝 WorkSpaces 應用程式用戶端時，如果尚未安裝該版本或更新版本，WorkSpaces 應用程式也會安裝 .NET Framework 4.6.2 版。如果要安裝用戶端的電腦未連線至網際網路，則無法安裝 .NET Framework。在這種情況下會出現一則訊息，提示使用者手動安裝 .NET Framework 4.6 版。但是，當使用者選擇 **Install (安裝)** 時會顯示錯誤訊息，表示安裝失敗。接著會提示使用者嘗試手動安裝最新版本的 .NET Framework。當他們選擇 **Close (關閉)** 時，他們會結束安裝。

若要解決這個問題，使用者必須從他們計劃安裝用戶端的電腦建立網際網路連線，然後在同一部電腦上下載並安裝 .NET Framework 4.6.2 版或更新版本。如需可供下載的 .NET Framework 版本清單，請參閱[下載 .NET Framework](https://dotnet.microsoft.com/download/dotnet-framework)。

**注意**  
已安裝 WorkSpaces 應用程式用戶端 1.1.156 版的使用者，必須在相同的 PC 上安裝 .NET Framework 4.7.2 版或更新版本。

## 使用者的 USB 驅動程式安裝在安裝 WorkSpaces 應用程式用戶端時失敗，現在他們無法將其 USB 裝置與 WorkSpaces 應用程式搭配使用。
<a name="troubleshooting-client-no-internet-usb-driver-install-fails"></a>

當使用者安裝 WorkSpaces 應用程式用戶端時，他們會選擇是否要安裝 WorkSpaces 應用程式 USB 驅動程式。驅動程式需要使用 USB 裝置搭配透過 WorkSpaces 應用程式串流的應用程式。不過，如果發生下列兩種情況，USB 驅動程式安裝就會失敗：
+ 用來簽署 `AppStreamUsbDriver.exe` 檔案的根憑證不存在於 Windows 憑證存放區中。
+ 安裝用戶端的電腦未連線到網際網路。

在此情況下，無法驗證 Amazon AppStream USB 驅動程式的憑證，並會出現錯誤訊息通知使用者 USB 驅動程式安裝失敗。當使用者選擇**確定**時，WorkSpaces 應用程式用戶端安裝會在沒有 USB 驅動程式的情況下完成。雖然使用者仍然可以使用 WorkSpaces 應用程式用戶端進行應用程式串流，但其 USB 裝置無法與透過 WorkSpaces 應用程式串流的應用程式搭配使用。

若要解決此問題，使用者必須從計劃安裝 WorkSpaces 應用程式用戶端的 PC 建立網際網路連線，然後重新安裝用戶端。

## 我的 WorkSpaces 應用程式用戶端使用者每 60 分鐘就會與其 WorkSpaces 應用程式工作階段中斷連線。
<a name="troubleshooting-client-users-disconnected-every-60-minutes"></a>

如果您已使用 SAML 2.0 設定聯合身分以存取 WorkSpaces 應用程式，根據您的身分提供者 (IdP)，您可能需要設定 IdP 作為 SAML 屬性傳遞到 的資訊 AWS ，作為身分驗證回應的一部分。這包括設定**屬性**元素，其 `SessionDuration` 屬性設定為 `https://aws.amazon.com/SAML/Attributes/SessionDuration`。

`SessionDuration` 指定在需要重新驗證之前，使用者的同盟串流工作階段可以保持作用中的時間上限。雖然 `SessionDuration` 是選用屬性，但我們建議您將它包含在 SAML 驗證回應中。如果您未指定此屬性，工作階段持續時間會設定為預設值 60 分鐘。

若要解決此問題，請將 SAML 相容 IdP 設定為在 SAML 驗證回應中包含該 `SessionDuration` 值，然後視需要設定值。如需詳細資訊，請參閱[步驟 5：建立 SAML 身分驗證回應聲明](external-identity-providers-setting-up-saml.md#external-identity-providers-create-assertions)。

**注意**  
如果您的使用者使用 WorkSpaces 應用程式原生用戶端或在新體驗中使用 Web 瀏覽器存取 WorkSpaces 應用程式中的串流應用程式，其工作階段會在工作階段持續時間到期後中斷連線。如果您的使用者在舊/傳統體驗中使用 Web 瀏覽器存取 WorkSpaces 應用程式中的串流應用程式，則在使用者的工作階段持續時間到期且重新整理瀏覽器頁面之後，他們的工作階段就會中斷連線。

如果您的使用者使用 SAML 相容 IdP 登入新的入口網站體驗，而且他們持續隨機中斷連線，這可能是因為 WorkSpaces 應用程式工作階段使用的工作階段 Cookie 被其他使用 `aws.amazon.com` 做為子網域的 Web 應用程式失效。以下是常見的使用者案例：
+ 如果使用者在相同的瀏覽器中啟動新的 WorkSpaces 應用程式工作階段，現有的 WorkSpaces 應用程式工作階段將會中斷連線。
+ 如果使用者在相同瀏覽器中啟動任何其他 Web 應用程式，導致`aws.amazon.com`網域下有新的使用者身分驗證，現有的 WorkSpaces 應用程式工作階段將會中斷連線。
+ 如果使用者 AWS 管理主控台 在相同的瀏覽器中使用新的 IAM 登入資料登入 ，現有的 WorkSpaces 應用程式工作階段將會中斷連線。

您可以使用新的轉送狀態端點來設定 SAML 2.0 聯合，以及使用 WorkSpaces 應用程式用戶端 1.1.1300 版和更新版本來解決此問題。如需詳細資訊，請參閱 上的表 1[步驟 6：設定聯合的轉送狀態](external-identity-providers-setting-up-saml.md#external-identity-providers-relay-state)。

## 我的使用者無法在他們的本機裝置和串流工作階段之間複製和貼上。
<a name="copy-paste-doesnt-work"></a>

WorkSpaces 應用程式利用 [W3C 規格](https://www.w3.org/TR/2017/WD-clipboard-apis-20170929/)，在 Web 應用程式中啟用非同步剪貼簿操作。這可讓使用者在本機裝置和其串流工作階段間複製和貼上，與在本機裝置上應用程式間進行的操作相同 (包含使用鍵盤快速鍵)。

目前支援 W3C 非同步剪貼簿規格的唯一瀏覽器是 Google Chrome 版本 66 及更新版本，且目前僅支援複製和貼上文字。對於所有其他瀏覽器，使用者可以在 WorkSpaces 應用程式 Web 入口網站中使用剪貼簿功能，該入口網站提供用於複製或貼上文字的對話方塊。

若您的使用者在其串流工作階段期間使用剪貼簿時發生問題，您可以提供他們以下資訊：
+ **我正在使用 Chrome 版本 66 及更新版本，但鍵盤快速鍵無法運作。**

  Chrome 會顯示提示，讓您選擇是否允許 WorkSpaces 應用程式存取複製到剪貼簿的內容。請選擇 **Allow (允許)** 來啟用將內容貼到您的遠端工作階段。若您要將文字從您的遠端工作階段複製到本機裝置，您本機裝置上的 Chrome 應用程式和包含您串流工作階段的標籤都必須維持在焦點狀態足夠的時間，才能從您的串流工作階段複製文字。數量較少的文字通常會立即完成複製，但大量的文字則需要等待 1 至 2 秒才能從 Chrome 或包含您串流工作階段的標籤切換。複製文字所需的時間可能會因網路條件而有所不同。
+ **當我在嘗試複製和貼上大量文字時，複製和貼上無法正常運作。**

  WorkSpaces 應用程式的預設文字數量限制為 20 MB，您可以在本機裝置和串流工作階段之間複製和貼上。如果您嘗試複製超過 20 MB，則不會複製任何文字。不過，如果您的管理員設定限制，而且您超出該限制，文字將會截斷。若您嘗試在本機裝置上的應用程式間，或是在您串流工作階段中的應用程式間複製和貼上文字，則不會套用此限制。管理員也可以限制您在串流工作階段中複製/貼上的字元數。如果您需要複製或貼上文字超過 20 MB 或本機裝置與串流工作階段之間的指定限制，您可以將文字分割為較小的區塊，或改為將其上傳為檔案。
+ **我正在使用 WorkSpaces 應用程式 Web 入口網站剪貼簿功能，將文字貼到串流工作階段，但無法運作。**

  在您將文字貼到剪貼簿對話方塊並關閉對話方塊之後，當您嘗試使用鍵盤快速鍵將文字貼到您的串流工作階段時，在某些情況下不會進行任何動作。此問題是因為當剪貼簿對話方塊出現時，它會將焦點從您的串流應用程式移走。在對話方塊關閉後，焦點可能會無法自動返回您的串流應用程式。按一下您的串流應用程式應該會使焦點返回，並讓您使用鍵盤快速鍵來將文字貼到您的串流工作階段。

## 在串流工作階段期間，使用者可能會無法使用某些鍵盤快速鍵。
<a name="keyboard-shortcuts-dont-work"></a>

下列鍵盤快速鍵適用於使用者的本機電腦，但不會傳遞至 WorkSpaces 應用程式串流工作階段：

Windows：
+ Win\$1L
+ Ctrl\$1Alt\$1Del

Mac：
+ Ctrl\$1F3 
+ 所有使用 Alt 或 Option 鍵組合的快速鍵

此問題是因為使用者本機電腦上的下列限制：
+ 鍵盤快速鍵會由在使用者的本機電腦上執行的作業系統進行篩選，而不會傳播到使用者存取 WorkSpaces 應用程式的瀏覽器。此行為適用於 Windows Win\$1L 及 Ctrl\$1Alt\$1Del 鍵盤快速鍵，以及 Mac 的 Ctrl\$1F3 鍵盤快速鍵。
+ 搭配 web 應用程式使用時，有些鍵盤快速鍵會由瀏覽器進行篩選，而不會為 web 應用程式產生事件。其結果便是 web 應用程式無法回應由使用者輸入的鍵盤快速鍵。
+ 瀏覽器在產生事件之前便已翻譯鍵盤快速鍵，因此無法正確翻譯。例如，Mac 電腦上的 Alt 鍵組合和 Option 鍵組合會翻譯成 Windows 上的 Alt 圖形鍵組合。當發生此情況時，結果便可能不是使用者使用這些按鍵組合時所預期的結果。

## 我的使用者繪圖板無法使用我部署的串流應用程式。
<a name="troubleshooting-client-users-drawing-tablets-not-working"></a>

如果您的使用者繪圖板無法使用串流應用程式，請確定您符合需求並瞭解啟用此功能的其他考量。以下是可讓您的使用者在 WorkSpaces 應用程式串流工作階段期間使用繪圖板的要求和考量事項。

**注意**  
使用 WorkSpaces 應用程式用戶端或透過支援的 Web 瀏覽器存取 WorkSpaces 應用程式的使用者支援繪圖板。
+ 若要讓使用者使用此功能，您必須將 WorkSpaces 應用程式機群設定為使用執行 Windows Server 2019 的映像。
+ 若要使用此功能，使用者必須使用 WorkSpaces 應用程式用戶端，或僅透過 Google Chrome 或 Mozilla Firefox 瀏覽器存取 WorkSpaces 應用程式。
+ 串流應用程式必須支援 Windows Ink 技術。如需詳細資訊，請參閱 [Windows 應用程式中的手寫筆互動與 Windows Ink](https://docs.microsoft.com/en-us/windows/uwp/design/input/pen-and-stylus-interactions)。
+ 某些應用程式 (例如 GIMP) 必須偵測串流執行個體上的繪圖板以支援壓力敏感度。如果是這種情況，您的使用者必須使用 WorkSpaces 應用程式用戶端來存取 WorkSpaces 應用程式並串流這些應用程式。此外，您必須符合使用者繪圖板的資格，而且使用者每次啟動新的串流工作階段時，都必須與 WorkSpaces 應用程式共用繪圖板。
+ Chromebook 不支援這項功能。

## 我的使用者在串流工作階段期間無法使用日文輸入法
<a name="japanese-language-input-method-doesnt-work-for-users"></a>

若要讓使用者在 WorkSpaces 應用程式串流工作階段期間使用日文輸入方法，請執行下列動作：
+ 將您的機群設定為使用日文輸入法。若要進行這項操作，請在建立映像時，於映像建置器上啟用日文輸入法，然後將機群設定為使用映像。如需詳細資訊，請參閱[指定預設的輸入法](configure-default-input-method.md)。這樣做可讓 WorkSpaces 應用程式自動設定映像以使用日文鍵盤。如需詳細資訊，請參閱[日文鍵盤](special-considerations-japanese-language-settings.md#special-considerations-japanese-language-keyboards)。
+ 確定使用者的本機電腦上也已啟用日文輸入法。

如果機群執行個體和使用者的本機電腦未使用相同語言的輸入法，則不相符的情況可能會導致使用者串流工作階段期間機群執行個體上發生非預期的鍵盤輸入。例如，如果機群執行個體使用日文輸入法，而使用者的本機電腦使用英文輸入法，則在串流工作階段期間，本機電腦會將按鍵傳送至與機群執行個體的按鍵映射不相同的機群執行個體。

若要確認機群執行個體是否已啟用日文輸入法，請啟用機群的**桌面**串流檢視。如需詳細資訊，請參閱 [在 Amazon WorkSpaces 應用程式中建立機群](set-up-stacks-fleets-create.md) 中的步驟 6。

### Windows 鍵盤快速鍵
<a name="japanese-language-input-method-windows-keyboard-shortcuts"></a>

以下是用於切換日文輸入模式和日文轉換的 Windows 鍵盤快速鍵。若要讓這些鍵盤快速鍵正常運作，WorkSpaces 應用程式串流工作階段必須處於作用中狀態。

**用於切換日文輸入模式的 Windows 鍵盤快速鍵**


| 鍵盤快速鍵 | Description | 
| --- | --- | 
|  半角/全角/漢字 (Hankaku/Zenkaku/Kanji) 或是 Alt\$1`  |  在英數和日文模式之間切換輸入模式  | 
|  無変換 (Muhenkan)  |  依序將字元轉換為平假名、全形片假名和半形片假名  | 
|  カタカナ/ひらがな/ローマ字 (Katakana/Hiragana/Romaji)  |  將輸入模式變更為平假名  | 
|  Shift\$1カタカナ/ひらがな/ローマ字 (Katakana/Hiragana/Romaji)  |  將輸入模式變更為片假名  | 
|  Alt\$1カタカナ/ひらがな/ローマ字  (Katakana/Hiragana/Romaji)  |  在日文羅馬字和日文假名之間切換輸入模式  | 

**用於日文轉換的 Windows 鍵盤快速鍵**


| 鍵盤快速鍵 | Description | 
| --- | --- | 
|  変換 (Henkan) \$1 空格鍵  |  列出轉換選項  | 
|  F6  |  轉換為平假名  | 
|  F7  |  轉換為全形片假名  | 
|  F8  |  轉換為半形片假名  | 
|  F9  |  轉換為全形羅馬字  | 
|  F10  |  轉換為半形羅馬字  | 

### Mac 鍵盤快速鍵
<a name="japanese-language-input-method-mac-keyboard-shortcuts"></a>

如需有關切換日文輸入法和日文轉換的 Mac 鍵盤快速鍵的詳細資訊，請參閱 Mac 支援文件中的下列文章。

**注意**  
由於 WorkSpaces 應用程式串流工作階段會在 Windows 執行個體上執行，因此 Mac 使用者可能會遇到不同的金鑰映射。
+ 切換日文輸入法的鍵盤快速鍵：[在 Mac 上設定並切換至日文輸入來源](https://support.apple.com/guide/japanese-input-method/set-up-and-switch-to-japanese-jpim10267/mac)
+ 用於日文轉換的鍵盤快速連結：[Mac 上的日文轉換鍵盤快速鍵](https://support.apple.com/guide/japanese-input-method/keyboard-shortcuts-jpim10263/6.2.1/mac)

## 我的使用者嘗試從應用程式目錄啟動應用程式時，出現有關已達串流工作階段數量上限的錯誤。
<a name="troubleshooting-max-sessions"></a>

使用 WorkSpaces 應用程式彈性機群，您可以指定使用最大並行參數同時串流的使用者數量上限。任何嘗試串流超過該值的使用者都會收到此錯誤。若要解決此問題，您可以提高並行串流數量上限，或建議使用者等待其他使用者完成其串流工作階段。

**注意**  
您可能需要請求提高限制，以提高執行個體類型和大小的限制。

## 我的使用者看到黑色螢幕或桌面，且其應用程式未在彈性機群上啟動。沒有顯示任何錯誤。
<a name="troubleshooting-black-screen"></a>

如果應用程式啟動路徑不正確，而 AppStream 2.0 無法啟動應用程式，就會發生這種情況。您可以使用機群上的桌面檢視來瀏覽根磁碟區，以驗證應用程式啟動路徑。驗證應用程式可執行檔是否存在指定的路徑中。

如果您無法在串流執行個體上找到應用程式區塊的 VHD 或安裝指令碼，表示 AppStream 2.0 可能未能從 S3 儲存貯體下載它們。驗證您指定的 VPC 可存取 S3。如需詳細資訊，請參閱[將 Amazon S3 VPC 端點用於 WorkSpaces 應用程式功能](managing-network-vpce-iam-policy.md)。