Skip to content
A boolean value This setting currently only works with the RDS web client, not the Windows Virtual Desktop web client.By default, users may choose to launch remote resources (1) in the browser or (2) by downloading an .rdp file to handle with another client installed on their machine. They'll be able to interact with remote apps or desktops like they would with a local PC no matter where they are. Configurer le client web Bureau à distance pour vos utilisateursSet up the Remote Desktop web client for your usersLe client web Bureau à distance permet aux utilisateurs d'accéder à l'infrastructure Bureau à distance de votre organisation via un navigateur web compatible.The Remote Desktop web client lets users access your organization's Remote Desktop infrastructure through a compatible web browser.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.They'll be able to interact with remote apps or desktops like they would with a local PC no matter where they are.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.Once you set up your Remote Desktop web client, all your users need to get started is the URL where they can access the client, their credentials, and a supported web browser.Le client web prend bien en charge lâutilisation du Proxy dâapplication Azure AD mais pas du tout le Proxy dâapplication Web.The web client does support using Azure AD Application Proxy but does not support Web Application Proxy at all.Ce dont vous aurez besoin pour configurer le client webAvant de commencer, gardez les points suivants à l'esprit :Before getting started, keep the following things in mind:Assurez-vous que votre déploiement est configuré pour utiliser des Les mises à jour cumulatives ultérieures peuvent déjà contenir cette mise à jour.Later cumulative updates may already contains this KB.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.Make sure public trusted certificates are configured for the RD Gateway and RD Web Access roles.Assurez-vous que tous les ordinateurs auxquels vos utilisateurs se connecteront exécutent l'une des versions suivantes du système d'exploitation :Make sure that any computers your users will connect to are running one of the following OS versions:Vos utilisateurs bénéficieront de meilleures performances en se connectant à Windows Server 2016 (ou version ultérieure) et à Windows 10 (version 1611 ou ultérieure).Your users will see better performance connecting to Windows Server 2016 (or later) and Windows 10 (version 1611 or later).Si vous avez utilisé le client web pendant la phase de préversion et installé une version antérieure à la version 1.0.0, vous devez d'abord désinstaller l'ancien client avant de passer à la nouvelle version.If you used the web client during the preview period and installed a version prior to 1.0.0, you must first uninstall the old client before moving to the new 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 :If you receive an error that says "The web client was installed using an older version of RDWebClientManagement and must first be removed before deploying the new version," follow these steps:Ouvrez une invite PowerShell avec élévation de privilèges.Fermez et rouvrez l'invite PowerShell avec élévation de privilèges.Fermez et rouvrez l'invite PowerShell avec élévation de privilèges.Passez aux étapes normales d'installation décrites ci-dessous.Proceed with the normal installation steps as follows.Pour installer le client web, procédez comme suit :To install the web client for the first time, follow these steps: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.On the RD Connection Broker server, obtain the certificate used for Remote Desktop connections and export it as a .cer file.à 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.Copy the .cer file from the RD Connection Broker to the server running the RD Web role.Sur le serveur d'accès aux services Bureau à distance par le web, ouvrez une invite PowerShell avec élévation de privilèges.On the RD Web Access server, open an elevated PowerShell prompt.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.On Windows Server 2016, update the PowerShellGet module since the inbox version doesn't support installing the web client management module.Pour mettre à jour le module PowerShellGet, exécutez l'applet de commande suivante :Vous devrez redémarrer PowerShell pour que la mise à jour prenne effet, sinon le module risque de ne pas fonctionner.You'll need to restart PowerShell before the update can take effect, otherwise the module may not work.Installez le module PowerShell de gestion du client web Bureau à distance à partir de la galerie PowerShell avec l'applet de commande suivante :Install the Remote Desktop web client management PowerShell module from the PowerShell gallery with this cmdlet:Puis exécutez l'applet de commande suivante pour télécharger la dernière version du client web Bureau à distance :After that, run the following cmdlet to download the latest version of the Remote Desktop web client: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 :Next, run this cmdlet with the bracketed value replaced with the path of the .cer file that you copied from the RD Broker:Enfin, exécutez l'applet de commande suivante pour publier le client web Bureau à distance :Finally, run this cmdlet to publish the Remote Desktop web client:Vérifiez que vous avez accès au client web via l'URL avec le nom de votre serveur, au format Make sure you can access the web client at the web client URL with your server name, formatted as 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).It's important to use the server name that matches the RD Web Access public certificate in the URL (typically the server FQDN).Si votre déploiement utilise des licences d'accès client par utilisateur, vous pouvez ignorer cet avertissement.If your deployment uses per-user CALs, you can ignore this warning.Nous lâaffichons pour vous informer des limites de la configuration.We display it to make sure you're aware of the configuration limitation.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.When you're ready for users to access the web client, just send them the web client URL you created.Pour afficher la liste de toutes les applets de commande prises en charge pour le module RDWebClientManagement, exécutez l'applet de commande suivante dans PowerShell :To see a list of all supported cmdlets for the RDWebClientManagement module, run the following cmdlet in PowerShell: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 :When a new version of the Remote Desktop web client is available, follow these steps to update the deployment with the new client: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 :Open an elevated PowerShell prompt on the RD Web Access server and run the following cmdlet to download the latest available version of the web client:Si vous le souhaitez, vous pouvez tester le client avant sa publication officielle en exécutant l'applet de commande suivante :Optionally, you can publish the client for testing before official release by running this cmdlet:Le client doit apparaître sur l'URL de test correspondant à l'URL de votre client web (par exemple, The client should appear on the test URL that corresponds to your web client URL (for example, Publiez le client pour les utilisateurs en exécutant l'applet de commande suivante :Publish the client for users by running the following cmdlet:Cela remplacera le client pour tous les utilisateurs lorsqu'ils relanceront la page web.This will replace the client for all users when they relaunch the web page.Pour supprimer toute trace du client web, procédez comme suit :To remove all traces of the web client, follow these steps:Sur le serveur d'accès aux services Bureau à distance par le web, ouvrez une invite PowerShell avec élévation de privilèges.On the RD Web Access server, open an elevated PowerShell prompt.Annulez la publication des clients de test et de production, désinstallez tous les packages locaux et supprimez les paramètres du client web :Unpublish the Test and Production clients, uninstall all local packages and remove the web client settings:Désinstallez le module PowerShell de gestion du client web Bureau à distance :Uninstall the Remote Desktop web client management PowerShell module:Installer le client web Bureau à distance sans connexion InternetHow to install the Remote Desktop web client without an internet connectionSuivez 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.Follow these steps to deploy the web client to an RD Web Access server that doesn't have an internet connection.L'installation sans connexion Internet est disponible avec les versions 1.0.1 et ultérieures du module PowerShell RDWebClientManagement.Installing without an internet connection is available in version 1.0.1 and above of the RDWebClientManagement PowerShell module.Vous devez malgré tout disposer d'un PC administrateur avec accès Internet pour télécharger les fichiers nécessaires avant de les transférer vers le serveur hors ligne.You still need an admin PC with internet access to download the necessary files before transferring them to the offline server.Pour le moment, le PC de l'utilisateur final doit disposer d'une connexion Internet.The end-user PC needs an internet connection for now.Ce point sera traité dans une prochaine version du client afin de fournir un scénario hors ligne complet.This will be addressed in a future release of the client to provide a complete offline scenario.Importez le module PowerShell de gestion du client web Bureau à distance à partir de la galerie PowerShell :Import the Remote Desktop web client management PowerShell module from the PowerShell gallery:Téléchargez la dernière version du client web Bureau à distance pour l'installer sur un autre appareil :Download the latest version of the Remote Desktop web client for installation on a different device:Téléchargez la dernière version du module PowerShell RDWebClientManagement :Download the latest version of the RDWebClientManagement PowerShell module:Copiez le contenu de « C:\WebClient" » sur le serveur d'accès aux services Bureau à distance par le web.Copy the content of "C:\WebClient" to the RD Web Access server.à partir du serveur d'accès aux services Bureau à distance par le webVous avez deux options pour récupérer le module PowerShell de gestion des clients web le plus récent :You have two options to retrieve the latest web client management PowerShell module:Importez le module PowerShell de gestion des clients web Bureau à distance :Import the Remote Desktop web client management PowerShell module:Copiez le dossier RDWebClientManagement téléchargé dans un des dossiers de module PowerShell locaux listés sous Copy the downloaded RDWebClientManagement folder to one of the local PowerShell module folders listed under Déployez la dernière version du client web Bureau à distance à partir du dossier local (remplacez le fichier par le zip approprié) :Deploy the latest version of the Remote Desktop web client from the local folder (replace with the appropriate zip file):Connexion au service Broker Bureau à distance sans passerelle de services Bureau à distance dans Windows Server 2019Connecting to RD Broker without RD Gateway in Windows Server 2019Cette section explique comment activer une connexion client web à un service Broker Bureau à distance sans passerelle de services Bureau à distance dans Windows Server 2019.This section describes how to enable a web client connection to an RD Broker without an RD Gateway in Windows Server 2019.Configuration du serveur du service Broker Bureau à distanceSuivez les étapes ci-dessous si aucun certificat n'est lié au serveur du service Broker Bureau à distance.Follow these steps if there is no certificate bound to the RD Broker serverDans la liste des Niveaux de certification, sélectionnez Deux options s'offrent à vous : (1) créer un nouveau certificat ou (2) utiliser un certificat existant.You have two options: (1) create a new certificate or (2) an existing certificate.Suivez les étapes ci-dessous si un certificat a précédemment été lié au serveur du service Broker Bureau à distance :Follow these steps if there is a certificate previously bound to the RD Broker serverOuvrez le certificat lié au service Broker et copiez la valeur Open the certificate bound to the Broker and copy the 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 To bind this certificate to the secure port 3392, open an elevated PowerShell window and run the following command, replacing Pour vérifier que le certificat a été correctement lié, exécutez la commande suivante :To check if the certificate has been bound correctly, run the following command:Dans la liste des liaisons de certificat SSL, assurez-vous que le certificat qui convient est lié au port 3392.In the list of SSL Certificate bindings, ensure that the correct certificate is bound to port 3392.Open the Windows Registry (regedit) and nagivate to Configuration de l'Hôte de session Bureau à distanceSuivez les étapes ci-dessous si le serveur Hôte de session Bureau à distance est différent du serveur du service Broker Bureau à distance :Follow these steps if the RD Session Host server is different from the RD Broker server:Créez un certificat pour l'ordinateur Hôte de session Bureau à distance, ouvrez-le et copiez la valeur Create a certificate for the RD Session Host machine, open it and copy the 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 To bind this certificate to the secure port 3392, open an elevated PowerShell window and run the following command, replacing Pour vérifier que le certificat a été correctement lié, exécutez la commande suivante :To check if the certificate has been bound correctly, run the following command:Dans la liste des liaisons de certificat SSL, assurez-vous que le certificat qui convient est lié au port 3392.In the list of SSL Certificate bindings, ensure that the correct certificate is bound to port 3392.Open the Windows Registry (regedit) and nagivate to Assurez-vous que l'Hôte de session Bureau à distance et le serveur du service Broker Bureau à distance exécutent Windows Server 2019.Ensure that both the RD Session Host and RD Broker server are running 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.Ensure that public trusted certificates are configured for both the RD Session Host and RD Broker server.Si l'Hôte de session Bureau à distance et le serveur du service Broker Bureau à distance partagent le même ordinateur, définissez uniquement le certificat du serveur du service Broker Bureau à distance.If both the RD Session Host and the RD Broker server share the same machine, set the RD Broker server certificate only.Si l'Hôte de session Bureau à distance et le serveur du service Broker Bureau à distance utilisent des ordinateurs différents, les deux doivent être configurés avec des certificats uniques.If the RD Session Host and RD Broker server use different machines, both must be configured with unique certificates.Préconfigurer les paramètres pour les utilisateurs du client web Bureau à distanceHow to pre-configure settings for Remote Desktop web client usersCette section explique comment utiliser PowerShell pour configurer les paramètres de déploiement de votre client web Bureau à distance.This section will tell you how to use PowerShell to configure settings for your Remote Desktop web client deployment.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.These PowerShell cmdlets control a user's ability to change settings based on your organization's security concerns or intended workflow.Les paramètres suivants se trouvent tous dans le volet latéral 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.By default, users may choose to enable or disable collection of telemetry data that is sent to Microsoft.Pour plus d'informations sur les données de télémétrie collectées par Microsoft, consultez notre déclaration de confidentialité via le lien situé dans le volet latéral For information about the telemetry data Microsoft collects, please refer to our Privacy Statement via the link in the 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 :As an administrator, you can choose to suppress telemetry collection for your deployment using the following PowerShell cmdlet:Par défaut, l'utilisateur peut activer ou désactiver les données de télémétrie.By default, the user may select to enable or disable telemetry.Ce paramètre fonctionne uniquement avec le client web des services Bureau à distance et non avec le client web Windows Virtual Desktop.This setting currently only works with the RDS web client, not the Windows Virtual Desktop web client.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.By default, users may choose to launch remote resources (1) in the browser or (2) by downloading an .rdp file to handle with another client installed on their machine.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 :As an administrator, you can choose to restrict the remote resource launch method for your deployment with the following Powershell command:Par défaut, l'utilisateur peut sélectionner l'une ou l'autre des méthodes de lancement.By default, the user may select either launch method.Rétablir les configurations RDWebClientDeploymentSetting par défautReset RDWebClientDeploymentSetting configurations to defaultPour 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 :To reset a deployment-level web client setting to the default configuration, run the following PowerShell cmdlet and use the -name parameter to specify the setting you want to reset:Si un utilisateur signale l'un des problèmes suivants lors de l'ouverture du client web, les sections suivantes vous indiqueront comment y remédier.If a user reports any of the following issues when opening the web client for the first time, the following sections will tell you what to do to fix them.Que faire si le navigateur de l'utilisateur affiche un avertissement de sécurité lorsqu'il tente d'accéder au client web ?What to do if the user's browser shows a security warning when they try to access the web clientLe rôle Accès aux services Bureau à distance par le web n'utilise peut-être pas de certificat approuvé.The RD Web Access role might not be using a trusted certificate.Assurez-vous que le rôle Accès aux services Bureau à distance par le web est configuré avec un certificat public approuvé.Make sure the RD Web Access role is configured with a publicly trusted certificate.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.If that doesn't work, your server name in the web client URL might not match the name provided by the RD Web certificate.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.Make sure your URL uses the FQDN of the server hosting the RD Web role.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 ?What to do if the user can't connect to a resource with the web client even though they can see the items under All ResourcesSi 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 :If the user reports that they can't connect with the web client even though they can see the resources listed, check the following things:Le rôle Passerelle des services Bureau à distance est-il correctement configuré pour utiliser un certificat public approuvé ?Is the RD Gateway role properly configured to use a trusted public certificate?Les mises à jour requises sont-elles installées sur le serveur de passerelle Bureau à distance ?Does the RD Gateway server have the required updates installed?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.If the user gets an "unexpected server authentication certificate was received" error message when they try to connect, then the message will show the certificate's thumbprint.Recherchez le gestionnaire de certificat du serveur du service Broker Bureau à distance à l'aide de cette empreinte pour trouver le bon certificat.Search the RD Broker server's certificate manager using that thumbprint to find the right certificate.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.Verify that the certificate is configured to be used for the RD Broker role in the Remote Desktop deployment properties page.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 :After making sure the certificate hasn't expired, copy the certificate in .cer file format to the RD Web Access server and run the following command on the RD Web Access server with the bracketed value replaced by the certificate's file path:Diagnostiquer les problèmes liés au journal de la consoleSi 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.If you can't solve the issue based on the troubleshooting instructions in this article, you can try to diagnose the source of the problem yourself by watching the console log in the browser.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.The web client provides a method for recording the browser console log activity while using the web client to help diagnose issues.Sélectionnez les points de suspension dans le coin supérieur droit et accédez à la page Select the ellipsis in the upper-right corner and navigate to the Dans le client web, reproduisez les opérations qui ont généré le problème que vous essayez de diagnostiquer.Perform the operation(s) in the web client that produced the issue you are trying to diagnose.Votre navigateur télécharge automatiquement un fichier .txt intitulé Your browser will automatically download a .txt file titled Ce fichier contient l'activité complète du journal de la console générée lors de la reproduction du problème cible.This file will contain the full console log activity generated while reproducing the target issue.Vous pouvez également accéder directement à la console à partir de votre navigateur.The console may also be accessed directly through your browser.La console se trouve généralement sous les outils de développement.The console is generally located under the developer tools.Par exemple, dans Microsoft Edge, vous pouvez accéder au journal en appuyant sur la touche For example, you can access the log in Microsoft Edge by pressing the Si vous rencontrez un problème que les informations contenues dans cet article ne permettent pas de résoudre, vous pouvez le signaler sur If you've encountered an issue that can't be solved by the information in this article, you can report it on Vous pouvez également solliciter ou voter en faveur de nouvelles fonctionnalités via notre You can also request or vote for new features at our