翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ストリーミングアプリケーションで使用する USB デバイスを認証する
<a name="qualify-usb-devices"></a>

ユーザーが WorkSpaces アプリケーションストリーミングインスタンスにリダイレクトできる USB デバイスを指定するには、次の 2 つの方法があります。

**注記**  
USB リダイレクトは現在、Windows WorkSpaces アプリケーションストリーミングインスタンスでのみサポートされています。macOS クライアントではサポートされていません。
+ イメージに保存された設定ファイル内に USB デバイスフィルター文字列を作成できます。この方法を使用できるのは、常時オンおよびオンデマンドフリートのみです。
+ フリートの作成時に、 AWS マネジメントコンソールまたは `CreateFleet` API を使用して USB デバイスフィルター文字列を指定できます。これらの文字列の詳細については、以下のセクションを参照してください。この方法を使用できるのは、Elastic フリートのみです。

WorkSpaces Applications イメージにファイルを作成して、ユーザーがストリーミングアプリケーションで使用できる USB デバイスを指定できます。ユーザーの USB デバイスを認定してストリーミングアプリケーションで使用できるようにするには、以下の手順を実行します。

**注記**  
セキュリティ上の理由から、承認済みの信頼できるソースからの USB デバイスのみを認定するようにしてください。すべての汎用デバイスまたはデバイスクラスを認定すると、ストリーミングアプリケーションで未承認のデバイスが使用されることになる可能性があります。

1. まだインストールしていない場合は、WorkSpaces Applications クライアントをインストールします。詳細については、「[WorkSpaces アプリケーションクライアントのインストールと設定](install-configure-client.md)」を参照してください。

1. 認証する USB デバイスをコンピュータに接続します。

1. **C:\$1Users\$1<logged-in-user>\$1AppData\$1Local\$1AppStreamClient** に移動し、[**dcvusblist.exe**] をダブルクリックします。

1. [**DCV - USB デバイス**] ダイアログボックスに、ローカルコンピュータに接続された USB デバイスのリストが表示されます。[**フィルター**] 列に、USB デバイスごとにフィルター文字列が表示されます。有効にする USB デバイスのリストエントリを右クリックして、[**フィルター文字列のコピー**] を選択します。

1. デスクトップで、Windows の [**スタート**] ボタンを選択し、メモ帳を検索します。[**メモ帳**] をダブルクリックして新しいファイルを開き、フィルター文字列をファイルにコピーして保存します。後で、フィルター文字列を使用して USB デバイスを認証します。

1. 新しい Image Builder を起動します。詳細については、「[Image Builder を起動し、ストリーミングアプリケーションをインストールして設定する](tutorial-image-builder-create.md)」を参照してください。

1. Image Builder が**実行中**状態になったら、次のステップを実行してストリーミング URL を作成し、WorkSpaces Applications クライアントを使用して Image Builder に接続します。

   1. リストでイメージビルダーを選択した状態で、[**アクション**]、[**ストリーミング URL の作成**] の順に選択します。

   1. [**ストリーミング URL の作成**] ダイアログボックスで、[**リンクのコピー**] を選択し、ウェブアドレスをコピーして、後で使用できるように別のファイルに貼り付けておきます。この URL を使用して、ステップ 12 でイメージビルダーに再接続します。

   1. [**Launch in Client (クライアントで起動)**] を選択します。

   1. [**Launch Application**] ダイアログボックスが表示され、リンクを開くときに使用するアプリケーションを選択するように求められた場合は、[**Amazon AppStream**]、[**Open link**] の順に選択します。次にこのステップを実行してイメージビルダーに接続するときにこのダイアログボックスが表示されないようにするには、[**Remember my choice for amazonappstream links ( amazonappstream リンクの選択を記憶する)**] チェックボックスをオンにします。

   1. WorkSpaces Applications クライアントが、 AWS カスタマーアグリーメント、 AWS サービス条件、 AWS プライバシー通知、およびサードパーティー通知へのリンクを表示した場合は、この情報を確認してから、**完了**を選択します。

   1. クライアントのサインインページが表示されると、ウェブアドレスフィールドにストリーミング URL があらかじめ入力されています。[**接続**] を選択します。

   1. プロンプトが表示されたら、管理者としてイメージビルダーにログインします。

1. イメージビルダーに接続した後、USB デバイスを使用する前にドライバーをインストールする必要がある場合は、イメージビルダーにドライバーをダウンロードしてインストールしてください。たとえば、3 D マウスの接続を使用する場合は、必要なドライバーをダウンロードしてインストールする必要があり、Image Builder に接続します。

1. Image Builder で、Windows の [**スタート**] ボタンを選択し、メモ帳を検索します。[**メモ帳**] を右クリックし、[**管理者として実行**] を選択します。

1. [**ファイル**]、[**開く**] の順に選択し、ファイル `C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt` を選択します。また、`usb_device_allowlist.txt` ファイルでワイルドカード式を使用し、デバイスのカテゴリ全体や、特定メーカーのすべてのデバイスを許可することもできます。

1. ローカルコンピュータから Image Builder にフィルター文字列をコピーします。特定の USB デバイスのフィルター文字列は、[**Name (名前)**]、[**Base Class (基本クラス)**]、[**SubClass (サブクラス)**]、[**Protocol (プロトコル)**]、[**ID Vendor (ベンダー ID)**]、[**ID Product (製品 ID)**]、[**Support Autoshare (自動共有のサポート)**]、[**Skip Reset (リセットのスキップ)**] のフィールドをカンマで区切った文字列です。これらの文字列の詳細については、[USB デバイスフィルター文字列の操作](USB-device-filter-strings.md) を参照してください。

1. Image Builder から切断して再起動し、WorkSpaces Applications クライアントを使用して再接続します。これを行うには、WorkSpaces Applications クライアントを開き、ステップ 7 で作成したストリーミング URL をクライアントのサインインウェブアドレスフィールドに貼り付け、**Connect** を選択します。

1. Image Builder は、USB デバイスをテストして、正常に動作することを確認します。

1. ユーザーが WorkSpaces アプリケーションセッションで USB デバイスを使用するには、まずデバイスをセッションと共有する必要があります。このタスクの実行に役立つようにユーザーに提供できるガイダンスについては、「[USB デバイス](client-application-windows-how-to-share-usb-devices-user.md)」をご参照ください。

1. USB デバイスが Image Builder と正常に動作する場合は、イメージを作成します。詳細については、「[チュートリアル: 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 Applications クライアントがデバイスを自動的に共有できるようにします。デバイスの自動共有を許可する場合は、この値を `1` に設定します。デバイスの自動共有を禁止する場合は、この値を `0` に設定します。
+ `Skip Reset` — デフォルトでは、USB デバイスが WorkSpaces アプリケーションによってストリーミングセッションと共有されると、デバイスが正しく機能するようにリセットされます。ただし、一部の USB デバイスはリセットされた場合、ストリーミングセッション中に正しく機能しません。この問題が発生しないようにするには、このフィルター文字列の値を に設定`1`して、ストリーミングセッションと共有されている間はデバイスをリセットしないように WorkSpaces Applications クライアントに指示します。ストリーミングセッションと共有している間にデバイスをリセットする場合は、この値を `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"」