Configurar o cliente Web da Área de Trabalho Remota para seus usuários

O cliente Web da Área de Trabalho Remota permite que os usuários acessem a infraestrutura de Área de Trabalho Remota da sua organização por meio de um navegador da Web compatível. Eles poderão interagir com aplicativos remotos ou ambientes de trabalho como fariam com um PC local, independentemente de onde estejam. Depois de configurar seu cliente Web da Área de Trabalho Remota, tudo o que todos os usuários precisam para começar é a URL onde podem acessar o cliente, suas credenciais e um navegador da Web compatível.

O que você precisará para configurar o cliente Web

Antes de começar, tenha em mente as seguintes coisas:

• Certifique-se de sua Implantação de Área de Trabalho Remota tenha um Gateway de Área de Trabalho Remota, um Agente de Conexão de Área de Trabalho Remota e acesso à Área de Trabalho Remota pela Web em execução no Windows Server 2016 ou 2019.

• Verifique se sua implantação está configurada para licenças de acesso para cliente por usuário (CALs) e não por dispositivo; caso contrário, todas as licenças serão consumidas.

• Instale a atualização KB4025334 do Windows 10 no Gateway RD. É provável que atualizações cumulativas posteriores já contenham esta KB.

• Certifique-se de que certificados confiáveis públicos estejam configurados para as funções de Gateway de Área de Trabalho Remota e Acesso pela Web à Área de Trabalho Remota.

• Verifique se todos os computadores aos quais os usuários se conectam estão executando uma das seguintes versões do sistema operacional:

  • Windows 10 ou posterior
  • Windows Server 2016 ou posterior

Você terá melhor desempenho quando conectar-se ao Windows Server 2016 (ou posterior) e ao Windows 10 (versão 1611 ou posterior).

Se você usou o cliente da Web no período de teste e instalou a versão 1.0.0 ou anterior, deverá primeiro desinstalar o cliente antigo antes de migrar para a nova versão. Caso receba um erro informando "O cliente da Web foi instalado usando uma versão do RDWebClientManagement e deve ser removido antes da implantação de uma nova versão", siga estas etapas:

1. Abra um prompt do PowerShell elevado.
2. Execute Uninstall-Module RDWebClientManagement para desinstalar o novo módulo.
3. Feche e reabra o prompt do PowerShell com privilégios elevados.
4. Execute a versão antiga do Install-Module RDWebClientManagement -RequiredVersion <> para instalar o módulo antigo.
5. Execute Uninstall-RDWebClient para desinstalar o cliente Web antigo.
6. Execute Uninstall-Module RDWebClientManagement para desinstalar o módulo antigo.
7. Feche e reabra o prompt do PowerShell com privilégios elevados.
8. Prossiga com as etapas normais de instalação da seguinte maneira.

Como publicar o cliente Web da Área de Trabalho Remota

Para instalar o cliente Web pela primeira vez, siga estas etapas:

1. No servidor do Agente de Conexão de Área de Trabalho Remota, obtenha o certificado usado para conexões da Área de Trabalho Remota e exporte-o como um arquivo .cer. Copie o arquivo .cer do Agente de Conexão de Área de Trabalho Remota para o servidor que estiver executando a função Web da Área de Trabalho Remota.

2. No servidor de acesso via Web RD, abra um prompt elevado do PowerShell.

3. No Windows Server 2016, atualize o módulo PowerShellGet, pois a versão da caixa de entrada não dá suporte à instalação do módulo de gerenciamento de cliente Web. Para atualizar o PowerShellGet, execute o seguinte cmdlet:

   Install-Module -Name PowerShellGet -Force
   

   Note

   Para acessar a Galeria do PowerShell, o TLS (Transport Layer Security) 1.2 ou superior é necessário. Use o seguinte comando para habilitar o TLS 1.2 em sua sessão do PowerShell:

   [Net.ServicePointManager]::SecurityProtocol =
   [Net.ServicePointManager]::SecurityProtocol -bor
   [Net.SecurityProtocolType]::Tls12
   

   Important

   Você precisará reiniciar o PowerShell para que a atualização entre em vigor; caso contrário, é provável que o módulo não funcione.

4. Instale o módulo PowerShell de gerenciamento de cliente Web da Área de Trabalho Remota da galeria do PowerShell com este cmdlet:

   Install-Module -Name RDWebClientManagement
   

5. Depois disso, execute o seguinte cmdlet para baixar a versão mais recente do cliente Web da Área de Trabalho Remota:

   Install-RDWebClientPackage
   

6. Execute este cmdlet com o valor entre colchetes substituído pelo caminho do arquivo .cer que você copiou do Agente de Área de Trabalho Remota:

   Import-RDWebClientBrokerCert <.cer file path>
   

