Exécuter des applications UWP sur un ordinateur distant dans Visual StudioRun UWP apps on a remote machine in Visual Studio

Pour exécuter une application UWP sur un ordinateur distant, vous devez attacher à l’aide des outils à distance pour Visual Studio.To run a UWP app on a remote machine, you must attach to it using the Remote Tools for Visual Studio. Les outils à distance permettent d’exécuter, déboguer, Profiler et tester une application UWP qui s’exécute sur un appareil à partir d’un deuxième ordinateur qui exécute Visual Studio.The remote tools enable you to run, debug, profile, and test a UWP app that is running on one device from a second computer that is running Visual Studio. En cours d’exécution sur un périphérique distant peut être particulièrement efficace lorsque l’ordinateur Visual Studio ne prend pas en charge les fonctionnalités spécifiques aux applications UWP, tels que touch, emplacement géographique et l’orientation physique.Running on a remote device can be especially effective when the Visual Studio computer does not support functionality that is specific to UWP apps, such as touch, geo-location, and physical orientation. Cette rubrique décrit les procédures de configuration et de démarrage d'une session distante.This topic describes the procedures to configure and start a remote session.

Dans certains scénarios, les outils à distance sont installés automatiquement lorsque vous déployez sur un périphérique distant.In some scenarios, the remote tools are automatically installed when you deploy to a remote device.

  • Pour les PC Windows 10 exécutant Creators Update et versions ultérieures, les outils à distance seront installés automatiquement.For Windows 10 PCs running Creators Update and later versions, remote tools will be installed automatically.
  • Pour les appareils Windows 10 Xbox, HoloLens et IOT, les outils à distance seront installés automatiquement.For Windows 10 Xbox, IOT, and HoloLens devices, remote tools will be installed automatically.
  • Pour Windows Mobile 10, vous devez être connecté physiquement au numéro de téléphone, vous devez activer mode développeur et vous devez sélectionner appareil en tant que la cible de débogage.For Windows Mobile 10, you must be physically connected to the phone, you must enable developer mode and you must select Device as the debug target. Les outils à distance ne sont pas requis ou pris en charge.Remote tools are not required or supported.

Pour les PC Windows 10 exécutant la version de mise à jour d’un créateur versions antérieures de Windows, vous devez installer les outils à distance sur l’ordinateur distant manuellement avant de pouvoir déboguer.For Windows 10 PCs running a pre-Creator's Update version of Windows, you must install the remote tools on the remote machine manually before you can debug. Suivez les instructions de cette rubrique.Follow the instructions in this topic.

Conditions préalablesPrerequisites

Pour déboguer sur un appareil distant :To debug on a remote device:

  • L’appareil distant et l’ordinateur Visual Studio doivent être connectés via un réseau ou directement à l’aide d’un câble USB ou Ethernet.The remote device and the Visual Studio computer must be connected over a network or connected directly through a USB or Ethernet cable. Le débogage sur Internet n'est pas pris en charge.Debugging over the internet is not supported.

  • Vous devez activer mode développeur.You must enable developer mode.

  • Pour les PC Windows 10 exécutant une version de Windows 10 antérieure à Update Windows 10 Creators, vous devez installer et exécuter les composants de débogage à distance.For Windows 10 PCs running a version of Windows 10 earlier than Windows 10 Creator's Update, you must install and run the remote debugging components.

SécuritéSecurity

Par défaut, universel (protocole non chiffré) est utilisé sur Windows 10.By default, Universal (Unencrypted Protocol) is used on Windows 10. Ce protocole doit être utilisé uniquement sur des réseaux approuvés.This protocol should only be used on trusted networks. La connexion de débogage est vulnérable aux utilisateurs malveillants qui pourrait intercepter et modifier des données transmises entre le développement et l’ordinateur distant.The debugging connection is vulnerable to malicious users who could intercept and change data being passed between the development and remote machine.

Avertissement

Il n’existe aucune sécurité du réseau lorsque vous définissez le mode d’authentification sur universel (protocole non chiffré) ou aucun.There is no network security when you set the authentication mode to Universal (Unencrypted Protocol) or None. Choisissez ces modes uniquement si vous êtes sûr que le réseau n’est pas exposés à partir de programmes malveillants ou dangereux.Choose these modes only if you are sure that the network is not at risk of from malicious or hostile traffic.

Comment se connecter directement à l’aide d’un câble USBHow to connect directly using a USB cable

