故障診斷 AppStream 2.0 使用者問題 - Amazon AppStream 2.0
啟用進階記錄使用者的 AppStream 2.0 用戶端安裝失敗，並且收到訊息，指出須有 .NET Framework 4.6。使用者的 USB 驅動程式安裝會在安裝 AppStream 2.0 用戶端時失敗，現在他們無法搭配 AppStream 2.0 使用其 USB 裝置。我的 AppStream 2.0 用戶端使用者每 60 分鐘就會從其 AppStream 2.0 工作階段中斷連線。我的使用者無法在他們的本機裝置和串流工作階段之間複製和貼上。在串流工作階段期間，使用者可能會無法使用某些鍵盤快速鍵。我的使用者繪圖板無法使用我部署的串流應用程式。我的使用者在串流工作階段期間無法使用日文輸入法我的使用者嘗試從應用程式目錄啟動應用程式時，出現有關已達串流工作階段數量上限的錯誤。我的使用者看到黑色螢幕或桌面，且其應用程式未在彈性機群上啟動。沒有顯示任何錯誤。

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

故障診斷 AppStream 2.0 使用者問題

啟用進階記錄

為了協助對使用者可能遇到的問題進行故障診斷，您可以在任何 AppStream 2.0 用戶端上啟用進階記錄。進階記錄會產生包含診斷資訊和偵錯層級詳細資料 (包括詳細效能資料) 的日誌。

注意

若要取得進階日誌檔案的 AWS 檢閱，以及接收 AppStream 2.0 用戶端問題的技術支援，請聯絡 支援。如需詳細資訊，請參閱 AWS Support Center Console。

啟用 Web 存取的進階記錄

如果使用者使用 SAML、使用者集區，或有權存取應用程式目錄頁面，請遵循下列步驟：

  1. 載入目錄頁面。

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

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

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

  5. 重現問題。

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

啟用 Windows 用戶端的進階記錄

若要啟用 Windows 用戶端的進階記錄，請依照下列步驟進行：

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

  2. 在筆記本Log4Net.config中開啟 。

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

  4. 儲存檔案。

  5. 重新啟動 AppStream 2.0 用戶端，然後再次嘗試連線。

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

以下是使用者使用 AppStream 2.0 時可能發生的特定問題。

使用者的 AppStream 2.0 用戶端安裝失敗，並且收到訊息，指出須有 .NET Framework 4.6。

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

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

注意

安裝 AppStream 2.0 用戶端 1.1.156 版的使用者必須在同一部電腦上安裝 .NET Framework 4.7.2 版或更新版本。

使用者的 USB 驅動程式安裝會在安裝 AppStream 2.0 用戶端時失敗，現在他們無法搭配 AppStream 2.0 使用其 USB 裝置。

當使用者安裝 AppStream 2.0 用戶端時，他們會選擇是否要安裝 AppStream 2.0 USB 驅動程式。USB 裝置須有驅動程式，才可使用透過 AppStream 2.0 串流處理的應用程式。不過，如果發生下列兩種情況，USB 驅動程式安裝就會失敗：

  • 用來簽署 AppStreamUsbDriver.exe 檔案的根憑證不存在於 Windows 憑證存放區中。

  • 安裝用戶端的電腦未連線到網際網路。

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

若要解決這個問題，使用者必須從他們計劃安裝 AppStream 2.0 用戶端的電腦建立網際網路連線，然後重新安裝用戶端。

我的 AppStream 2.0 用戶端使用者每 60 分鐘就會從其 AppStream 2.0 工作階段中斷連線。

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

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

若要解決此問題，請將 SAML 相容 IdP 設定為在 SAML 驗證回應中包含該 SessionDuration 值，然後視需要設定值。如需詳細資訊，請參閱步驟 5：建立 SAML 身分驗證回應聲明。

注意

如果您的使用者使用 AppStream 2.0 原生用戶端或使用新體驗上的 Web 瀏覽器存取 AppStream 2.0 中的串流應用程式，則其工作階段會在工作階段期間過期後中斷連線。如果您的使用者使用舊版/傳統體驗上的 Web 瀏覽器存取 AppStream 2.0 中的串流應用程式，則在使用者的工作階段期間過期並重新整理瀏覽器頁面之後，其工作階段就會中斷連線。