7. Por fim, execute este cmdlet para publicar o cliente Web da Área de Trabalho Remota:

   Publish-RDWebClientPackage -Type Production -Latest
   

   Verifique se você pode acessar o cliente web na URL do cliente web com o nome do servidor, formatado como https://server_FQDN/RDWeb/webclient/index.html. É importante usar o nome do servidor que corresponde ao certificado público de Acesso via Web à Área de Trabalho Remota na URL (normalmente o FQDN do servidor).

   Note

   Ao executar o cmdlet Publish-RDWebClientPackage , você poderá ver um aviso informando que as CALs por dispositivo não têm suporte, mesmo que sua implantação esteja configurada para CALs por usuário. Se a implantação usar CALs por usuário, você poderá ignorar esse aviso. A exibimos para garantir que você esteja ciente da limitação de configuração.

8. Quando estiver pronto para que os usuários acessem o cliente Web, basta enviar a URL do cliente Web que você criou.

Get-Command -Module RDWebClientManagement

Como atualizar o cliente Web da Área de Trabalho Remota

Quando uma nova versão do cliente Web da Área de Trabalho Remota estiver disponível, siga estas etapas para atualizar a implantação com o novo cliente:

1. Abra um prompt do PowerShell com privilégios elevados no servidor rd web access e execute o seguinte cmdlet para baixar a versão mais recente disponível do cliente Web:

   Install-RDWebClientPackage
   