Sur Windows 10, vous pouvez déployer sur un périphérique USB connecté en choisissant appareil au lieu de Machine distante comme cible de déploiement (vous pouvez le faire dans le Standard barre d’outils ou dans la page de propriétés de débogage).On Windows 10, you can deploy to a USB-connected device by choosing Device instead of Remote Machine as the deployment target (you can do this in the Standard toolbar or in the debugging properties page).

Configurer le projet Visual Studio pour le débogage distantConfigure the Visual Studio project for remote debugging

Vous spécifiez le périphérique distant auquel se connecter dans les propriétés du projet.You specify the remote device to connect to in the properties of the project. La procédure varie en fonction du langage de programmation.The procedure differs depending on the programming language. Vous pouvez taper le nom de réseau du périphérique distant ou vous pouvez le sélectionner à partir de la connexion à distance boîte de dialogue.You can type the network name of the remote device or you can select it from the Remote Connection dialog box.

Boîte de dialogue de connexion du débogueur distant sélectionnezSelect Remote Debugger Connection dialog box

La boîte de dialogue répertorie uniquement les appareils qui se trouvent sur le sous-réseau local de l'ordinateur Visual Studio et qui exécutent le débogueur distant.The dialog box lists only those devices that are on the local subnet of the Visual Studio computer and that are running the remote debugger.

Conseil

Si vous avez des problèmes pour vous connecter à un périphérique distant, entrez son adresse IP.If you have trouble connecting to a remote device, try entering the IP address of the device. Pour connaître l'adresse IP d'un périphérique, ouvrez une fenêtre de commande, puis tapez ipconfig.To determine the IP address of a device, open a command window and then type ipconfig. L'adresse IP s'affiche comme IPv4 Address.The IP address is listed as IPv4 Address.

Choisissez le périphérique distant pour les projets c# et Visual BasicChoose the remote device for C# and Visual Basic projects

  1. Sélectionnez le nom du projet dans l'Explorateur de solutions, puis choisissez Propriétés dans le menu contextuel.Select the project name in Solution Explorer and then choose Properties from the shortcut menu.

  2. Sélectionnez Déboguer.Select Debug.

  3. Choisissez Ordinateur distant dans la liste Périphérique cible .Choose Remote Machine from the Target Device list.

  4. Entrez le nom réseau du périphérique distant dans la zone Ordinateur distant ou choisissez Rechercher pour sélectionner le périphérique dans la boîte de dialogue Sélectionner une connexion au débogueur distant .Enter the network name of the remote device in the Remote Machine box or choose Find to choose the device from the Select Remote Debugger Connection dialog box.

    Propriétés du projet pour le débogage distant managéManaged project properties for remote debugging

Choisissez le périphérique distant pour les projets JavaScript et C++Choose the remote device for JavaScript and C++ projects

  1. Sélectionnez le nom du projet dans l'Explorateur de solutions, puis choisissez Propriétés dans le menu contextuel.Select the project name in Solution Explorer and then choose Properties from the shortcut menu.

  2. Développez le nœud Propriétés de configuration , puis sélectionnez Débogage.Expand the Configuration Properties node and then select Debugging.

  3. Choisissez Remote Debugger dans la liste Débogueur à lancer .Choose Remote Debugger from the Debugger to launch list.

  4. Entrez le nom réseau du périphérique distant dans la zone Nom de l'ordinateur ou choisissez la flèche Bas de la zone pour sélectionner le périphérique dans la boîte de dialogue Sélectionner une connexion au débogueur distant .Enter the network name of the remote device in the Machine Name box or choose the down arrow in the box to choose the device from the Select Remote Debugger Connection dialog box.

    C+ + projeter des propriétés pour le débogage distantC++ project properties for remote debugging

Téléchargez et installez les outils à distance (préliminaire Creators Update)Download and Install the remote tools (pre-Creators Update)

