

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

# 限定 USB 裝置以用於串流應用程式
<a name="qualify-usb-devices"></a>

有兩種方法可指定您的使用者可以重新導向至其 WorkSpaces 應用程式串流執行個體的 USB 裝置：

**注意**  
USB 重新導向目前僅支援 Windows WorkSpaces 應用程式串流執行個體。macOS 用戶端不支援此功能。
+ 您可以在儲存於映像上的組態檔案中建立 USB 裝置篩選器字串。此方法只能用於 Always-On 和 On-Demand 機群。
+ 您可以使用 AWS 管理主控台或 `CreateFleet` API，在建立機群時指定 USB 裝置篩選字串。如需有關這些字串的詳細資訊，請參閱下一節。此方法只能用於彈性機群。

您可以在 WorkSpaces 應用程式映像上建立檔案，指定使用者可以為其串流應用程式提供哪些 USB 裝置。若要讓使用者的 USB 裝置合格，以便其裝置可以與串流應用程式搭配使用，請執行下列步驟。

**注意**  
基於安全理由，請僅限定來自經核准可信任來源的 USB 裝置。若限定所有一般裝置或裝置類別，可能會允許串流應用程式使用未經核准的裝置。

1. 如果您尚未這麼做，請安裝 WorkSpaces 應用程式用戶端。如需相關資訊，請參閱[安裝和設定 WorkSpaces 應用程式用戶端](install-configure-client.md)。

1. 將您希望限定的 USB 裝置連線至您的電腦。

1. 導覽至 **C:\$1Users\$1<logged-in-user>\$1AppData\$1Local\$1AppStreamClient**，然後按兩下 **dcvusblist.exe**。

1. 在 **DCV - USB devices (DCV – USB 裝置)** 對話方塊中，會顯示連線至您本機電腦的 USB 裝置清單。**Filter (篩選)** 欄會顯示每個 USB 裝置的篩選字串。以滑鼠右鍵按一下您希望啟用的 USB 裝置清單項目，然後選擇 **Copy filter string (複製篩選字串)**。

1. 在您的桌面上，選擇 Windows **Start (啟動)** 按鈕，搜尋 Notepad。按兩下 **Notepad (記事本)** 以開啟新的檔案，將篩選字串複製到檔案，並將其儲存。稍後您將使用該篩選字串來限定 USB 裝置。

1. 啟動新映像建置器。如需詳細資訊，請參閱[啟動映像建置器以安裝和設定串流應用程式](tutorial-image-builder-create.md)。

1. 映像建置器處於**執行**中狀態後，請執行下列步驟來建立串流 URL，並使用 WorkSpaces 應用程式用戶端連線至映像建置器。

   1. 在清單中選取您的映像建置器後，選擇 **Actions (動作)**、**Create streaming URL (建立串流 URL)**。

   1. 在 **Create streaming URL (建立串流 URL)** 對話方塊中，選擇 **Copy link (複製連結)**，然後複製網址並貼至個別檔案中以供日後使用。在步驟 12 中，您將使用此 URL 重新連線至映像建置器。

   1. 選擇 **Launch in Client (在用戶端中啟動)**。

   1. 如果顯示 **Launch Application (啟動應用程式)** 對話方塊，並提示您選擇要在開啟連結時使用的應用程式，請選擇 **Amazon AppStream**、**Open link (開啟連結)**。若要防止下次執行此步驟，連線至映像建置器時顯示此對話方塊，請選取 **Remember my choice for amazonappstream links (記住我對 Amazon appstream 連結的選擇)** 核取方塊。

   1. 如果 WorkSpaces 應用程式用戶端顯示 AWS 客戶協議、 AWS 服務條款、 AWS 隱私權聲明和第三方通知的連結，請檢閱此資訊，然後選擇**完成**。

   1. 如果顯示用戶端登入頁面，則網址欄位會預先填入串流 URL。選擇**連線**。

   1. 如果出現提示，請以「Administrator (管理員)」身分登入映像建置器。

1. 在連線至映像建置器之後，如果 USB 裝置要求您在使用前先安裝驅動程式，請在映像建置器上下載並安裝驅動程式。例如，如果您使用 Connexion 3D 滑鼠，您必須在影像映像建置器上下載並安裝必要的 Connexion 驅動程式。

1. 在您的映像建置器桌面上，選擇 Windows **Start (啟動)** 按鈕，搜尋 Notepad。以滑鼠右鍵按一下 **Notepad**，然後選擇 **Rus as Administrator (以系統管理員身分執行)**。