如果您的使用者使用與 SAML 相容的 IdP 登入新的入口網站體驗，而且他們持續隨機中斷連線，這可能是因為 AppStream 2.0 工作階段使用的工作階段 Cookie 被其他 Web 應用程式使用 aws.amazon.com 做為子網域而失效。以下是常見的使用者案例：

  • 如果使用者在相同的瀏覽器中啟動新的 AppStream 2.0 工作階段，現有的 AppStream 2.0 工作階段將會中斷連線。

  • 如果使用者在相同的瀏覽器中啟動任何其他 Web 應用程式，導致aws.amazon.com網域下有新的使用者身分驗證，現有的 AppStream 2.0 工作階段將會中斷連線。

  • 如果使用者 AWS Management Console 在相同瀏覽器中使用新的 IAM 登入資料登入 ，現有的 AppStream 2.0 工作階段將會中斷連線。

您可以使用新的轉送狀態端點來設定 SAML 2.0 聯合，以及使用 AppStream 2.0 用戶端 1.1.1300 版和更新版本來解決此問題。如需詳細資訊，請參閱 上的表 1步驟 6：設定聯合的轉送狀態。

我的使用者無法在他們的本機裝置和串流工作階段之間複製和貼上。

AppStream 2.0 會利用 W3C 規格在 Web 應用程式中啟用非同步的剪貼簿操作。這可讓使用者在本機裝置和其串流工作階段間複製和貼上，與在本機裝置上應用程式間進行的操作相同 (包含使用鍵盤快速鍵)。

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

若您的使用者在其串流工作階段期間使用剪貼簿時發生問題，您可以提供他們以下資訊：

  • 我正在使用 Chrome 版本 66 及更新版本，但鍵盤快速鍵無法運作。

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

  • 當我在嘗試複製和貼上大量文字時，複製和貼上無法正常運作。

    AppStream 2.0 預設限制為 20 MB，您可以在本機裝置和串流工作階段之間複製和貼上文字。如果您嘗試複製超過 20 MB，則不會複製任何文字。不過，如果您的管理員設定限制，且您超出該限制，文字將會截斷。若您嘗試在本機裝置上的應用程式間，或是在您串流工作階段中的應用程式間複製和貼上文字，則不會套用此限制。管理員也可以限制您複製/貼上串流工作階段的字元數。如果您需要複製或貼上文字超過 20 MB 或本機裝置與串流工作階段之間的指定限制，您可以將文字分割為較小的區塊，或改為將其上傳為檔案。

  • 我使用 AppStream 2.0 Web 入口網站剪貼簿功能來將文字貼到我的串流工作階段，但無法正常運作。

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

在串流工作階段期間，使用者可能會無法使用某些鍵盤快速鍵。

下列鍵盤快速鍵在使用者的本機電腦上可正常運作，但無法傳遞至 AppStream 2.0 串流工作階段：

Windows：

  • Win+L

  • Ctrl+Alt+Del

Mac：

  • Ctrl+F3

  • 所有使用 Alt 或 Option 鍵組合的快速鍵

此問題是因為使用者本機電腦上的下列限制：

  • 鍵盤快速鍵是由使用者本機電腦上執行的作業系統進行篩選，不會傳播到使用者存取 AppStream 2.0 的瀏覽器。此行為適用於 Windows Win+L 及 Ctrl+Alt+Del 鍵盤快速鍵，以及 Mac 的 Ctrl+F3 鍵盤快速鍵。

  • 搭配 web 應用程式使用時，有些鍵盤快速鍵會由瀏覽器進行篩選，而不會為 web 應用程式產生事件。其結果便是 web 應用程式無法回應由使用者輸入的鍵盤快速鍵。

  • 瀏覽器在產生事件之前便已翻譯鍵盤快速鍵，因此無法正確翻譯。例如，Mac 電腦上的 Alt 鍵組合和 Option 鍵組合會翻譯成 Windows 上的 Alt 圖形鍵組合。當發生此情況時，結果便可能不是使用者使用這些按鍵組合時所預期的結果。