Si vous utilisez des versions de mise à jour d’un créateur versions antérieures de Windows 10, puis suivez ces instructions.If you are using a pre-Creator's Update versions of Windows 10, then follow these instructions. Sinon, vous pouvez ignorer cette section.Otherwise, you can skip this section.

  1. Sur l’appareil ou serveur machine que vous souhaitez déboguer (plutôt que l’ordinateur qui exécute Visual Studio), obtenir la version des outils à distance.On the device or server machine that you want to debug (rather than the machine running Visual Studio), get the correct version of the remote tools.

    VersionVersion LienLink NotesNotes
    Visual Studio 2017 (version la plus récente)Visual Studio 2017 (latest version) Outils à distanceRemote tools Téléchargez toujours la version correspondant à votre système d’exploitation (x 86, x64 ou ARM64).Always download the version matching your device operating system (x86, x64, or ARM64). Sur Windows Server, consultez débloquer le téléchargement du fichier pour l’aide pour télécharger les outils à distance.On Windows Server, see Unblock the file download for help to download the remote tools.
    Visual Studio 2017 (plus ancienne)Visual Studio 2017 (older) Outils à distanceRemote tools Les outils à distance pour les versions antérieures de Visual Studio 2017 sont disponibles à partir de My.VisualStudio.com.Remote tools for earlier releases of Visual Studio 2017 are available from My.VisualStudio.com. Si vous y êtes invité, jointure du groupe Visual Studio Dev Essentials gratuit, ou connectez-vous avec votre abonnement Visual Studio code.If prompted, join the free Visual Studio Dev Essentials group, or sign in with your Visual Studio subscription ID. Sur Windows Server, consultez débloquer le téléchargement du fichier pour l’aide pour télécharger les outils à distance.On Windows Server, see Unblock the file download for help to download the remote tools.
    Visual Studio 2015 (plus ancienne)Visual Studio 2015 (older) Outils à distanceRemote tools Si vous y êtes invité, jointure du groupe Visual Studio Dev Essentials gratuit, ou connectez-vous avec votre abonnement Visual Studio code.If prompted, join the free Visual Studio Dev Essentials group, or sign in with your Visual Studio subscription ID. Sur Windows Server, consultez débloquer le téléchargement du fichier pour l’aide pour télécharger les outils à distance.On Windows Server, see Unblock the file download for help to download the remote tools.
    Visual Studio 2013Visual Studio 2013 Outils à distanceRemote tools Télécharger la page dans la documentation de Visual Studio 2013Download page in Visual Studio 2013 documentation
    Visual Studio 2012Visual Studio 2012 Outils à distanceRemote tools Télécharger la page dans la documentation de Visual Studio 2012Download page in Visual Studio 2012 documentation
  2. Sur la page de téléchargement, choisissez la version des outils qui correspond à votre système d’exploitation (x86, x64, ARM ou ARM64) et téléchargez les outils à distance.On the download page, choose the version of the tools that matches your operating system (x86, x64, ARM, or ARM64) and download the remote tools.

    Important

    Nous vous recommandons de qu'installer la version la plus récente des outils à distance qui correspond à votre version de Visual Studio.We recommend you install the most recent version of the remote tools that matches your version of Visual Studio. Versions incompatibles ne sont pas recommandées.Mismatched versions are not recommended. En outre, vous devez installer les outils à distance qui ont la même architecture que le système d’exploitation sur lequel vous souhaitez l’installer.In addition, you must install the remote tools that have the same architecture as the operating system on which you want to install it. En d’autres termes, si vous souhaitez déboguer une application 32 bits sur un ordinateur distant exécutant un système d’exploitation de 64 bits, vous devez installer la version 64 bits des outils à distance sur l’ordinateur distant.In other words, if you want to debug a 32-bit application on a remote computer running a 64-bit operating system, you must install the 64-bit version of the remote tools on the remote computer.

    Pour le débogage sur Windows 10 sur les appareils ARM, cliquez sur Télécharger ARM64 disponible avec la dernière version des outils à distance.For debugging on Windows 10 on ARM devices, choose the ARM64 download available with the latest version of the remote tools. Pour les appareils Windows RT, choisissez la version ARM, qui est uniquement disponible dans le téléchargement de Visual Studio 2015 RTW.For Windows RT devices, choose the ARM version, which is only available in the Visual Studio 2015 RTW download.

  3. Lorsque vous avez terminé de télécharger le fichier exécutable, accédez à la section suivante et suivez les instructions d’installation.When you have finished downloading the executable, go to the next section and follow setup instructions.

Si vous tentez de copier le débogueur distant (msvsmon.exe) sur l’ordinateur distant et l’exécuter, n’oubliez pas que le Assistant Configuration Remote Debugger (rdbgwiz.exe) est installé uniquement lorsque vous téléchargez le outils.If you try to copy the remote debugger (msvsmon.exe) to the remote computer and run it, be aware that the Remote Debugger Configuration Wizard (rdbgwiz.exe) is installed only when you download the tools. Vous devrez peut-être utiliser l’Assistant de configuration plus tard, en particulier si vous souhaitez que le débogueur distant s’exécute en tant que service.You may need to use the wizard for configuration later, especially if you want the remote debugger to run as a service. Pour plus d’informations, consultez (facultatif) configurer le débogueur distant en tant que service.For more information, see (Optional) Configure the remote debugger as a service.

Configurer le débogueur distantSet up the remote debugger

