Configurer le client web Bureau à distance pour vos utilisateurs

Le client web Bureau à distance permet aux utilisateurs d'accéder à l'infrastructure Bureau à distance de votre organisation via un navigateur web compatible. Où qu'ils se trouvent, les utilisateurs peuvent alors interagir avec les applications ou appareils de bureau distants comme ils le feraient avec un PC local. Une fois votre client web Bureau à distance configuré, vos utilisateurs ont uniquement besoin de l'URL d'accès au client, de leurs informations d'identification et d'un navigateur web pris en charge.

Ce dont vous aurez besoin pour configurer le client web

Avant de commencer, gardez les points suivants à l'esprit :

• Assurez-vous que votre déploiement Bureau à distance dispose d'une passerelle de services Bureau à distance, d'un service Broker pour les connexions Bureau à distance et d'un accès aux services Bureau à distance par le web sous Windows Server 2016 ou 2019.

• Assurez-vous que votre déploiement est configuré pour utiliser des licences d'accès client par utilisateur et non par appareil, sinon toutes les licences sont utilisées.

• Installez la mise à jour KB4025334 de Windows 10 sur la passerelle des services Bureau à distance. Les mises à jour cumulatives ultérieures peuvent déjà contenir cette mise à jour.

• Assurez-vous que les certificats publics approuvés sont configurés pour les rôles Passerelle des services Bureau à distance et Accès aux services Bureau à distance par le web.

• Assurez-vous que tous les ordinateurs auxquels vos utilisateurs se connectent exécutent l'une des versions suivantes du système d'exploitation :

  • Windows 10 ou version ultérieure
  • Windows Server 2016 ou version ultérieure

Vous bénéficierez de meilleures performances en vous connectant à Windows Server 2016 (ou version ultérieure) et à Windows 10 (version 1611 ou ultérieure).

Si vous avez utilisé le client web pendant la phase de préversion et installé une la version 1.0.0 (ou une version antérieure), vous devez d'abord désinstaller l'ancien client avant de passer à la nouvelle version. Si vous recevez le message d'erreur « Le client web a été installé à l'aide d'une version antérieure de RDWebClientManagement et doit d'abord être supprimé avant de déployer la nouvelle version », procédez comme suit :

1. Ouvrez une invite PowerShell avec élévation de privilèges.
2. Exécutez Uninstall-Module RDWebClientManagement pour désinstaller le nouveau module.
3. Fermez et rouvrez l'invite PowerShell avec élévation de privilèges.
4. Exécutez Install-Module RDWebClientManagement -RequiredVersion <ancienne version> pour installer l'ancien module.
5. Exécutez Uninstall-RDWebClient pour désinstaller l’ancien client web.
6. Exécutez Uninstall-Module RDWebClientManagement pour désinstaller l’ancien module.
7. Fermez et rouvrez l'invite PowerShell avec élévation de privilèges.
8. Passez aux étapes normales d'installation décrites ci-dessous.

Publier le client web Bureau à distance

Pour installer le client web, procédez comme suit :

1. Sur le serveur du service Broker pour les connexions Bureau à distance, procurez-vous le certificat utilisé pour les connexions Bureau à distance et exportez-le au format .cer. À partir du service Broker pour les connexions Bureau à distance, copiez le fichier .cer sur le serveur exécutant le rôle Accès aux services Bureau à distance par le web.

2. Sur le serveur d'accès aux services Bureau à distance par le web, ouvrez une invite PowerShell avec élévation de privilèges.

3. Sous Windows Server 2016, mettez à jour le module PowerShellGet, car la version de la boîte de réception ne prend pas en charge l'installation du module de gestion du client web. Pour mettre à jour le module PowerShellGet, exécutez l'applet de commande suivante :

   Install-Module -Name PowerShellGet -Force
   

   Note

   Pour accéder à PowerShell Gallery, tls (Transport Layer Security) 1.2 ou version ultérieure est requis. Utilisez la commande suivante pour activer TLS 1.2 dans votre session PowerShell :

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

   Important

   Vous devrez redémarrer PowerShell pour que la mise à jour prenne effet, sinon le module risque de ne pas fonctionner.

4. Installez le module PowerShell de gestion du client web Bureau à distance à partir de la galerie PowerShell avec l'applet de commande suivante :

   Install-Module -Name RDWebClientManagement
   

5. Puis exécutez l'applet de commande suivante pour télécharger la dernière version du client web Bureau à distance :

   Install-RDWebClientPackage
   

6. Exécutez ensuite l'applet de commande suivante en remplaçant la valeur entre crochets par le chemin du fichier .cer que vous avez copié à partir du service Broker Bureau à distance :

   Import-RDWebClientBrokerCert <.cer file path>
   