我的使用者繪圖板無法使用我部署的串流應用程式。

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

注意

針對使用 AppStream 2.0 用戶端或透過支援的 Web 瀏覽器存取 AppStream 2.0 的使用者，支援使用繪圖板。

  • 要讓使用者能夠利用這項功能，您必須將 AppStream 2.0 機群設定為使用執行 Windows Server 2019 的映像。

  • 若要使用此功能，使用者必須使用 AppStream 2.0 用戶端，或只能透過 Google Chrome 或 Mozilla Firefox 瀏覽器連線至 AppStream 2.0。

  • 串流應用程式必須支援 Windows Ink 技術。如需詳細資訊，請參閱 Windows 應用程式中的手寫筆互動與 Windows Ink。

  • 某些應用程式 (例如 GIMP) 必須偵測串流執行個體上的繪圖板以支援壓力敏感度。如果是這種情況，您的使用者必須使用 AppStream 2.0 用戶端來存取 AppStream 2.0 和串流這些應用程式。此外，您必須限定使用者的繪圖板，並且使用者必須在每次啟動新的串流工作階段時，與 AppStream 2.0 共用繪圖板。

  • Chromebook 不支援這項功能。

我的使用者在串流工作階段期間無法使用日文輸入法

若要讓使用者在 AppStream 2.0 串流工作階段期間使用日文輸入法，請執行下列操作：

  • 將您的機群設定為使用日文輸入法。若要進行這項操作，請在建立映像時，於映像建置器上啟用日文輸入法，然後將機群設定為使用映像。如需詳細資訊，請參閱指定預設的輸入法。如此就能 AppStream 2.0 自動將映像設定為使用日文鍵盤。如需詳細資訊，請參閱日文鍵盤。

  • 確定使用者的本機電腦上也已啟用日文輸入法。

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

若要確認機群執行個體是否已啟用日文輸入法，請啟用機群的桌面串流檢視。如需詳細資訊，請參閱 在 Amazon AppStream 2.0 中建立機群 中的步驟 6。

Windows 鍵盤快速鍵

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

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

鍵盤快速鍵 描述

半角/全角/漢字

(Hankaku/Zenkaku/Kanji)

或是 Alt+`

在英數和日文模式之間切換輸入模式

無変換

(Muhenkan)

依序將字元轉換為平假名、全形片假名和半形片假名

カタカナ/ひらがな/ローマ字

(Katakana/Hiragana/Romaji)

將輸入模式變更為平假名

Shift+カタカナ/ひらがな/ローマ字

(Katakana/Hiragana/Romaji)

將輸入模式變更為片假名

Alt+カタカナ/ひらがな/ローマ字

(Katakana/Hiragana/Romaji)

在日文羅馬字和日文假名之間切換輸入模式

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

鍵盤快速鍵 描述

変換 (Henkan) + 空格鍵

列出轉換選項

F6

轉換為平假名

F7

轉換為全形片假名

F8

轉換為半形片假名

F9

轉換為全形羅馬字

F10

轉換為半形羅馬字

Mac 鍵盤快速鍵

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

注意

由於 AppStream 2.0 串流工作階段是在 Windows 執行個體上執行，因此 Mac 使用者可能會遇到不同的按鍵映射。

我的使用者嘗試從應用程式目錄啟動應用程式時，出現有關已達串流工作階段數量上限的錯誤。

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

注意

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

我的使用者看到黑色螢幕或桌面，且其應用程式未在彈性機群上啟動。沒有顯示任何錯誤。

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

如果您無法在串流執行個體上找到應用程式區塊的 VHD 或安裝指令碼，表示 AppStream 2.0 可能未能從 S3 儲存貯體下載它們。驗證您指定的 VPC 可存取 S3。如需詳細資訊，請參閱針對 AppStream 2.0 功能使用 Amazon S3 VPC 端點。