Vous devez disposer des autorisations administratives sur l’ordinateur distant.You must have administrative permissions on the remote computer.

  1. Recherchez l’application du débogueur distant.Locate the Remote Debugger application. (Recherchez msvsmon.exe dans l’emplacement où il a été installé ou ouvrez le menu Démarrer et recherchez débogueur distant.)(Find msvsmon.exe in the location where it has been installed, or open the Start menu and search for Remote Debugger.)

    Si vous exécutez le débogueur distant sur un serveur distant, vous pouvez avec le bouton droit de l’application débogueur distant et choisissez exécuter en tant qu’administrateur.If you are running the remote debugger on a remote server, you can right-click the Remote Debugger app and choose Run as administrator. Si vous n’exécutez pas sur un serveur distant, seulement le démarrer normalement.If you are not running it on a remote server, just start it normally.

  2. Lorsque vous démarrez les outils à distance pour la première fois (ou avant que vous l’avez configuré), le Configuration du débogage distant boîte de dialogue s’affiche.When you start the remote tools for the first time (or before you have configured it), the Remote Debugging Configuration dialog box appears.

    RemoteDebuggerConfWizardPageRemoteDebuggerConfWizardPage

  3. Si l’API de Service Windows n’est pas installé (ce qui se produit uniquement sur Windows Server 2008 R2), choisissez le installer bouton.If the Windows Service API is not installed (which happens only on Windows Server 2008 R2), choose the Install button.

  4. Sélectionnez les types de réseau sur lesquels vous voulez utiliser les outils de contrôle à distance.Select the network types you want use the remote tools on. Au moins un type de réseau doit être sélectionné.At least one network type must be selected. Si les ordinateurs sont connectés à un domaine, vous devez choisir le premier élément.If the computers are connected through a domain, you must choose the first item. Si les ordinateurs sont connectés à un groupe de travail ou un groupe résidentiel, vous devez choisir le deuxième ou troisième élément, selon les besoins.If the computers are connected through a workgroup or homegroup, you need to choose the second or third item as appropriate.

  5. Choisissez configurer le débogage distant pour configurer le pare-feu et démarrer l’outil.Choose Configure remote debugging to configure the firewall and start the tool.

  6. Une fois la configuration terminée, la fenêtre du débogueur distant s’affiche.When configuration is complete, the Remote Debugger window appears.

    RemoteDebuggerWindowRemoteDebuggerWindow

    Le débogueur distant est maintenant en attente pour une connexion.The remote debugger is now waiting for a connection. Prenez note du nom du serveur et le port numéro qui s’affiche, car il doit correspondre à la configuration que vous utilisez plus tard dans Visual Studio.Make a note of the server name and port number that is displayed, because this must match the configuration you later use in Visual Studio.

    Lorsque vous avez terminé le débogage et vous devez arrêter le débogueur distant, cliquez sur fichier > sortie dans la fenêtre.When you are finished debugging and need to stop the remote debugger, click File > Exit on the window. Vous pouvez le redémarrer à partir de la Démarrer menu ou à partir de la ligne de commande :You can restart it from the Start menu or from the command line:

    <Répertoire d’installation de débogueur distant >\< x86, x64, ARM, ARM64 ou Appx > \msvsmon.exe.<Remote debugger installation directory>\<x86, x64, ARM, ARM64, or Appx>\msvsmon.exe.

Démarrer une session de débogage à distanceStart a remote debugging session

Le démarrage, la désactivation et l'exploration d'une session de débogage distant s'effectuent de la même façon que pour une session locale.You start, stop, and navigate a remote debug session the same way you do a local session. Sur les versions de mise à jour du pre-créateur de Windows 10, assurez-vous que Remote Debugging Monitor est en cours d’exécution sur le périphérique distant.On pre-Creator's Update versions of Windows 10, make sure the Remote Debugging Monitor is running on the remote device.

Choisissez ensuite Démarrer le débogage dans le menu Déboguer (clavier : F5).Then choose Start Debugging on the Debug menu (Keyboard: F5). Le projet est recompilé, puis déployé et démarré sur le périphérique distant.The project is recompiled, then deployed to and started on the remote device. Le débogueur interrompt l'exécution aux points d'arrêt et vous pouvez effectuer un pas à pas détaillé, principal et sortant de votre code.The debugger suspends execution at breakpoints, and you can step into, over, and out of your code. Choisissez Arrêter le débogage pour terminer la session de débogage et fermer l'application distante.Choose Stop Debugging to end your debug session and close the remote app.

Voir aussiSee Also

Les options de déploiement à distance avancéesAdvanced remote deployment options
Test d’applications UWP avec Visual Studio Testing UWP apps with Visual Studio
Déboguer des applications dans Visual StudioDebug apps in Visual Studio