As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Qualifique dispositivos USB para uso com aplicativos de streaming
Há dois métodos para especificar quais dispositivos USB seus usuários podem redirecionar para suas instâncias de streaming de WorkSpaces aplicativos:
**nota**
Atualmente, o redirecionamento USB só é suportado em instâncias de streaming de WorkSpaces aplicativos do Windows. Não há compatibilidade com o cliente macOS.
+ Você pode criar as strings de filtro de dispositivos USB no arquivo de configuração salvo em uma imagem. Esse método só pode ser usado com frotas sempre ativas e sob demanda.
+ Você pode especificar cadeias de filtros de dispositivos USB ao criar a frota, com o AWS Management Console ou com a `CreateFleet` API. Para obter informações detalhadas sobre essas strings, consulte a seção a seguir. Esse método só pode ser usado com frotas elásticas.
Você pode criar um arquivo na imagem de seus WorkSpaces aplicativos que especifica quais dispositivos USB um usuário pode disponibilizar para seus aplicativos de streaming. Para qualificar os dispositivos USB dos usuários para que eles possam ser usados com aplicativos de streaming, execute estas etapas.
**nota**
Por motivos de segurança, qualifique somente dispositivos USB de fontes confiáveis e aprovadas. A qualificação de todos os dispositivos genéricos ou classes de dispositivos pode permitir que dispositivos não aprovados sejam usados com as aplicações de streaming.
1. Se você ainda não tiver feito isso, instale o cliente de WorkSpaces aplicativos. Para mais informações, consulte [Instalar e configurar o cliente WorkSpaces de aplicativos](install-configure-client.md).
1. Conecte o dispositivo USB ao qual você deseja qualificar para o seu computador.
1. Navegue até **C:\$1Users\$1 < logged-in-user >\$1AppData\$1 Local\$1 AppStreamClient** e clique duas vezes em **dcvusblist.exe**.
1. Na caixa de diálogo **DCV - USB devices (DCV - dispositivos USB)**, a lista de dispositivos conectados ao seu computador local é exibida. A coluna **Filter (Filtro)** exibe a string de filtro para cada dispositivo USB. Clique com o botão direito do mouse na entrada da lista para um dispositivo USB que deseja ativar e selecione **Copy filter string (Copiar string de filtro)**.
1. Na sua área de trabalho, clique no botão **Start (Iniciar)** do Windows e procure o Bloco de notas. Clique duas vezes em **Notepad (Bloco de notas)** para abrir um novo arquivo, copie a string de filtro no arquivo e salve-o. Posteriormente, você usará a string de filtro para qualificar o dispositivo USB.
1. Inicie um novo criador de imagens. Para obter mais informações, consulte [Inicie um criador de imagens para instalar e configurar aplicativos de streaming](tutorial-image-builder-create.md).
1. Depois que seu criador de imagens **estiver no estado Executando**, execute as etapas a seguir para criar uma URL de streaming e conectar-se ao criador de imagens usando o cliente WorkSpaces Applications.
1. Com o criador de imagens escolhido na lista, selecione **Actions (Ações)**, **Create streaming URL (Criar URL de streaming)**.
1. Na caixa de diálogo **Create streaming URL (Criar URL de streaming)**, selecione **Copy link (Copiar link)**, e copie e cole o endereço da web em um arquivo separado para uso posterior. Você usará esse URL para se reconectar ao criador de imagens na etapa 12.
1. Selecione **Launch in Client (Executar no cliente)**.
1. Se a caixa de diálogo **Iniciar aplicativo** abrir e solicitar que você escolha o aplicativo a ser usado ao abrir o link, escolha **Amazon AppStream**, **Abrir link**. Para evitar que essa caixa de diálogo seja exibida na próxima vez que você executar essa etapa para se conectar a um criador de imagens, marque a caixa de seleção **Remember my choice for amazonappstream links (Lembrar minha escolha para links do amazonappstream)**.
1. Se o cliente de WorkSpaces Aplicativos exibir links para o Contrato do AWS Cliente, os Termos de AWS Serviço e o Aviso de AWS Privacidade e avisos de terceiros, revise essas informações e escolha **Concluir**.
1. Se a página de login do cliente for exibida, o campo de endereço da Web será preenchido com o URL de streaming. Selecione **Conectar**.
1. Se for solicitado, faça login no construtor de imagens como administrador.
1. Depois de estar conectado ao criador de imagens, se o dispositivo USB exigir que você instale drivers antes de usá-lo, faça download dos drivers e instale-os no criador de imagens. Por exemplo, se você usar o Connexion 3D mouse, você deve fazer download e instalar os drivers necessários do Connexion no criador de imagens.
1. Na área de trabalho do criador de imagens, clique no botão **Start (Iniciar)** do Windows e procure o Bloco de notas. Clique com o botão direito do mouse no **Notepad (Bloco de notas)**, e escolha **Run as Administrator (Executar como administrador)**.
1. Escolha **File (Arquivo)**, **Open (Abrir)**, e abra o seguinte arquivo: `C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt`. Também é possível conceder permissão a toda uma categoria de dispositivos ou a todos os dispositivos de determinado fabricante usando expressões curingas no arquivo `usb_device_allowlist.txt`.
1. Copie a string de filtro do seu computador local para o criador de imagens. **A sequência de filtro de um dispositivo USB específico é uma sequência de caracteres separada por vírgula dos seguintes campos: **Nome**, **Classe base**, **Protocolo **SubClass****, ID do **fornecedor, ID** do produto**,** **Support Autoshare** e Skip Reset.** Para obter informações detalhadas sobre essas strings, consulte [Como trabalhar com strings de filtro de dispositivo USB](USB-device-filter-strings.md).
1. Desconecte-se do seu construtor de imagens, reinicie-o e reconecte-se a ele usando o cliente de WorkSpaces aplicativos. **Para fazer isso, abra o cliente WorkSpaces Applications e cole o URL de streaming que você criou na etapa 7 no campo de endereço da web de login do cliente e escolha Connect.**
1. No criador de imagens, teste seu dispositivo USB para confirmar se ele funciona conforme o esperado.
1. Antes que seus usuários possam usar o dispositivo USB em uma sessão de WorkSpaces aplicativos, eles devem primeiro compartilhar o dispositivo com a sessão. Para obter orientações que podem ser repassadas aos usuários para ajudá-los a executar essa tarefa, consulte [Dispositivos USB](client-application-windows-how-to-share-usb-devices-user.md).
1. Se o dispositivo USB funcionar com o criador de imagens como esperado, crie uma imagem. Para obter mais informações, consulte [Tutorial: Crie uma imagem de WorkSpaces aplicativos personalizada usando o console de WorkSpaces aplicativos](tutorial-image-builder.md).
1. Depois de terminar de criar a imagem, atualize sua frota de WorkSpaces aplicativos para usar a nova imagem.
# Como trabalhar com strings de filtro de dispositivo USB
Esta seção descreve as cadeias de filtros que estão disponíveis para dispositivos USB qualificados para sessões de streaming de WorkSpaces aplicativos. Ela também fornece orientação para trabalhar com essas strings. As seguintes strings de filtro estão disponíveis:
+ `Name`: por padrão, o valor dessa string de filtro é o nome do dispositivo, mas você pode especificar um valor próprio.
+ `Base Class,SubClass,Protocol`: o código de classe USB do dispositivo. Para obter mais informações, consulte [Códigos de classe definidos](https://www.usb.org/defined-class-codes).
+ `ID Vendor (VID)`: um identificador exclusivo atribuído pela organização USB ao fabricante do dispositivo USB.
+ `ID Product (PID)`: um identificador exclusivo atribuído pelo fabricante ao dispositivo USB.
+ `Support Autoshare`— Permite que o cliente de WorkSpaces aplicativos compartilhe automaticamente o dispositivo quando uma sessão de streaming é iniciada. Defina esse valor como `1` para permitir o compartilhamento automático de dispositivos. Defina esse valor como `0` para não permitir o compartilhamento automático de dispositivos.
+ `Skip Reset`— Por padrão, quando um dispositivo USB é compartilhado por WorkSpaces aplicativos com uma sessão de streaming, o dispositivo é reiniciado para garantir que funcione corretamente. No entanto, se redefinidos, alguns dispositivos USB não funcionam corretamente durante a sessão de streaming. Para evitar que esse problema ocorra, defina o valor dessa sequência de filtro para `1` instruir o cliente de WorkSpaces aplicativos a não reinicializar o dispositivo enquanto ele estiver compartilhado com uma sessão de streaming. Para garantir que o dispositivo seja redefinido enquanto for compartilhado por uma sessão de streaming, defina esse valor como `0`. Ao definir um valor para `Skip Reset`, defina o valor de `Support Autoshare` como `0` ou `1`.
A string de filtro que é copiada do computador local é específica para um dispositivo USB. Em alguns casos, você talvez queira permitir toda uma classe de dispositivos em vez de permitir todos os dispositivos USB possíveis. Por exemplo, você pode permitir que os usuários usem qualquer tipo de tablet de design Wacom ou qualquer dispositivo de armazenamento em massa USB. Nesses cenários, você pode fornecer caracteres curinga para campos de string de filtro específicos. Se não souber o VID e o PID dos seus dispositivos USB, você pode procurar essas informações no [banco de dados de ID do USB](https://www.the-sz.com/products/usbid/index.php).
Os exemplos a seguir mostram como configurar strings de filtro para compartilhamento de dispositivos USB durante sessões de streaming:
+ Permitir todos os dispositivos de armazenamento em massa automaticamente ao iniciar uma sessão de streaming: “Mass storage, 8, \$1, \$1, \$1, \$1,1,0”
+ Permitir todos os dispositivos Wacom automaticamente ao iniciar uma sessão de streaming: “Wacom tablets, 3, \$1, \$1, 1386, \$1,1,0”
+ Permitir todos os dispositivos que fornecem uma interface de áudio: “Audio, 1, \$1, \$1, \$1, \$1,1,0”
+ Permita o dispositivo X, mas não o redefina enquanto o dispositivo estiver compartilhado. Não compartilhar o dispositivo automaticamente ao iniciar uma sessão de streaming: “X, Y, \$1, \$1, 1.386, \$1,0,1”