2. Opcionalmente, você pode publicar o cliente para teste antes do lançamento oficial executando este cmdlet:

   Publish-RDWebClientPackage -Type Test -Latest
   

   O cliente deve aparecer na URL de teste que corresponde à URL do cliente Web (por exemplo, <https://server_FQDN/RDWeb/webclient-test/index.html>).

3. Publique o cliente para usuários executando o seguinte cmdlet:

   Publish-RDWebClientPackage -Type Production -Latest
   

   Isso substitui o cliente para todos os usuários quando eles relançam a página da Web.

Como desinstalar o cliente Web da Área de Trabalho Remota

Para remover todos os rastreamentos do cliente Web, siga estas etapas:

1. No servidor de acesso via Web RD, abra um prompt elevado do PowerShell.

2. Desinstale os clientes de Teste e Produção, desinstale todos os pacotes locais e remova as configurações do cliente Web:

   Uninstall-RDWebClient
   

3. Desinstale o módulo PowerShell de gerenciamento de cliente web da Área de Trabalho Remota:

   Uninstall-Module -Name RDWebClientManagement
   

Como instalar o cliente Web da Área de Trabalho Remota sem uma conexão com a Internet

Siga estas etapas para implantar o cliente Web em um servidor rd web access que não tenha uma conexão com a Internet.

De um dispositivo com acesso à Internet

1. Abra uma janela do PowerShell.

2. Importe o módulo do PowerShell do gerenciamento de cliente da Web de Área de Trabalho Remota da galeria do PowerShell:

   Import-Module -Name RDWebClientManagement
   

3. Baixe a versão mais recente do cliente Web da Área de Trabalho Remota para instalação em um dispositivo diferente:

   Save-RDWebClientPackage "C:\WebClient\"
   

4. Baixe a versão mais recente do módulo RDWebClientManagement PowerShell:

   Find-Module -Name "RDWebClientManagement" -Repository "PSGallery" | Save-Module -Path "C:\WebClient\"
   

5. Copie o conteúdo de "C:\WebClient" para o servidor de Acesso à Web RD.

No servidor de Acesso via Web da Área de Trabalho Remota

Siga as instruções em Como publicar o cliente Web da Área de Trabalho Remota, substituindo as etapas 4 e 5 pelo seguinte.

1. Você tem duas opções para recuperar o módulo mais recente do PowerShell de gerenciamento de cliente Web:

   1. Importe o módulo do PowerShell de gerenciamento de cliente Web de Área de Trabalho Remota:

      Import-Module -Name RDWebClientManagement
      

   2. Copie a pasta RDWebClientManagement baixada para uma das pastas de módulo local do PowerShell listadas em $env:psmodulePath ou adicione o caminho à pasta com os arquivos baixados ao $env:psmodulePath.

2. Implante a versão mais recente do cliente Web da Área de Trabalho Remota da pasta local (substitua pelo arquivo zip apropriado):

   Install-RDWebClientPackage -Source "C:\WebClient\rdwebclient-1.0.1.zip"
   

Conecte-se ao Agente de Área de Trabalho Remota sem o Gateway de Área de Trabalho Remota no Windows Server de 2019

Esta seção descreve como habilitar uma conexão de cliente da Web com um Agente de Área de Trabalho Remota sem um Gateway de Área de Trabalho Remota no Windows Server 2019.

Como configurar o servidor do Agente de Área de Trabalho Remota

Siga estas etapas se não houver nenhum certificado vinculado ao servidor RD Broker

1. Abra osServiços de Área de Trabalho Remota do > Gerenciador de Servidores.

2. Na seção Visão geral da implantação , selecione o menu suspenso Tarefas .

3. Selecione Editar Propriedades de Implantação. Uma nova janela intitulada Propriedades de Implantação será aberta.

4. Na janela Propriedades da Implantação , selecione Certificados no menu à esquerda.

5. Na lista de Níveis de Certificado, selecione Agente de Conexão de Área de Trabalho Remota – Habilitar Logon Único. Você tem duas opções: (1) criar um novo certificado ou (2) um certificado existente.

Siga estas etapas se houver um certificado anteriormente associado ao servidor do Agente de Área de Trabalho Remota

1. Abra o certificado associado ao Agente e copie o valor da impressão digital .

2. Para associar esse certificado à porta segura 3392, abra uma janela do PowerShell com privilégios elevados e execute o seguinte comando, substituindo "< impressão digital >" pelo valor copiado da etapa anterior:

   netsh http add sslcert ipport=0.0.0.0:3392 certhash="<thumbprint>" certstorename="Remote Desktop" appid="{00000000-0000-0000-0000-000000000000}"
   

   Note

   Para verificar se o certificado está associado corretamente, execute o seguinte comando:

   netsh http show sslcert
   

   Na lista de associações de Certificado SSL, verifique se o certificado correto está associado à porta 3392.

3. Abra o Registro do Windows (regedit), acesse HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp e localize a chave WebSocketURI. Em seguida, defina o valor como https://+:3392/rdp/.

Configurando o Host da Sessão RD

Siga estas etapas se o servidor de Host da Sessão de Área de Trabalho Remota for diferente do servidor do Agente de Área de Trabalho Remota:

1. Crie um certificado para o computador host da sessão rd, abra-o e copie o valor da impressão digital .

2. Para associar esse certificado à porta segura 3392, abra uma janela do PowerShell com privilégios elevados e execute o seguinte comando, substituindo "< impressão digital >" pelo valor copiado da etapa anterior:

   netsh http add sslcert ipport=0.0.0.0:3392 certhash="<thumbprint>" appid="{00000000-0000-0000-0000-000000000000}"
   

   Note

   Para verificar se o certificado está associado corretamente, execute o seguinte comando:

   netsh http show sslcert
   

   Na lista de associações de Certificado SSL, verifique se o certificado correto está associado à porta 3392.

3. Abra o Registro do Windows (regedit) e navegue até HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp e localize a chave WebSocketURI. O valor deve ser definido como https://+:3392/rdp/.

Observações gerais

Certifique-se de que o Host de Sessão de Área de Trabalho Remota e o servidor do Agente de Área de Trabalho Remota estejam executando o Windows Server 2019.

Certifique-se de que certificados públicos confiáveis estejam configurados tanto no Host de Sessão de Área de Trabalho Remota quanto no servidor do Agente de Área de Trabalho Remota.

O Nome Alternativo da Entidade (SAN) para cada certificado deve ser definido para o Nome de Domínio Totalmente Qualificado (FQDN) da máquina. O Nome Comum (CN) precisa corresponder ao SAN de cada certificado.

Como pré-configurar configurações para usuários do cliente web da Área de Trabalho Remota

Esta seção informa como usar o PowerShell para definir as configurações para a implantação do cliente Web da Área de Trabalho Remota. Esses cmdlets do PowerShell controlam a capacidade de um usuário de alterar as configurações com base nas preocupações de segurança da sua organização ou no fluxo de trabalho pretendido. As configurações a seguir estão todas localizadas no painel lateral Configurações do cliente Web.

Suprimir telemetria

Por padrão, os usuários podem optar por habilitar ou desabilitar a coleta de dados de telemetria enviados à Microsoft. Para obter informações sobre os dados de telemetria coletados pela Microsoft, consulte nossa Política de Privacidade por meio do link no painel sobre lado.

Como administrador, você pode optar por suprimir a coleta de telemetria para sua implantação usando o seguinte cmdlet do PowerShell:

Set-RDWebClientDeploymentSetting -Name "SuppressTelemetry" $true

Por padrão, o usuário pode optar por habilitar ou desabilitar a telemetria. Um valor booliano $false corresponderá ao comportamento padrão do cliente. Um valor booliano $true desabilita a telemetria e restringe o usuário de habilitar a telemetria.

Método de inicialização de recursos remotos

Por padrão, os usuários podem optar por iniciar recursos remotos (1) no navegador ou (2) baixando um arquivo .rdp para administrar outro cliente instalado no computador. Como administrador, você pode optar por restringir o método de inicialização de recursos remotos para sua implantação com o seguinte comando do PowerShell:

Set-RDWebClientDeploymentSetting -Name "LaunchResourceInBrowser" ($true|$false)

Por padrão, o usuário pode selecionar um método de inicialização. Um valor booliano $true forçará o usuário a iniciar recursos no navegador. Um valor booliano $false força o usuário a iniciar recursos baixando um .rdp arquivo para lidar com um cliente RDP instalado localmente.

Redefinir configurações RDWebClientDeploymentSetting como padrão

Para redefinir uma configuração de cliente Web no nível de implantação para a configuração padrão, execute o seguinte cmdlet do PowerShell e use o parâmetro -name para especificar a configuração que você deseja redefinir:

Reset-RDWebClientDeploymentSetting -Name "LaunchResourceInBrowser"
Reset-RDWebClientDeploymentSetting -Name "SuppressTelemetry"

Troubleshooting

Se um usuário relatar um destes problemas ao abrir o cliente Web pela primeira vez, as seções a seguir explicarão como proceder para corrigi-los.

O que fazer se o navegador do usuário mostrar um aviso de segurança ao tentar acessar o cliente Web

A função Acesso via Web à Área de Trabalho Remota talvez não esteja usando um certificado confiável. Verifique se a função Acesso via Web à Área de Trabalho Remota está configurada com um certificado confiável publicamente.

Se isso não funcionar, o nome do servidor na URL do cliente Web poderá não corresponder ao nome fornecido pelo certificado Web de área de trabalho remota. Verifique se a URL usa o FQDN do servidor que hospeda a função Web do RD.

O que fazer se o usuário não puder se conectar a um recurso com o cliente Web, mesmo que ele possa ver os itens em Todos os Recursos

Se o usuário relatar que não pode se conectar ao cliente Web mesmo que possa ver os recursos listados, verifique o seguinte:

• A função do Gateway de Área de Trabalho Remota está configurada corretamente para usar um certificado público confiável?
• O servidor de Gateway de Área de Trabalho Remota tem as atualizações necessárias instaladas? Certifique-se de que o servidor tem a atualização KB4025334 instalada.

Se o usuário receber um erro "certificado de autenticação de servidor inesperado recebido" ao tentar se conectar, a mensagem mostrará a impressão digital do certificado. Pesquise o gerenciador de certificados do servidor RD Broker usando essa impressão digital para encontrar o certificado correto. Verifique se o certificado está configurado para ser usado para a função de Agente de Área de Trabalho Remota na página de propriedades da implantação de Área de Trabalho Remota. Após verificar se o certificado não expirou, copie-o no formato de arquivo .cer para o servidor de Acesso via Web à Área de Trabalho Remota e execute o seguinte comando no servidor de Acesso via Web à Área de Trabalho Remota com o valor entre colchetes substituído pelo caminho do arquivo do certificado:

Import-RDWebClientBrokerCert <certificate file path>

Diagnosticar problemas com o log de console

Se as instruções de solução de problemas neste artigo não bastarem para resolver o problema, tente diagnosticar a origem do problema observando o logon do console no navegador. O cliente Web fornece um método para gravar a atividade de log do console do navegador ao usar o cliente Web para ajudar a diagnosticar problemas.

• Selecione as reticências no canto superior direito e navegue até a página Sobre no menu suspenso.
• Em Capturar informações de suporte selecione o botão Iniciar gravação.
• Execute uma ou mais operações no cliente Web que geraram o problema que você está tentando diagnosticar.
• Navegue até a página Sobre e selecione Parar gravação.
• O navegador baixará automaticamente um arquivo .txt intitulado RD Console Logs.txt. Esse arquivo contém a atividade de log completa do console gerada ao reproduzir o problema em questão.

Você também pode acessar o console diretamente pelo navegador. O console está localizado nas ferramentas para desenvolvedores. Por exemplo, você pode acessar a entrada no Microsoft Edge pressionando a tecla F12 ou selecionando as reticências e navegando até Ferramentas de Desenvolvedor do Mais ferramentas>.

Obter ajuda com o cliente Web

Se você tiver encontrado um problema que não pode ser resolvido pelas informações deste artigo, poderá denunciá-lo no fórum da Área de Trabalho Virtual do Azure do Microsoft Tech Community.