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á.

Tutorial: Instale o cliente Amazon AppStream 2.0 e personalize a experiência do cliente para seus usuários

As seções a seguir descrevem como instalar o cliente AppStream 2.0 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 AppStream 2.0 e definir as configurações do cliente remotamente.

Fazer download da ferramenta Enterprise Deployment Tool

A Enterprise Deployment Tool inclui os arquivos de instalação do cliente AppStream 2.0 e um modelo administrativo de Política de Grupo.

Instale o cliente AppStream 2.0 e o driver USB

Depois de baixar os arquivos de instalação do cliente AppStream 2.0, execute o PowerShell script a seguir nos computadores dos usuários para instalar o arquivo de instalação do cliente AppStream 2.0, AppStreamClient .exe e o driver USB silenciosamente.

Start-Process msiexec.exe -Wait -ArgumentList  '/i AmazonAppStreamClientSetup_<version>.msi /quiet'

Start-Process AmazonAppStreamUsbDriverSetup_<version>.exe -Wait -ArgumentList  '/quiet'

Depois de instalar a Enterprise Deployment Tool no computador do usuário, o cliente AppStream 2.0 é instalado da seguinte forma:

Se um usuário desinstalar o cliente AppStream 2.0, o cliente não será instalado novamente até que você atualize a AppStream 2.0 Enterprise Deployment Tool.

Acessando AppStream 2.0 com o cliente AppStream 2.0

Por padrão, quando os usuários iniciam o cliente AppStream 2.0, eles podem se conectar somente ao URLs domínio AppStream 2.0 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 sejam o domínio AppStream 2.0 fazendo o seguinte:

Definir o valor AppStream do registro StartUrl para usuários do cliente 2.0

Você pode usar o valor StartUrl do registro para definir uma URL personalizada que é preenchida no cliente AppStream 2.0 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 AppStream 2.0 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 Empresarial do cliente AppStream 2.0 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.

$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 AppStream 2.0

Você pode configurar o cliente AppStream 2.0 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: *. 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 AppStream 2.0 TrustedDomains HKLM. Recomendamos que você crie essa chave de registro e especifique a lista de domínios confiáveis ao instalar o cliente AppStream 2.0 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 AppStream 2.0 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 Empresarial do cliente AppStream 2.0 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 *.example.com e os usuários especificarem, o certificado SSL deverá ter uma https://appstream.example.com SAN que inclua appstream.example.com.

$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.

Crie o registro AS2 TrustedDomains DNS TXT para habilitar seu domínio para o cliente AppStream 2.0 sem alterações no registro

É possível permitir que os usuários se conectem a qualquer URL em seu domínio organizacional (por exemplo, *.example.com) ou a qualquer URL em seus domínios IdP (por exemplo, *.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 TrustedDomains DNS para redirecionar o cliente nativo AppStream 2.0 para um provedor de identidade terceirizado.

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 AppStream 2.0 e se conectar a appstream.example.com ou appstream-dev.example.com. No entanto, eles não podem se conectar a example.com.

Requisitos e considerações

Tenha em mente os seguintes requisitos e considerações para criar um registro TXT de DNS:

Desativar pesquisa de registro TXT de DNS para domínios confiáveis

Por padrão, quando os usuários iniciam o AppStream 2.0 e especificam um URL que não seja um domínio AppStream 2.0, o cliente realiza uma pesquisa de 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 AppStream 2.0.

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 AppStream 2.0. Dessa forma, o cliente se conecta somente URLs aos especificados pelas chaves de TrustedDomains registro StartURL ou.

Depois que o cliente AppStream 2.0 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 Empresarial do cliente AppStream 2.0 para configurar o cliente por meio da Política de Grupo.

$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 AppStream 2.0 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 AppStream 2.0. Dessa forma, o cliente não é atualizado automaticamente sempre que uma nova versão está disponível.

Depois que o cliente AppStream 2.0 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 Empresarial do cliente AppStream 2.0 para configurar o cliente por meio da Política de Grupo.

$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 AppStream 2.0 permite que os usuários carreguem registros de diagnóstico e minidumps sob demanda para AppStream 2.0 ().AWS Além disso, se ocorrer uma exceção ou o cliente AppStream 2.0 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.

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 AppStream 2.0.

Depois que o cliente AppStream 2.0 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 Empresarial do cliente AppStream 2.0 para configurar o cliente por meio da Política de Grupo.

$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 AppStream 2.0 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 AppStream 2.0. 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.

Depois que o cliente AppStream 2.0 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 Empresarial do cliente AppStream 2.0 para configurar o cliente por meio da Política de Grupo.

$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 AppStream 2.0 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 AppStream 2.0. 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 AppStream 2.0, 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 Empresarial do cliente AppStream 2.0 para configurar o cliente por meio da Política de Grupo.

$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á habilitado para o cliente AppStream 2.0. 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 AppStream 2.0 sem redirecionamento de USB. Durante as sessões de streaming AppStream 2.0, 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 AppStream 2.0.

Se o valor estiver definido comotrue, seus usuários não poderão usar seus leitores de cartões inteligentes e cartões inteligentes durante uma sessão de streaming AppStream 2.0 sem redirecionamento 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. Depois de qualificar o dispositivo, os usuários devem compartilhar o dispositivo com AppStream 2.0. Quando o redirecionamento de cartão inteligente está desativado, durante as sessões de streaming AppStream 2.0 dos usuários, seus leitores de cartão inteligente e cartões inteligentes não estão acessíveis para uso com aplicativos locais.

Depois de instalar o cliente AppStream 2.0, 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 Empresarial do cliente AppStream 2.0 para configurar o cliente por meio da Política de Grupo.

$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 AppStream 2.0 para seus usuários

O cliente AppStream 2.0 usa chaves de registro para definir as seguintes configurações adicionais do cliente:

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 AppStream 2.0 para seus usuários.

Depois que o cliente AppStream 2.0 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 Empresarial do cliente AppStream 2.0 para configurar o cliente por meio da Política de Grupo.

$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 AppStream 2.0

Você pode usar o modelo administrativo fornecido na Ferramenta de Implantação Empresarial do cliente AppStream 2.0 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 na documentação de Suporte da Microsoft.