1. 選擇 **File (檔案)**、**Open (開啟)**，然後開啟下列檔案：`C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt`。您也可以使用 `usb_device_allowlist.txt` 檔案中的萬用字元表達式，允許使用特定製造商的整個裝置類別或所有裝置。

1. 從您的本機電腦複製篩至映像建置器。特定 USB 裝置的篩選自串為以下欄位使用逗號分隔的字串：**Name**、**Base Class**、**SubClass**、**Protocol**、**ID Vendor**、**ID Product**、**Support Autoshare** 及 **Skip Reset**。如需這些字串的詳細資訊，請參閱[使用 USB 裝置篩選字串](USB-device-filter-strings.md)。

1. 中斷與映像建置器的連線、重新啟動，然後使用 WorkSpaces 應用程式用戶端重新連線至映像建置器。若要這樣做，請開啟 WorkSpaces 應用程式用戶端，並將您在步驟 7 中建立的串流 URL 貼到用戶端登入網址欄位中，然後選擇**連線**。

1. 在映像建置器上測試您的 USB 裝置，確認其能如預期運作。

1. 使用者必須先與其工作階段共用裝置，才能在 WorkSpaces 應用程式工作階段中使用 USB 裝置。如需可協助使用者執行其任務的相關指導，請參閱[USB 裝置](client-application-windows-how-to-share-usb-devices-user.md)。

1. 如果 USB 裝置可如預期使用映像建置器，請建立映像。如需詳細資訊，請參閱[教學課程：使用 WorkSpaces 應用程式主控台建立自訂 WorkSpaces 應用程式映像](tutorial-image-builder.md)。

1. 建立映像之後，請更新您的 WorkSpaces 應用程式機群以使用新映像。

# 使用 USB 裝置篩選字串
<a name="USB-device-filter-strings"></a>

本節說明可用於 WorkSpaces 應用程式串流工作階段合格 USB 裝置的篩選字串。此外，也提供如何使用這些字串的相關指導。以下是可用的篩選字串：
+ `Name`：根據預設，此篩選器字串的值是裝置的名稱，但您可以指定自己的值。
+ `Base Class,SubClass,Protocol`：裝置的 USB 類別代碼。如需詳細資訊，請參閱「[定義的類別代碼](https://www.usb.org/defined-class-codes)」。
+ `ID Vendor (VID)`：USB 組織指派給 USB 裝置製造商的唯一識別符。
+ `ID Product (PID)`：製造商指派給 USB 裝置的唯一識別符。
+ `Support Autoshare` — 讓 WorkSpaces 應用程式用戶端在串流工作階段開始時自動共用裝置。將此值設定為 `1` 以允許自動裝置共用。將此值設定為 `0` 以不允許自動裝置共用。
+ `Skip Reset` — 根據預設，當 WorkSpaces 應用程式與串流工作階段共用 USB 裝置時，裝置會重設，以確保其正常運作。但是部分 USB 裝置如果重設，就無法在串流工作階段期間正常運作。若要避免發生此問題，請將此篩選字串的值設定為 `1`，指示 WorkSpaces 應用程式用戶端不要在與串流工作階段共用時重設裝置。為確保裝置在與串流工作階段分享時重設，請將此值設為 `0`。當您設定 `Skip Reset` 的值時，請確定您將 `Support Autoshare` 的值設定為 `0` 或 `1`。

 從本機電腦複製的篩選字串為 USB 裝置專用。在某些情況下，您或許會希望允許使用裝置的完整類別，而不是允許每個可能的 USB 裝置。舉例來說，您或許會希望允許您的使用者使用任何種類的 Wacom 設計平板電腦，或使用任何 USB 大容量儲存裝置。在這種情況下，您可以為特定的篩選字串欄位提供萬用字元。如果您不知道 USB 裝置的 VID 和 PID，您可以在 [USB ID 資料庫](https://www.the-sz.com/products/usbid/index.php)中搜尋此資訊。

以下範例顯示如何在串流工作階段期間設定 USB 裝置共用的篩選字串：
+ 在開始串流工作階段時自動允許所有大容量儲存裝置：「Mass storage, 8, \$1, \$1, \$1, \$1,1,0」
+ 在開始串流工作階段時自動允許所有 Wacom 裝置：「Wacom tablets, 3, \$1, \$1, 1386, \$1,1,0」
+ 允許所有提供音訊介面的裝置：「Audio, 1, \$1, \$1, \$1, \$1,1,0」
+ 允許裝置 X，但不要在共用裝置時重設。在開始串流工作階段時不要自動共用裝置：「X, Y, \$1, \$1, 1386, \$1,0,1」 