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á. # Instalar e configurar o cliente WorkSpaces de aplicativos Você pode fazer com que seus usuários instalem o cliente de WorkSpaces aplicativos por conta própria ou pode instalar o cliente de WorkSpaces aplicativos para eles executando PowerShell scripts remotamente. É necessário qualificar os dispositivos USB que você deseja habilitar para que seus usuários usem com a sessão de streaming. Se o dispositivo USB não estiver qualificado, ele não será detectado pelos WorkSpaces aplicativos e não poderá ser compartilhado com a sessão. Os tópicos a seguir descrevem como instalar e configurar o cliente de WorkSpaces aplicativos. **Topics** + [Faça com que seus usuários instalem o cliente de WorkSpaces aplicativos sozinhos](user-install-client.md) + [Tutorial: Instale o Amazon WorkSpaces Applications Client e personalize a experiência do cliente para seus usuários](install-client-configure-settings.md) + [Atualize manualmente a ferramenta de implantação corporativa de WorkSpaces aplicativos, o cliente e o driver USB](update-enterprise-deployment-tool-client-usb-driver-manually.md) + [Qualifique dispositivos USB para uso com aplicativos de streaming](qualify-usb-devices.md) + [Configure um método de conexão para seus usuários do WorkSpaces Applications Client](use-client-start-streaming-session.md) + [Permita que os usuários compartilhem um dispositivo USB com uma sessão de streaming de WorkSpaces aplicativos](share-usb-devices-with-session.md) + [Redirecionar uma sessão de streaming do navegador da Web para o cliente de WorkSpaces aplicativos](redirect-streaming-session-from-web-to-client.md) + [Ative o redirecionamento do sistema de arquivos para os usuários de seus WorkSpaces aplicativos](enable-file-system-redirection.md) + [Ative o redirecionamento de impressora local para os usuários de seus WorkSpaces aplicativos](enable-local-printer-redirection.md) # Faça com que seus usuários instalem o cliente de WorkSpaces aplicativos sozinhos Para step-by-step obter orientação que você pode fornecer aos usuários para ajudá-los a instalar o cliente de WorkSpaces aplicativos, consulte [Configuração do Windows](client-application-windows-installation-user.md) ou[Configuração e instalação para macOS](client-application-mac-installation-user.md). **Importante** Para o cliente Windows, se sua organização implantou um software antivírus que impede que os usuários executem arquivos.exe, você deve adicionar uma exceção para permitir que seus usuários executem o programa.exe de instalação do cliente de WorkSpaces aplicativos. Caso contrário, quando os usuários tentarem instalar o cliente, nada acontecerá, ou será exibida uma mensagem de erro após iniciar o programa de instalação. Depois que os usuários instalarem o cliente, se você planeja permitir que seus usuários usem dispositivos USB durante as sessões de streaming de WorkSpaces aplicativos, os seguintes requisitos devem ser atendidos: + Você deve qualificar os dispositivos USB que podem ser usados com WorkSpaces aplicativos. Para obter mais informações, consulte [Qualifique dispositivos USB para uso com aplicativos de streaming](qualify-usb-devices.md). + Depois que seus dispositivos forem qualificados, seus usuários deverão compartilhá-los com os WorkSpaces aplicativos sempre que iniciarem uma nova sessão de streaming. Para obter orientações que podem ser repassadas aos usuários para que concluam essa tarefa, consulte [Dispositivos USB](client-application-windows-how-to-share-usb-devices-user.md). # Tutorial: Instale o Amazon WorkSpaces Applications Client e personalize a experiência do cliente para seus usuários As seções a seguir descrevem como instalar o cliente WorkSpaces Applications e personalizar a experiência do cliente para seus usuários. Se você pretende fazer download e instalar o cliente para seus usuários, primeiro faça download da ferramenta de implantação empresarial. Em seguida, você pode executar PowerShell scripts para instalar o cliente WorkSpaces Applications e definir as configurações do cliente remotamente. **nota** O uso da Enterprise Deployment Tool com o cliente WorkSpaces Applications macOS não é suportado. **Topics** + [Fazer download da ferramenta Enterprise Deployment Tool](#install-client-use-remote-deployment-tool) + [Instale o cliente de WorkSpaces aplicativos e o driver USB](#run-powershell-script-install-client-usb-driver-silently) + [Acessando WorkSpaces aplicativos com o cliente WorkSpaces de aplicativos](#access-appstream-with-client) + [Definir o valor WorkSpaces do registro StartURL para usuários do Applications Client](#set-start-url-registry-value) + [Defina o valor TrustedDomains do registro para habilitar outros domínios para o cliente de WorkSpaces aplicativos](#set-trusted-domains-registry-value) + [Crie o registro AS2 TrustedDomains DNS TXT para habilitar seu domínio para o cliente de WorkSpaces aplicativos sem alterações no registro](#create-AS2TrustedDomains-DNS-TXT-record-client) + [Desativar pesquisa de registro TXT de DNS para domínios confiáveis](#disable-DNS-TXT-record-lookup-client) + [Escolher se deseja desabilitar as atualizações automáticas do cliente](#disable-automatic-updates-client) + [Escolher se deseja desativar os uploads de log de diagnóstico sob demanda](#disable-on-demand-diagnostic-log-uploads) + [Escolher se deseja desativar o modo de aplicativo nativo](#disable-native-application-mode-client) + [Escolher se deseja desabilitar o redirecionamento para impressora local](#disable-local-printer-redirection-client) + [Escolher se deseja desabilitar o redirecionamento para cartão inteligente](#disable-local-smart-card-support-client) + [Defina configurações adicionais do cliente de WorkSpaces aplicativos para seus usuários](#configure-client) + [Usando a política de grupo para personalizar a experiência do cliente em WorkSpaces aplicativos](#configure-client-with-adm-template-group-policy) ## Fazer download da ferramenta Enterprise Deployment Tool A Enterprise Deployment Tool inclui os arquivos de instalação do cliente WorkSpaces Applications e um modelo administrativo de Política de Grupo. 1. Para baixar a Enterprise Deployment Tool, na parte inferior direita da página de [clientes compatíveis com WorkSpaces aplicativos](https://clients.amazonappstream.com), selecione o link **Enterprise Deployment Tool**. Esse link abre um arquivo .zip que contém os arquivos necessários para a versão mais recente da ferramenta. 1. Para extrair os arquivos necessários, navegue até o local em que você baixou a ferramenta, clique com o botão direito do mouse na pasta **AmazonAppStreamClientEnterpriseSetup\$1 \$1** e escolha **Extrair tudo**. A pasta contém dois programas de instalação e um modelo administrativo da Política de Grupo: + WorkSpaces Instalador do cliente de aplicativos (AmazonAppStreamClientSetup\$1 .msi) — Instala o WorkSpaces cliente de aplicativos. + WorkSpaces Instalador do driver USB de aplicativos (AmazonAppStreamUsbDriverSetup\$1 .exe) — Instala o driver USB de WorkSpaces aplicativos necessário para usar dispositivos USB com aplicativos transmitidos por meio de aplicativos. WorkSpaces + WorkSpaces Modelo administrativo da Política de Grupo do cliente de aplicativos (as2\$1client\$1config.adm) — Permite configurar o cliente de aplicativos por meio da Política de Grupo. WorkSpaces ## Instale o cliente de WorkSpaces aplicativos e o driver USB Depois de baixar os arquivos de instalação do cliente WorkSpaces Applications, execute o PowerShell script a seguir nos computadores dos usuários para instalar o arquivo de instalação do cliente WorkSpaces Applications, AppStreamClient .exe e o driver USB silenciosamente. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` Start-Process msiexec.exe -Wait -ArgumentList  '/i AmazonAppStreamClientSetup_.msi /quiet' Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList  '/quiet' ``` Depois de instalar a Enterprise Deployment Tool no computador de um usuário, o cliente de WorkSpaces aplicativos é instalado da seguinte forma: 1. O arquivo de instalação do cliente WorkSpaces Applications é copiado para o seguinte caminho no computador do usuário: C:\$1Program Files (x86)\$1 Amazon WorkSpaces Applications Client Installer\$1 AppStreamClient .exe. 1. Na primeira vez em que o usuário faz login no computador após a instalação da Enterprise Deployment Tool, o cliente de WorkSpaces aplicativos é instalado. **nota** Se a Enterprise Deployment Tool detectar que a pasta WorkSpaces Applications Client, **AppStreamClient**, já existe em **%localappdata%**, a ferramenta não instalará o cliente. Se um usuário desinstalar o cliente WorkSpaces Applications, o cliente não será instalado novamente até que você atualize a WorkSpaces Applications Enterprise Deployment Tool. ## Acessando WorkSpaces aplicativos com o cliente WorkSpaces de aplicativos Por padrão, quando os usuários iniciam o cliente de WorkSpaces aplicativos, eles só podem se conectar com URLs aqueles que incluem o domínio de WorkSpaces aplicativos ou domínios que incluem um registro DNS TXT que permite a conexão. Você pode permitir que os usuários do cliente acessem domínios que não WorkSpaces sejam o domínio Applications fazendo o seguinte: + Defina o valor de registro `StartURL` para especificar um URL personalizado que os usuários podem acessar, como o URL do portal de login da sua organização. + Defina o valor de registro `TrustedDomains` para especificar domínios confiáveis que os usuários podem acessar. + Crie o registro TXT de DNS `AS2TrustedDomains` para especificar domínios confiáveis que os usuários podem acessar. Esse método permite evitar alterações no registro. **nota** A configuração do cliente de WorkSpaces aplicativos e do registro TXT DNS não impede que os usuários usem outros métodos de conexão para acessar os domínios ou URLs que você especificar. Por exemplo, os usuários podem acessar domínios específicos ou URLs usando um navegador da Web, se tiverem acesso de rede aos domínios ou. URLs ## Definir o valor WorkSpaces do registro StartURL para usuários do Applications Client Você pode usar o valor `StartUrl` do registro para definir uma URL personalizada que é preenchida no cliente de WorkSpaces aplicativos quando um usuário inicia o cliente. É possível criar essa chave de registro HKLM ao instalar o cliente, para que os usuários não precisem especificar o URL ao iniciar o cliente. Depois que o cliente de WorkSpaces aplicativos for instalado, você poderá executar o PowerShell script a seguir para criar essa chave de registro ou usar o modelo administrativo incluído na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. Substitua o valor `StartUrl` pelo URL do seu provedor de identidade (IdP). O URL deve usar um certificado confiável para o dispositivo. Isso significa que o certificado usado pela página da Web `StartUrl` deve conter um Nome alternativo de assunto (SAN) que inclua o nome de domínio do URL. Por exemplo, se você `StartUrl` estiver definido como https://appstream.example.com, o certificado SSL deverá ter uma SAN que inclua appstream.example.com. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` $registryPath="HKLM:\Software\Amazon\AppStream Client" New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "StartUrl" -Value "https://www.example.com" -PropertyType String -Force | Out-Null ``` ## Defina o valor TrustedDomains do registro para habilitar outros domínios para o cliente de WorkSpaces aplicativos Você pode configurar o cliente WorkSpaces Applications para se conectar aos URLs domínios confiáveis que você especificar. Por exemplo, você pode permitir que os usuários se conectem a qualquer URL em seu domínio organizacional ou a qualquer URL em um ou mais dos seus domínios IdP. Ao especificar o URL, use o seguinte formato: \$1. *example*-*idp*. *com*. É possível especificar uma lista de domínios confiáveis em um formato separado por vírgulas. Adicione essa lista como um valor de registro à chave de registro `TrustedDomains` HKLM de WorkSpaces aplicativos. Recomendamos que você crie essa chave de registro e especifique a lista de domínios confiáveis ao instalar o cliente WorkSpaces Applications ou, se estiver usando o Microsoft Active Directory, por meio da Política de Grupo. Dessa forma, seus usuários podem se conectar a um URL em qualquer domínio confiável imediatamente após a instalação do cliente. Depois que o cliente WorkSpaces Applications for instalado, você poderá executar o PowerShell script a seguir para criar essa chave de registro. Ou você pode usar o modelo administrativo incluído na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. Substitua o valor `TrustedDomains` por uma lista separada por vírgulas para um ou mais dos seus domínios organizacionais ou IdP. O certificado usado pela página da Web do domínio confiável deve conter um SAN que inclua o domínio do URL. Por exemplo, se seu domínio confiável incluir \$1.example.com e os usuários especificarem, o certificado SSL deverá ter uma https://appstream.example.com SAN que inclua appstream.example.com. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` $registryPath="HKLM:\Software\Amazon\AppStream Client" New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "TrustedDomains" -Value "*.example1.com, *.example2.com, aws.amazon.com" -PropertyType String -Force | Out-Null ``` Veja a seguir os requisitos e considerações para a formatação de nomes de domínio confiáveis. + Os seguintes caracteres são compatíveis: a - z, 0 - 9, -, \$1 + O DNS trata o caractere \$1 como um caractere curinga ou como o caractere asterisco (ASCII 42), dependendo de onde ele aparece no nome de domínio. Veja a seguir as restrições ao usar \$1 como curinga no nome de um registro DNS: + O \$1 deve substituir o rótulo mais à esquerda em um nome de domínio. Por exemplo, \$1.example.com ou \$1.prod.example.com. Se você incluir o \$1 em outras posições, como prod.\$1.exemplo.com, o DNS o tratará como um caractere asterisco (ASCII 42), e não como um curinga. + O \$1 deve substituir todo o rótulo. Por exemplo, você não pode especificar \$1prod.exemplo.com ou prod\$1.exemplo.com. + O \$1 se aplica ao nível de subdomínio que inclui o \$1, e a todos os subdomínios desse subdomínio. Por exemplo, se uma entrada for chamada \$1.example.com, o cliente de WorkSpaces aplicativos permite zenith.example.com, acme.zenith.example.com e pinnacle.acme.zenith.example.com. ## Crie o registro AS2 TrustedDomains DNS TXT para habilitar seu domínio para o cliente de WorkSpaces aplicativos sem alterações no registro É possível permitir que os usuários se conectem a qualquer URL em seu domínio organizacional (por exemplo, \$1.example.com) ou a qualquer URL em seus domínios IdP (por exemplo, \$1.example-idp.com) criando um registro TXT de DNS nesse domínio. Ao criar o registro TXT de DNS, os valores de registro `StartURL` ou `TrustedDomains` não são necessários para permitir que um usuário se conecte a um URL. É possível especificar uma lista de subdomínios confiáveis em um formato separado por vírgulas, prefixado com `AS2TrustedDomains=`. Depois, crie um registro TXT de DNS para o domínio apropriado. O registro TXT de DNS `AS2TrustedDomains` só pode habilitar o mesmo domínio, ou subdomínios, do domínio no qual o registro TXT de DNS foi criado. Não é possível usar o registro TXT de DNS para habilitar outros domínios. Para obter mais informações sobre como configurar o registro DNS, consulte [Habilitar seu domínio organizacional para o cliente AppStream 2.0 com um registro TXT DNS do Route 53 e Criar um registro TXT AS2](https://aws.amazon.com/blogs/desktop-and-application-streaming/enable-your-organizational-domain-for-the-appstream-2-0-client-with-a-route-53-dns-txt-record/) [TrustedDomains DNS para redirecionar o cliente nativo AppStream 2.0 para um provedor de identidade terceirizado](https://aws.amazon.com/blogs/desktop-and-application-streaming/creating-an-as2trusteddomains-dns-txt-record-to-redirect-the-appstream-2-0-native-client-to-a-third-party-identity-provider/). **nota** Ao criar registros TXT de DNS, todos os usuários podem fazer streaming de domínios ativados não incluídos nos valores de registro `StartURL` ou `TrustedDomains`. A configuração do cliente de WorkSpaces aplicativos e do registro TXT DNS não impede que os usuários usem outros métodos de conexão para acessar os domínios ou URLs que você especificar. Por exemplo, os usuários podem acessar domínios específicos ou URLs usando um navegador da Web, se tiverem acesso de rede aos domínios ou. URLs ### Exemplo de configuração de registro TXT de DNS Veja a seguir um exemplo de uma configuração de registro TXT de DNS. Com a configuração desse exemplo, os usuários podem iniciar o cliente WorkSpaces Applications e se conectar a appstream.example.com ou appstream-dev.example.com. No entanto, eles não podem se conectar a example.com. + `Domains to enable`: appstream.example.com, appstream-dev.example.com + `DNS TXT record location`: example.com + `DNS TXT record value`— AS2 TrustedDomains =appstream.example.com, appstream-dev.example.com ### Requisitos e considerações Tenha em mente os seguintes requisitos e considerações para criar um registro TXT de DNS: + É necessário criar o registro TXT no domínio de segundo nível. Por exemplo, se seu domínio for prod.appstream.example.com, você deverá criar o registro TXT de DNS em example.com. + O valor do registro TXT deve começar com `AS2TrustedDomains=` + Os seguintes caracteres são compatíveis: a - z, 0 - 9, -, \$1 + O DNS trata o caractere \$1 como um caractere curinga ou como o caractere asterisco (ASCII 42), dependendo de onde ele aparece no nome de domínio. Veja a seguir as restrições ao usar \$1 como curinga no nome de um registro DNS: + O \$1 deve substituir o rótulo mais à esquerda em um nome de domínio. Por exemplo, \$1.example.com ou \$1.prod.example.com. Se você incluir o \$1 em outras posições, como prod.\$1.exemplo.com, o DNS o tratará como um caractere asterisco (ASCII 42), e não como um curinga. + O \$1 deve substituir todo o rótulo. Por exemplo, você não pode especificar \$1prod.exemplo.com ou prod\$1.exemplo.com. + O \$1 se aplica ao nível de subdomínio que inclui o \$1, e a todos os subdomínios desse subdomínio. Por exemplo, se uma entrada for chamada \$1.example.com, o cliente de WorkSpaces aplicativos permite conexões com os seguintes domínios: zenith.example.com, acme.zenith.example.com e pinnacle.acme.zenith.example.com. ## Desativar pesquisa de registro TXT de DNS para domínios confiáveis Por padrão, quando os usuários iniciam os WorkSpaces Aplicativos e especificam uma URL que não seja um domínio de WorkSpaces Aplicativos, o cliente realiza uma pesquisa no registro DNS TXT. A pesquisa é realizada no domínio de segundo nível do URL para que o cliente possa determinar se o domínio está incluído na lista `AS2TrustedDomains`. Esse comportamento permite que os usuários se conectem a domínios que não estão especificados nas chaves de `TrustedDomains` registro `StartURL` ou nos domínios de WorkSpaces aplicativos. Você pode desabilitar esse comportamento definindo o valor da chave de registro `DnsTxtRecordQueryDisabled` como `true`. Você pode criar essa chave de registro ao instalar o cliente WorkSpaces Applications. Dessa forma, o cliente se conecta somente URLs aos especificados pelas chaves de `TrustedDomains` registro `StartURL` ou. Depois que o cliente WorkSpaces Applications for instalado, você poderá executar o PowerShell script a seguir para criar essa chave de registro. Ou você pode usar o modelo administrativo incluído na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` $registryPath="HKLM:\Software\Amazon\AppStream Client" New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "DnsTxtRecordQueryDisabled" -Value "true" -PropertyType String -Force | Out-Null ``` ## Escolher se deseja desabilitar as atualizações automáticas do cliente Por padrão, quando uma nova versão do cliente WorkSpaces Applications está disponível, o cliente é atualizado automaticamente para a versão mais recente. Você pode desabilitar as atualizações automáticas definindo o valor da chave de registro `AutoUpdateDisabled` como `true`. Você pode criar essa chave de registro ao instalar o cliente WorkSpaces Applications. Dessa forma, o cliente não é atualizado automaticamente sempre que uma nova versão está disponível. Depois que o cliente WorkSpaces Applications for instalado, você poderá executar o PowerShell script a seguir para criar essa chave de registro. Ou você pode usar o modelo administrativo incluído na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` $registryPath="HKLM:\Software\Amazon\AppStream Client" New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "AutoUpdateDisabled" -Value "True" -PropertyType String -Force | Out-Null ``` ## Escolher se deseja desativar os uploads de log de diagnóstico sob demanda Por padrão, o cliente WorkSpaces Applications permite que os usuários carreguem logs de diagnóstico e minidumps sob demanda para WorkSpaces Applications ().AWS Além disso, se ocorrer uma exceção ou o cliente do WorkSpaces Applications parar de responder, os usuários serão solicitados a escolher se desejam carregar o minidump e os registros associados. Para obter mais informações sobre registro em log de diagnóstico sob demanda, consulte [Uploads de log de diagnóstico automáticos e sob demanda](feature-support-diagnostic-log-upload.md). Você pode desabilitar esses comportamentos definindo o valor da chave de registro `UserUploadOfClientLogsAllowed` como `false`. Você pode criar essa chave de registro HKLM ao instalar o cliente de WorkSpaces aplicativos. Depois que o cliente WorkSpaces Applications for instalado, você poderá executar o PowerShell script a seguir para criar essa chave de registro. Ou você pode usar o modelo administrativo incluído na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` $registryPath="HKLM:\Software\Amazon\AppStream Client" New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "UserUploadOfClientLogsAllowed" -Value "false" -PropertyType String -Force | Out-Null ``` ## Escolher se deseja desativar o modo de aplicativo nativo Por padrão, o cliente de WorkSpaces aplicativos pode ser executado no modo clássico ou no modo de aplicativo nativo. Você pode desabilitar o modo de aplicação nativa definindo o valor da chave de registro `NativeAppModeDisabled` como `true`. Você pode criar essa chave de registro HKLM ao instalar o cliente de WorkSpaces aplicativos. Se o valor for definido como `true`, o cliente será executado somente no modo clássico. Para obter informações sobre o modo de aplicativo nativo, consulte [Modo de aplicativo nativo](feature-support-native-application-mode.md). Depois que o cliente WorkSpaces Applications for instalado, você poderá executar o PowerShell script a seguir para criar essa chave de registro. Ou você pode usar o modelo administrativo incluído na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` $registryPath="HKLM:\Software\Amazon\AppStream Client" New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "NativeAppModeDisabled" -Value "True" -PropertyType String -Force | Out-Null ``` ## Escolher se deseja desabilitar o redirecionamento para impressora local Por padrão, o cliente de WorkSpaces aplicativos permite que os usuários redirecionem trabalhos de impressão de seus aplicativos de streaming para uma impressora conectada ao computador local. Você pode desabilitar o redirecionamento para impressora local definindo o valor da chave de registro `PrinterRedirectionDisabled` como `true`. Você pode criar essa chave de registro HKLM ao instalar o cliente de WorkSpaces aplicativos. Se o valor for definido como `true`, o cliente não redirecionará os trabalhos de impressão das aplicações de streaming dos usuários para uma impressora conectada ao computador local. Depois de instalar o cliente WorkSpaces Applications, você pode executar o PowerShell script a seguir para criar essa chave de registro. Ou você pode usar o modelo administrativo incluído na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` $registryPath="HKLM:\Software\Amazon\AppStream Client" New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "PrinterRedirectionDisabled" -Value "True" -PropertyType String -Force | Out-Null ``` ## Escolher se deseja desabilitar o redirecionamento para cartão inteligente Por padrão, o redirecionamento do cartão inteligente está ativado para o cliente de WorkSpaces aplicativos. Quando esse recurso está ativado, os usuários podem usar leitores de cartão inteligente conectados aos computadores locais e aos cartões inteligentes durante as sessões de streaming de WorkSpaces aplicativos sem redirecionamento de USB. Durante as sessões de streaming de WorkSpaces aplicativos, os leitores de cartões inteligentes e cartões inteligentes dos usuários permanecem acessíveis para uso com aplicativos locais. O cliente redireciona as chamadas de API de cartão inteligente das aplicações de streaming dos usuários para o cartão inteligente local. Você pode desabilitar o redirecionamento para cartão inteligente definindo o valor da chave de registro `SmartCardRedirectionDisabled` como `true`. Você pode criar essa chave de registro HKLM ao instalar o cliente de WorkSpaces aplicativos. Se o valor for definido como`true`, seus usuários não poderão usar seus leitores de cartões inteligentes e cartões inteligentes durante uma sessão de streaming de WorkSpaces aplicativos sem o redirecionamento de USB. Nesse caso, os usuários não poderão fazer login nas aplicações de streaming usando um cartão inteligente conectado ao computador local, a menos que você [qualifique o dispositivo](qualify-usb-devices.md). Depois de qualificar o dispositivo, os usuários devem [compartilhar o dispositivo com os WorkSpaces Aplicativos](client-application-windows-how-to-share-usb-devices-user.md). Quando o redirecionamento de cartões inteligentes está desativado, durante as sessões de streaming de WorkSpaces aplicativos dos usuários, seus leitores de cartões inteligentes e cartões inteligentes não estão acessíveis para uso com aplicativos locais. Depois de instalar o cliente WorkSpaces Applications, você pode executar o PowerShell script a seguir para criar essa chave de registro. Ou você pode usar o modelo administrativo incluído na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. **nota** Para executar esse script, é necessário ter feito login no computador aplicável com permissões de administrador. Você também pode executar o script remotamente na conta do System (Sistema) na inicialização. ``` $registryPath="HKLM:\Software\Amazon\AppStream Client" New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "SmartCardRedirectionDisabled" -Value "True" -PropertyType String -Force | Out-Null ``` ## Defina configurações adicionais do cliente de WorkSpaces aplicativos para seus usuários O cliente WorkSpaces Applications usa chaves de registro para definir as seguintes configurações adicionais do cliente: + WorkSpaces Aceitação do Contrato de Licença de Usuário Final (EULA) do cliente de aplicativos + WorkSpaces Versão EULA do cliente de aplicativos aceita + Carregamentos automáticos de registros de diagnóstico para o cliente de WorkSpaces aplicativos + Atualizações automáticas para o driver USB usado para passar drivers USB para WorkSpaces aplicativos + Ativando a renderização de hardware no cliente de WorkSpaces aplicativos + Configurando caminhos de pasta personalizados para redirecionamento do sistema de arquivos no cliente de WorkSpaces aplicativos + Abrir o URL do provedor de identidades (IdP) no navegador padrão do sistema + Adicionar um indicador para fornecer feedback visual em tempo real sobre a perda de dados de streaming A tabela a seguir resume os valores do registro para configurações adicionais do cliente que você pode usar para personalizar a experiência do cliente de WorkSpaces aplicativos para seus usuários. **nota** Esses valores diferenciam maiúsculas de minúsculas. | Valor | Caminho de registro | Tipo | Description | Dados | | --- | --- | --- | --- | --- | | EULAAccepted | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Defina esse valor true para aceitar o EULA do cliente de WorkSpaces aplicativos em nome de seus usuários. | true/false | | AcceptedEULAVersion | HKCU\$1Software\$1Amazon\$1Appstream Client | String | A versão do EULA que é aceito. Se a versão atual do EULA do cliente de WorkSpaces aplicativos for diferente da versão do EULA aceita, os usuários serão solicitados a aceitar a versão atual do EULA. | 1.0 | | DiagnosticInfoCollectionAllowed | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Defina esse valor true para permitir que os WorkSpaces aplicativos enviem automaticamente os registros de diagnóstico do cliente de WorkSpaces aplicativos para os WorkSpaces aplicativos (AWS). | true/false | | USBDriverOptIn | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Defina esse valor true para permitir que os WorkSpaces aplicativos atualizem automaticamente o driver USB usado para passar os drivers USB para os WorkSpaces aplicativos. | true/false | | HardwareRenderingEnabled | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Defina esse valor para true habilitar a renderização de hardware no cliente de WorkSpaces aplicativos. | true/false | | FileRedirectionCustomDefaultFolders | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Defina esse valor para incluir pelo menos um caminho de pasta para redirecionamento do sistema de arquivos. Separe vários caminhos de pastas usando '\$1'. Por padrão, os seguintes caminhos de pasta são especificados: %USERPROFILE%\$1Desktop\$1%USERPROFILE%\$1Documents\$1%USERPROFILE%\$1Downloads | Valid folder path | | OpenIdpUrlInSystemBrowser | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Defina esse valor true para permitir que o cliente de WorkSpaces aplicativos abra a URL do IdP em um navegador padrão do sistema. Esse recurso é compatível com a versão 1.1.1360 e posterior do cliente. | true/false | | DataLossIndicator | HKCU\$1Software\$1Amazon\$1Appstream Client | String | Defina esse valor como SHOW\$1ON\$1LOSSY para incluir um indicador de aviso vermelho quando houver perda de dados de streaming. Defina esse valor como SHOW\$1ON\$1LOSSLESS para incluir um indicador verde íntegro quando não houver perda de dados de streaming. | DISABLED/SHOW\$1ON\$1LOSSY/SHOW\$1ON\$1LOSSLESS | Depois que o cliente WorkSpaces Applications for instalado, você poderá executar o PowerShell script a seguir para criar essas chaves de registro. Se não desejar criar todas as chaves do Registro, modifique o script conforme necessário para criar apenas as chaves do Registro desejadas. Ou você pode usar o modelo administrativo fornecido na Ferramenta de Implantação Corporativa do cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. **nota** É necessário definir as entradas a seguir para cada usuário. ``` $registryPath="HKCU:\Software\Amazon\AppStream Client" New-Item -Path "HKCU:\Software\Amazon" -Name "AppStream Client" -Force New-ItemProperty -Path $registryPath -Name "EULAAccepted" -Value "true" -PropertyType String -Force | Out-Null New-ItemProperty -Path $registryPath -Name "AcceptedEULAVersion" -Value "1.0" -PropertyType String -Force | Out-Null New-ItemProperty -Path $registryPath -Name "DiagnosticInfoCollectionAllowed" -Value "true" -PropertyType String -Force | Out-Null New-ItemProperty -Path $registryPath -Name "USBDriverOptIn" -Value "true" -PropertyType String -Force | Out-Null New-ItemProperty -Path $registryPath -Name "HardwareRenderingEnabled" -Value "true" -PropertyType String -Force | Out-Null New-ItemProperty -Path $registryPath -Name "FileRedirectionCustomDefaultFolders" -Value "%USERPROFILE%\Desktop|%USERPROFILE%\Documents|%USERPROFILE%\Downloads" -PropertyType String -Force | Out-Null New-ItemProperty -Path $registryPath -Name "OpenIdpUrlInSystemBrowser" -Value "true" -PropertyType String -Force | Out-Null ``` ## Usando a política de grupo para personalizar a experiência do cliente em WorkSpaces aplicativos Você pode usar o modelo administrativo fornecido na Ferramenta de Implantação Corporativa do Cliente de WorkSpaces Aplicativos para configurar o cliente por meio da Política de Grupo. ​Para saber como carregar modelos administrativos no Console de Gerenciamento de Política de Grupo, consulte [Recomendações para gerenciar arquivos de modelo administrativo (.adm) de diretivas de grupo](https://support.microsoft.com/en-us/help/816662/recommendations-for-managing-group-policy-administrative-template-adm) na documentação de Suporte da Microsoft. # Atualize manualmente a ferramenta de implantação corporativa de WorkSpaces aplicativos, o cliente e o driver USB Por padrão, o cliente de WorkSpaces aplicativos e o driver USB são atualizados automaticamente quando uma nova versão do cliente é lançada. No entanto, se você usou a Ferramenta de Implantação Corporativa para instalar o cliente de WorkSpaces Aplicativos para seus usuários e desativou as atualizações automáticas, deverá atualizar a Ferramenta de Implantação Corporativa de WorkSpaces Aplicativos, o cliente e o driver USB manualmente. Para fazer isso, execute as etapas a seguir para executar os PowerShell comandos necessários nos computadores dos usuários. **nota** Para executar esses comandos, você deverá estar conectado ao computador aplicável como administrador ou poderá executar o script remotamente na conta SYSTEM na inicialização. O uso da Enterprise Deployment Tool para gerenciar o cliente macOS de WorkSpaces aplicativos não é suportado. 1. Desinstale silenciosamente o WorkSpaces Applications Enterprise Deployment Tool: ``` Start-Process msiexec.exe -Wait -ArgumentList '/x AmazonAppStreamClientSetup_.msi /quiet' ``` 1. Desinstale o driver USB dos WorkSpaces aplicativos silenciosamente: ``` Start-Process -Wait AmazonAppStreamUsbDriverSetup_.exe -ArgumentList '/uninstall /quiet /norestart' ``` 1. Desinstale o cliente de WorkSpaces aplicativos silenciosamente: ``` Start-Process "$env:LocalAppData\AppStreamClient\Update.exe" -ArgumentList '--uninstall' ``` **nota** Esse processo também remove as chaves de registro usadas para configurar o cliente de WorkSpaces aplicativos. Depois de reinstalar o cliente WorkSpaces Applications, você deve recriar essas chaves. 1. Limpe o diretório de instalação do aplicativo: ``` Remove-Item -Path $env:LocalAppData\AppStreamClient -Recurse -Confirm:$false –Force ``` 1. Reinicie o computador: ``` Restart-computer ``` 1. Instale silenciosamente a versão mais recente da WorkSpaces Applications Enterprise Deployment Tool: ``` Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_.msi /quiet' ``` 1. Instale silenciosamente a versão mais recente do driver USB de WorkSpaces aplicativos: ``` Start-Process AmazonAppStreamUsbDriverSetup_.exe -Wait -ArgumentList '/quiet' ``` # 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” # Configure um método de conexão para seus usuários do WorkSpaces Applications Client Depois de instalar o cliente de WorkSpaces aplicativos nos computadores locais dos usuários, eles podem usar o cliente de WorkSpaces aplicativos para se conectar a uma sessão de streaming. Dependendo dos seus requisitos organizacionais, você pode fornecer aos usuários clientes acesso aos WorkSpaces aplicativos fazendo o seguinte: Configurando a federação de identidades usando o SAML 2.0, usando um grupo de usuários de WorkSpaces aplicativos ou criando uma URL de streaming. **Topics** + [SAML 2.0](use-client-start-streaming-session-SAML.md) + [WorkSpaces Pool de usuários de aplicativos](use-client-start-streaming-session-user-pool.md) + [URL de streaming](use-client-start-streaming-session-streaming-URL.md) + [Próximas etapas](use-client-start-streaming-session-next-steps.md) # SAML 2.0 Se você usa provedores de identidade externos para federar seus usuários em uma pilha de WorkSpaces aplicativos, você deve criar um valor de registro para configurar o cliente de WorkSpaces aplicativos com uma URL pré-preenchida sempre que o cliente for iniciado. O URL deve usar um certificado confiável para o dispositivo. O certificado deve conter um nome de assunto alternativo (SAN) que inclui o nome de domínio do URL. Para obter mais informações, consulte: + [Configuração do SAML](external-identity-providers-setting-up-saml.md) + [Definir o valor WorkSpaces do registro StartURL para usuários do Applications Client](install-client-configure-settings.md#set-start-url-registry-value) # WorkSpaces Pool de usuários de aplicativos Quando você cria um novo usuário no grupo de usuários dos WorkSpaces Aplicativos ou atribui um usuário do grupo de usuários a uma pilha de WorkSpaces Aplicativos, os WorkSpaces Aplicativos enviam e-mails aos usuários em seu nome. Os usuários inserem o URL que receberam no e-mail de boas-vindas, inserem suas credenciais e escolhem **Conectar**. Para obter mais informações, consulte [Grupos de usuários de WorkSpaces aplicativos da Amazon](user-pool.md). # URL de streaming Para criar um URL de streaming, use um dos seguintes métodos: + WorkSpaces Console de aplicativos + A ação [CreateStreamingda API de URL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) + O comando [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI Para criar um URL de streaming usando o console de WorkSpaces aplicativos, conclua as etapas no procedimento a seguir. **Para criar um URL de streaming usando o console de WorkSpaces aplicativos** 1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home). 1. No painel de navegação, escolha **Fleets**. 1. Na lista de frotas, escolha a frota que está associada à pilha para a qual você deseja criar um URL de streaming. Verifique se o status da frota é **Running (Em execução)**. 1. No painel de navegação, escolha **Pilhas**. Selecione a pilha e escolha **Ações**, **Criar URL de streaming**. 1. Em **ID de usuário**, insira o ID do usuário. 1. Em **Validade do URL**, selecione um tempo de expiração para determinar a validade do URL gerado. Esse URL é válido por no máximo sete dias. 1. Escolha **Gerar URL**. 1. Copie o URL, salve-o em um local acessível e forneça-o aos usuários. **Na página de login do cliente WorkSpaces Applications, os usuários inserem a URL de streaming que você criou como endereço da web e, em seguida, escolhem Connect.** # Próximas etapas Depois de configurar um método de conexão do cliente, você pode fornecer aos usuários as seguintes step-by-step orientações para ajudá-los a se conectar aos WorkSpaces aplicativos e iniciar uma sessão de streaming: [Conecte-se a WorkSpaces aplicativos no Windows Client](client-application-windows-start-streaming-session-user.md) ou[Conecte-se a WorkSpaces aplicativos no cliente macOS](client-application-mac-start-streaming-session-user.md). # Permita que os usuários compartilhem um dispositivo USB com uma sessão de streaming de WorkSpaces aplicativos Antes de os usuários compartilharem seus dispositivos USB com uma sessão de WorkSpaces aplicativos, os dispositivos USB devem ser qualificados. Caso contrário, quando os usuários iniciarem uma sessão de streaming, o dispositivo USB não será detectado pelos WorkSpaces aplicativos e não poderá ser compartilhado com a sessão. Para obter mais informações, consulte [Qualifique dispositivos USB para uso com aplicativos de streaming](qualify-usb-devices.md). **nota** O compartilhamento de um dispositivo USB com uma sessão de streaming de WorkSpaces aplicativos não é suportado no cliente macOS. # Redirecionar uma sessão de streaming do navegador da Web para o cliente de WorkSpaces aplicativos Você pode configurar WorkSpaces aplicativos para redirecionar uma sessão de streaming de um navegador da web para o cliente de WorkSpaces aplicativos. Dessa forma, quando seus usuários fazem login nos WorkSpaces Aplicativos e iniciam uma sessão de streaming no navegador da Web, a sessão é redirecionada para o cliente de WorkSpaces Aplicativos. Para fazer isso, siga estas etapas. 1. Use a ação da `CreateStreamingURL` API de WorkSpaces aplicativos para gerar um URL de streaming. 1. Adicione o seguinte prefixo para o manipulador de cliente de WorkSpaces aplicativos personalizado ao URL de streaming: **amazonappstream:** Juntos, o prefixo e o URL de streaming são formatados da seguinte forma: **amazonappstream:***base64encoded(streamingURL)* **nota** Ao codificar a URL, verifique se a codificação está em UTF-8. Exemplo do Powershell para codificar: `[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("Streaming/IdpURL"))` 1. Quando os usuários são redirecionados para o URL de streaming, o navegador detecta que o link deve ser aberto pelo cliente de WorkSpaces aplicativos. 1. Os usuários são solicitados a escolher se desejam iniciar a sessão de streaming usando o cliente de WorkSpaces aplicativos. 1. Após o prompt, ocorre uma das seguintes situações: + Se o cliente de WorkSpaces aplicativos estiver instalado, o usuário poderá optar por continuar a sessão de streaming usando o cliente de WorkSpaces aplicativos. + Se o cliente WorkSpaces Applications não estiver instalado, o comportamento do navegador varia da seguinte forma: + Chrome: nenhuma mensagem é exibida. + Firefox — Uma mensagem informa que o usuário precisa de um novo aplicativo para abrir a Amazon AppStream. + Microsoft Edge: nenhuma mensagem é exibida. + Internet Explorer — Uma mensagem notifica o usuário de que o cliente de WorkSpaces aplicativos não está instalado. Nesse caso, os usuários podem selecionar o link **Download AppStream Client** para baixar o cliente. Após fazer download do cliente, eles podem instalá-lo e atualizar o navegador para iniciar a sessão de streaming usando o cliente. ## Criar um atalho da área de trabalho do Windows usando o navegador padrão Para criar um atalho da área de trabalho do Windows usando o navegador padrão para iniciar o cliente, use o seguinte exemplo de script PowerShell. ``` $StringToEncode = 'your URL string' $encodedUrl = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($StringToEncode)) $shortcutContent = " [{000214A0-0000-0000-C000-000000000046}] Prop3=19,0 [InternetShortcut] IDList= URL=amazonappstream:$encodedUrl IconIndex=0 HotKey=0 IconFile=$env:USERPROFILE\AppData\Local\AppStreamClient\appstreamclient.exe " Set-Content -Path "$env:USERPROFILE\Desktop\AppStream 2.0 Client Launcher.url" -Value $shortcutContent ``` # Ative o redirecionamento do sistema de arquivos para os usuários de seus WorkSpaces aplicativos WorkSpaces O redirecionamento do sistema de arquivos de aplicativos permite que os usuários que têm o cliente de WorkSpaces aplicativos instalado acessem arquivos no computador local a partir da sessão de streaming. Ao habilitar o redirecionamento do sistema de arquivos, você pode especificar a lista de unidades e pastas locais que os seus usuários podem escolher acessar. Quando os usuários fazem login nos WorkSpaces Aplicativos e iniciam uma sessão de streaming, eles podem escolher a unidade ou a pasta que desejam acessar na lista. Em seguida, eles podem compartilhar a unidade ou a pasta com WorkSpaces os aplicativos. A unidade ou a pasta permanece disponível para eles acessarem durante suas sessões de streaming. Os usuários podem parar de compartilhar suas unidades ou pastas locais a qualquer momento. **nota** No momento, o redirecionamento para sistema de arquivos não é compatível com instâncias de frota baseadas em Linux ou ao usar o cliente macOS. **Topics** + [Pré-requisitos para o redirecionamento do sistema de arquivos](file-system-redirection-prerequisites.md) + [Como habilitar o redirecionamento do sistema de arquivos](how-to-enable-file-system-redirection.md) + [Disponibilizar unidades e pastas padrão para que os usuários compartilhem](prepopulate-drives-folders-system-redirection.md) + [Forneça aos usuários de seus WorkSpaces aplicativos orientações para trabalhar com o redirecionamento do sistema de arquivos](end-user-guidance-file-system-redirection.md) # Pré-requisitos para o redirecionamento do sistema de arquivos Para habilitar o redirecionamento de arquivos de WorkSpaces aplicativos: + Você deve usar uma imagem que use uma versão do agente de WorkSpaces aplicativos lançada em ou após 8 de agosto de 2019. Para obter mais informações, consulte [WorkSpaces Notas de versão do Agente de Aplicativos](agent-software-versions.md). + Seus usuários devem ter a versão 1.0.480 ou posterior do cliente de WorkSpaces aplicativos instalada. Para obter mais informações, consulte [WorkSpaces Notas de versão do Windows Client de aplicativos](client-release-versions.md). + O upload e o download de arquivos devem estar habilitados na pilha que os usuários acessam para sessões de streaming. Consulte o procedimento a seguir. # Como habilitar o redirecionamento do sistema de arquivos Execute as etapas a seguir para habilitar o upload e o download de arquivos na pilha que os usuários acessam para sessões de streaming. 1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home). 1. No painel de navegação à esquerda, selecione**Pilhas**. 1. Escolha a pilha para a qual você deseja habilitar o redirecionamento do sistema de arquivos. 1. Escolha a guia **User Settings (Configurações do usuário)** e expanda a seção **Clipboard, file transfer e local print permissions (Permissões de área de transferência, transferência de arquivos e impressão local)**. 1. Em **File transfer (Transferência de arquivos)**, verifique se a opção **Upload and download (Fazer upload e download)** está selecionada. Caso contrário, escolha **Edit (Editar)** e selecione **Upload and download (Fazer upload e download)**. 1. Selecione **Atualizar**. # Disponibilizar unidades e pastas padrão para que os usuários compartilhem Por padrão, quando você habilita o direcionamento de arquivos para usuários de uma pilha, as seguintes unidades e pastas são disponibilizadas para que esses usuários compartilhem em suas sessões de streaming: + Unidades: + Todos os discos rígidos locais (unidades físicas, como as unidades C e D) + Todas as unidades virtuais (unidades virtuais e de rede, como letras de unidades mapeadas, Google Drive e OneDrive) + Todas as unidades USB locais + Pastas: + %USERPROFILE%\$1Desktop + %USERPROFILE%\$1Documents + %USERPROFILE%\$1Downloads Esses caminhos de unidades e pastas preenchem automaticamente a caixa de diálogo **Share your local drives and folders (Compartilhar suas unidades e pastas locais)**. Essa caixa de diálogo é exibida quando os usuários fazem login nos WorkSpaces Aplicativos, iniciam uma sessão de streaming e escolhem **Configurações**, **Recursos locais** **e Unidades e pastas** locais. Você pode alterar ou definir seus próprios caminhos de unidades e pastas padrão editando o registro. Você também pode usar o arquivo de modelo administrativo fornecido na Ferramenta de Implantação Empresarial do cliente de WorkSpaces aplicativos. Esse modelo permite que você configure o cliente usando a Política de Grupo. Para obter mais informações, consulte [Instalar e configurar o cliente WorkSpaces de aplicativos](install-configure-client.md). Quando os usuários acessam suas unidades e pastas locais compartilhadas durante uma sessão de streaming, os caminhos correspondentes aparecem com barras invertidas substituídas por sublinhados. Eles também recebem um sufixo com o nome do computador local e uma letra de unidade. Por exemplo, para um usuário com o nome de usuário janedoe e o nome de computador ExampleCorp -123456, os caminhos padrão das pastas Desktop, Documentos e Downloads aparecem da seguinte forma: C\$1Users\$1Janedoe\$1Desktop (\$1\$1 -123456) (F:) ExampleCorp C\$1Users\$1Janedoe\$1Documents (\$1\$1 -123456) (G:) ExampleCorp C\$1Users\$1Janedoe\$1Downloads (\$1\$1 -123456) (H:) ExampleCorp # Forneça aos usuários de seus WorkSpaces aplicativos orientações para trabalhar com o redirecionamento do sistema de arquivos Para ajudar os usuários a entender como trabalhar com o redirecionamento de arquivos durante as sessões de streaming, você poderá fornecer a eles as informações em [Acesso a arquivos locais](client-application-windows-file-system-redirection.md). # Ative o redirecionamento de impressora local para os usuários de seus WorkSpaces aplicativos Com o redirecionamento de impressora local, os usuários de seus WorkSpaces aplicativos podem redirecionar trabalhos de impressão do aplicativo de streaming para uma impressora conectada ao computador local, incluindo qualquer impressora de rede que os usuários tenham mapeado. Você não precisa de um driver de impressora instalado na instância de streaming do WorkSpaces Applications para permitir que os usuários imprimam documentos durante as sessões de streaming. **nota** Ainda não é possível habilitar o redirecionamento para impressora local em pilhas baseadas em Linux. **Topics** + [Pré-requisitos do redirecionamento para impressora local](local-printer-redirection-prerequisites.md) + [Como ativar o redirecionamento da impressora local](how-to-enable-disable-local-printer-redirection.md) + [Como desativar o redirecionamento da impressora local](disable-local-printer-redirection.md) # Pré-requisitos do redirecionamento para impressora local Para garantir que os usuários possam usar o redirecionamento para impressora local, você deve: + Use uma imagem que use uma versão do agente de WorkSpaces aplicativos lançada em ou após 30 de julho de 2020. Para obter mais informações, consulte [WorkSpaces Notas de versão do Agente de Aplicativos](agent-software-versions.md). + Certifique-se de que seus usuários tenham a versão 1.1.179 ou posterior do WorkSpaces Applications Client instalada. Para obter mais informações, consulte [WorkSpaces Notas de versão do Windows Client de aplicativos](client-release-versions.md). + Verificar se o redirecionamento para impressora está habilitado na pilha que os usuários acessam para sessões de streaming. # Como ativar o redirecionamento da impressora local Por padrão, o redirecionamento da impressora local é ativado quando o cliente de WorkSpaces aplicativos é instalado. No entanto, se o redirecionamento de impressora local não estiver habilitado na pilha que seus usuários acessam para sessões de streaming, você poderá ativá-lo no console de WorkSpaces aplicativos executando as etapas a seguir. **Para habilitar o redirecionamento da impressora local usando o console de WorkSpaces aplicativos** 1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home). 1. No painel de navegação à esquerda, selecione**Pilhas**. 1. Escolha a pilha para a qual você deseja habilitar o redirecionamento para impressora local. 1. Escolha a guia **Configurações do usuário** e expanda a seção **Área de transferência, transferência de arquivos, impressão em dispositivo local e permissões de autenticação**. 1. Em **Imprimir em dispositivo local**, verifique se a opção **Habilitada** está selecionada. Caso contrário, selecione **Editar** e escolha **Habilitada**. 1. Selecione **Atualizar**. Como alternativa, você pode ativar o redirecionamento da impressora local usando a API de WorkSpaces aplicativos, um AWS SDK ou o AWS Command Line Interface ()AWS CLI. # Como desativar o redirecionamento da impressora local Para desativar o redirecionamento da impressora local, siga estas etapas. **Como desabilitar o redirecionamento para impressora local** Você pode desabilitar o redirecionamento para impressora local de qualquer uma destas maneiras: + Durante a instalação do cliente em dispositivos gerenciados. Para obter mais informações, consulte [Escolher se deseja desabilitar o redirecionamento para impressora local](install-client-configure-settings.md#disable-local-printer-redirection-client). + Usando o console de WorkSpaces aplicativos para desativar essa opção em uma pilha de WorkSpaces aplicativos. + Usando a API de WorkSpaces aplicativos, um AWS SDK ou o AWS Command Line Interface (AWS CLI) para desativar essa opção em uma pilha de WorkSpaces aplicativos.