7. Enfin, exécutez l'applet de commande suivante pour publier le client web Bureau à distance :

   Publish-RDWebClientPackage -Type Production -Latest
   

   Vérifiez que vous avez accès au client web via l'URL avec le nom de votre serveur, au format https://server_FQDN/RDWeb/webclient/index.html. Il est important d'utiliser le nom du serveur qui correspond au certificat public d'accès aux services Bureau à distance par le web dans l'URL (il s'agit généralement du nom de domaine complet du serveur).

   Note

   Lors de l’exécution de l’applet de commande Publish-RDWebClientPackage , vous pouvez voir un avertissement indiquant que les licences d’accès client par appareil ne sont pas prises en charge, même si votre déploiement est configuré pour les licences d’accès client par utilisateur. Si votre déploiement utilise des licences d'accès client par utilisateur, vous pouvez ignorer cet avertissement. Nous l’affichons pour vous informer des limites de la configuration.

8. Lorsque vous êtes prêt à autoriser les utilisateurs à accéder au client web, il vous suffit de leur envoyer l'URL que vous avez créée pour le client web.

Get-Command -Module RDWebClientManagement

Mettre à jour le client web Bureau à distance

Lorsqu'une nouvelle version du client web Bureau à distance est disponible, procédez comme suit pour mettre à jour le déploiement avec le nouveau client :

1. Ouvrez une invite PowerShell avec élévation de privilèges sur le serveur d'accès aux services Bureau à distance par le web et exécutez l'applet de commande suivante pour télécharger la dernière version disponible du client web :

   Install-RDWebClientPackage
   

2. Si vous le souhaitez, vous pouvez tester le client avant sa publication officielle en exécutant l'applet de commande suivante :

   Publish-RDWebClientPackage -Type Test -Latest
   

   Le client doit apparaître sur l'URL de test correspondant à l'URL de votre client web (par exemple, <https://server_FQDN/RDWeb/webclient-test/index.html>).

3. Publiez le client pour les utilisateurs en exécutant l'applet de commande suivante :

   Publish-RDWebClientPackage -Type Production -Latest
   

   Cela remplace le client pour tous les utilisateurs lorsqu'ils relanceront la page web.

Désinstaller le client web Bureau à distance

Pour supprimer toute trace du client web, procédez comme suit :

1. Sur le serveur d'accès aux services Bureau à distance par le web, ouvrez une invite PowerShell avec élévation de privilèges.

2. Annulez la publication des clients de test et de production, désinstallez tous les packages locaux et supprimez les paramètres du client web :

   Uninstall-RDWebClient
   

3. Désinstallez le module PowerShell de gestion du client web Bureau à distance :

   Uninstall-Module -Name RDWebClientManagement
   

Installer le client web Bureau à distance sans connexion Internet

Suivez les étapes ci-dessous pour déployer le client web sur un serveur d'accès aux services Bureau à distance par le web dépourvu de connexion Internet.

À partir d'un appareil connecté à Internet

1. Ouvrez une fenêtre PowerShell.

2. Importez le module PowerShell de gestion du client web Bureau à distance à partir de la galerie PowerShell :

   Import-Module -Name RDWebClientManagement
   

3. Téléchargez la dernière version du client web Bureau à distance pour l'installer sur un autre appareil :

   Save-RDWebClientPackage "C:\WebClient\"
   

4. Téléchargez la dernière version du module PowerShell RDWebClientManagement :

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

5. Copiez le contenu de « C:\WebClient » sur le serveur d’accès aux services Bureau à distance par le web.

À partir du serveur d'accès aux services Bureau à distance par le web

Suivez les instructions fournies à la section Publier le client web Bureau à distance en remplaçant les étapes 4 et 5 par les suivantes.

1. Vous avez deux options pour récupérer le module PowerShell de gestion des clients web le plus récent :

   1. Importez le module PowerShell de gestion des clients web Bureau à distance :

      Import-Module -Name RDWebClientManagement
      

   2. Copiez le dossier RDWebClientManagement téléchargé dans l’un des dossiers de module PowerShell locaux répertoriés sous $env :psmodulePath, ou ajoutez le chemin d’accès au dossier avec les fichiers téléchargés à l' $env :psmodulePath.

2. Déployez la dernière version du client web Bureau à distance à partir du dossier local (remplacez le fichier par le zip approprié) :

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

Connexion au service Broker Bureau à distance sans passerelle de services Bureau à distance dans Windows Server 2019

Cette section explique comment activer une connexion client web à un service Broker Bureau à distance sans passerelle de services Bureau à distance dans Windows Server 2019.

Configuration du serveur du service Broker Bureau à distance

Suivez les étapes ci-dessous si aucun certificat n'est lié au serveur du service Broker Bureau à distance

1. Ouvrez lesservices Bureau à distancedu Gestionnaire> de serveur.

2. Dans la section Vue d’ensemble du déploiement , sélectionnez le menu déroulant Tâches .

3. Sélectionnez Modifier les propriétés de déploiement. Une nouvelle fenêtre intitulée Propriétés de déploiement s'ouvre alors.

4. Dans la fenêtre Propriétés du déploiement , sélectionnez Certificats dans le menu de gauche.

5. Dans la liste des Niveaux de certification, sélectionnez Service Broker pour les connexions Bureau à distance - Activer l'authentification unique. Deux options s'offrent à vous : (1) créer un nouveau certificat ou (2) utiliser un certificat existant.

Suivez les étapes ci-dessous si un certificat a précédemment été lié au serveur du service Broker Bureau à distance

1. Ouvrez le certificat lié au répartiteur et copiez la valeur de l’empreinte numérique.

2. Pour lier ce certificat au port sécurisé 3392, ouvrez une fenêtre PowerShell avec élévation de privilèges et exécutez la commande suivante, en remplaçant "<thumbprint>" par la valeur copiée à l’étape précédente :

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

   Note

   Pour vérifier que le certificat est correctement lié, exécutez la commande suivante :

   netsh http show sslcert
   

   Dans la liste des liaisons de certificat SSL, assurez-vous que le certificat qui convient est lié au port 3392.

3. Ouvrez le Registre Windows (regedit), accédez à HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp la clé WebSocketURI. Ensuite, affectez la valeur https://+:3392/rdp/.

Configuration de l'Hôte de session Bureau à distance

Suivez les étapes ci-dessous si le serveur Hôte de session Bureau à distance est différent du serveur du service Broker Bureau à distance :

1. Créez un certificat pour l’ordinateur hôte de session Bureau à distance, ouvrez-le et copiez la valeur de l’empreinte numérique.

2. Pour lier ce certificat au port sécurisé 3392, ouvrez une fenêtre PowerShell avec élévation de privilèges et exécutez la commande suivante, en remplaçant "<thumbprint>" par la valeur copiée à l’étape précédente :

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

   Note

   Pour vérifier que le certificat est correctement lié, exécutez la commande suivante :

   netsh http show sslcert
   

   Dans la liste des liaisons de certificat SSL, assurez-vous que le certificat qui convient est lié au port 3392.

3. Ouvrez le Registre Windows (regedit) et accédez à HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\WinStations\RDP-Tcp la clé WebSocketURI. Elle doit avoir la valeur https://+:3392/rdp/.

Observations générales

Assurez-vous que l'Hôte de session Bureau à distance et le serveur du service Broker Bureau à distance exécutent Windows Server 2019.

Assurez-vous que des certificats publics approuvés sont configurés pour l'Hôte de session Bureau à distance et le serveur du service Broker Bureau à distance.

L'autre nom de l'objet (SAN) de chaque certificat doit être défini sur le nom de domaine complet (FQDN) de l'ordinateur. Le nom commun (CN) doit correspondre au SAN pour chaque certificat.

Préconfigurer les paramètres pour les utilisateurs du client web Bureau à distance

Cette section explique comment utiliser PowerShell pour configurer les paramètres de déploiement de votre client web Bureau à distance. Ces applets de commande PowerShell déterminent la capacité d'un utilisateur à modifier les paramètres en fonction des préoccupations de sécurité de votre organisation ou du flux de travail prévu. Les paramètres suivants se trouvent tous dans le panneau latéral Paramètres du client web.

Supprimer les données de télémétrie

Par défaut, les utilisateurs peuvent choisir d'activer ou de désactiver la collecte des données de télémétrie envoyées à Microsoft. Pour plus d’informations sur les données de télémétrie collectées par Microsoft, reportez-vous à notre déclaration de confidentialité via le lien dans le volet Latéral À propos .

En tant qu'administrateur, vous pouvez choisir de supprimer la collecte de données de télémétrie pour votre déploiement à l'aide de l'applet de commande PowerShell suivante :

Set-RDWebClientDeploymentSetting -Name "SuppressTelemetry" $true

Par défaut, l'utilisateur peut activer ou désactiver les données de télémétrie. Une valeur booléenne $false correspond au comportement du client par défaut. Une valeur booléenne $true désactive la télémétrie et empêche l’utilisateur d’activer la télémétrie.

Méthode de lancement de ressources distantes

Par défaut, les utilisateurs peuvent choisir de lancer des ressources distantes (1) dans le navigateur ou (2) en téléchargeant un fichier .rdp à gérer avec un autre client installé sur leur ordinateur. En tant qu’administrateur, vous pouvez choisir de limiter la méthode de lancement de ressources distantes de votre déploiement à l’aide de la commande PowerShell suivante :

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

Par défaut, l'utilisateur peut sélectionner l'une ou l'autre des méthodes de lancement. Une valeur booléenne $true force l’utilisateur à lancer des ressources dans le navigateur. Une valeur booléenne $false force l’utilisateur à lancer des ressources en téléchargeant un .rdp fichier pour gérer avec un client RDP installé localement.

Rétablir les configurations RDWebClientDeploymentSetting par défaut

Pour rétablir un paramètre client web de niveau déploiement à la configuration par défaut, exécutez l’applet de commande PowerShell suivante et utilisez le paramètre -name pour spécifier le paramètre que vous souhaitez rétablir :

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

Troubleshooting

Si un utilisateur signale l'un des problèmes suivants lors de l'ouverture du client web, les sections suivantes vous expliqueront comment y remédier.

Que faire si le navigateur de l'utilisateur affiche un avertissement de sécurité lorsqu'il tente d'accéder au client web ?

Le rôle Accès aux services Bureau à distance par le web n'utilise peut-être pas de certificat approuvé. Assurez-vous que le rôle Accès aux services Bureau à distance par le web est configuré avec un certificat public approuvé.

Si le problème persiste, il se peut que le nom de votre serveur dans l'URL du client web ne corresponde pas au nom fourni par le certificat d'accès aux services Bureau à distance par le web. Assurez-vous que votre URL utilise le nom de domaine complet du serveur qui héberge le rôle Accès aux services Bureau à distance par le web.

Que faire si l'utilisateur ne parvient pas à se connecter à une ressource avec le client web alors qu'il voit les éléments sous Toutes les ressources ?

Si l'utilisateur signale qu'il ne parvient pas à se connecter au client web alors qu'il voit les ressources répertoriées, vérifiez les points suivants :

• Le rôle Passerelle des services Bureau à distance est-il correctement configuré pour utiliser un certificat public approuvé ?
• Les mises à jour requises sont-elles installées sur le serveur de passerelle Bureau à distance ? Assurez-vous que la mise à jour KB4025334 est installée sur votre serveur.

Si l'utilisateur reçoit le message d'erreur « Un certificat d'authentification serveur inattendu a été reçu » lorsqu'il tente de se connecter, le message contient l'empreinte du certificat. Recherchez le gestionnaire de certificat du serveur du service Broker Bureau à distance à l'aide de cette empreinte pour trouver le bon certificat. Vérifiez que le certificat est configuré pour le rôle Service Broker Bureau à distance sur la page des propriétés du déploiement Bureau à distance. Après vous être assuré que le certificat n'a pas expiré, copiez-le au format .cer sur le serveur d'accès aux services Bureau à distance par le web et exécutez la commande suivante sur le serveur d'accès aux services Bureau à distance par le web, en remplaçant la valeur entre crochets par le chemin du certificat :

Import-RDWebClientBrokerCert <certificate file path>

Diagnostiquer les problèmes liés au journal de la console

Si vous ne parvenez pas à résoudre le problème en suivant les instructions de résolution fournies dans cet article, vous pouvez essayer de diagnostiquer vous-même la source du problème en consultant le journal de la console dans le navigateur. Le client web fournit une méthode pour enregistrer l'activité du journal de la console du navigateur tout en utilisant le client web pour diagnostiquer les problèmes.

• Sélectionnez les points de suspension dans le coin supérieur droit et accédez à la page À propos du menu déroulant.
• Sous Capturer les informations de support, sélectionnez le bouton Démarrer l'enregistrement.
• Dans le client web, reproduisez la ou les opérations qui ont généré le problème que vous essayez de diagnostiquer.
• Accédez à la page À propos et sélectionnez Arrêter l’enregistrement.
• Votre navigateur télécharge automatiquement un fichier .txt intitulé RD Console Logs.txt. Ce fichier contient l'activité complète du journal de la console générée lors de la reproduction du problème cible.

Vous pouvez également accéder directement à la console à partir de votre navigateur. La console se trouve sous les outils de développement. Par exemple, vous pouvez accéder à la connexion à Microsoft Edge en appuyant sur la touche F12 ou en sélectionnant les points de suspension, puis en accédant à Plus d’outils>de développement Outils de développement.

Obtenir de l’aide sur le client web

Si vous rencontrez un problème que les informations contenues dans cet article ne permettent pas de résoudre, vous pouvez le signaler sur le forum Azure Virtual Desktop de Microsoft Tech Community.