Externe foutopsporing

U kunt fouten opsporen in een Visual Studio-toepassing die op een andere computer is geïmplementeerd. Hiervoor gebruikt u het Visual Studio externe foutopsporingsprogramma.

Zie deze onderwerpen voor uitgebreide instructies over externe foutopsporing.

Scenario	Link
C# of Visual Basic	Remote fouten opsporen in een C# of Visual Basic project
C++	Remote-foutopsporing in een C++ project
Azure App Service	Op afstand debuggen van ASP.NET Core op Azure of, voor Visual Studio Enterprise, de Snapshot Debugger
ASP.NET	Remote debug ASP.NET Core of Remote debug ASP.NET
Azure VM	Op afstand debuggen van ASP.NET op een Azure VM
Linux	Debug .NET Core in Linux met behulp van SSH door een proces te koppelen
Docker	Koppelen aan een proces dat wordt uitgevoerd in een Docker-container
Universal Windows Apps (UWP)	UWP-apps uitvoeren op een externe computer of fouten opsporen in een geïnstalleerd app-pakket

Als u alleen het externe foutopsporingsprogramma wilt downloaden en installeren en geen aanvullende instructies voor uw scenario nodig hebt, volgt u de stappen in dit artikel.

De externe hulpprogramma's downloaden en installeren

Download en installeer op het externe apparaat of de server waarop u fouten wilt opsporen in plaats van de Visual Studio computer de juiste versie van de externe hulpprogramma's via de koppelingen in de volgende tabel.

• Download de meest recente update van de externe hulpprogramma's voor uw versie van Visual Studio. Externe hulpprogramma's voor Visual Studio 2022 en 2026 kunnen worden gebruikt met beide versies van Visual Studio. Versies van externe hulpprogramma's die ouder zijn dan Visual Studio 2022, zijn echter niet compatibel met latere Visual Studio versies. (Als u bijvoorbeeld Visual Studio 2019 gebruikt, downloadt u de meest recente update van de externe hulpprogramma's voor Visual Studio 2019. Download in dit scenario niet de externe hulpprogramma's voor Visual Studio 2022.)

• Download de externe hulpprogramma's met dezelfde architectuur als de computer waarop u ze installeert. Als u bijvoorbeeld x86-toepassingen wilt opsporen op een externe computer waarop een x64-besturingssysteem wordt uitgevoerd, installeert u de externe x64-hulpprogramma's. Als u fouten wilt opsporen in x86-, ARM- of x64-toepassingen op een ARM64-besturingssysteem, installeert u de externe ARM64-hulpprogramma's.

Versie	Link	Opmerkingen
Visual Studio 2026	Hulp op afstand	Compatibel met Visual Studio 2022 en latere versies. Download de versie die overeenkomt met het besturingssysteem van uw apparaat (x86, x64 (AMD64) of ARM64. Zie Het deblokkeren van het bestand downloaden voor hulp bij het downloaden van de externe tools op oudere versies van Windows Server.
Visual Studio 2022	Hulp op afstand	Externe hulpprogramma's voor Visual Studio 2022 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan het gratis programma Visual Studio Dev Essentials of u aanmelden met uw Visual Studio-abonnements-id. Download de versie die overeenkomt met het besturingssysteem van uw apparaat (x86, x64 (AMD64) of ARM64. Zie Blokkeer de bestand-download niet voor hulp bij het downloaden van de externe tools in oudere versies van Windows Server.
Visual Studio 2019	Hulp op afstand	Externe hulpprogramma's voor Visual Studio 2019 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan het gratis programma Visual Studio Dev Essentials of u aanmelden met uw Visual Studio-abonnements-id. Download de versie die overeenkomt met het besturingssysteem van uw apparaat (x86, x64 (AMD64) of ARM64. Zie Het bestand downloaden ontgrendelen voor hulp bij het downloaden van de externe hulpprogramma's op oudere versies van Windows Server.
Visual Studio 2017	Hulp op afstand	Externe hulpprogramma's voor Visual Studio 2017 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan het gratis programma Visual Studio Dev Essentials of u aanmelden met uw Visual Studio-abonnements-id. Download de versie die overeenkomt met het besturingssysteem van uw apparaat (x86, x64 (AMD64) of ARM64. Zie in Windows Server Ontblokkeer het downloaden van het bestand voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2015	Hulp op afstand	Externe hulpprogramma's voor Visual Studio 2015 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan het gratis programma Visual Studio Dev Essentials of u aanmelden met uw Visual Studio-abonnements-id. Zie in Windows Server Ontblokkeer het downloaden van het bestand voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2013	Hulp op afstand	Downloadpagina in Visual Studio 2013-documentatie
Visual Studio 2012	Hulp op afstand	Downloadpagina in Visual Studio 2012-documentatie

U kunt het externe foutopsporingsprogramma uitvoeren door msvsmon.exe naar de externe computer te kopiëren in plaats van de externe hulpprogramma's te installeren. De wizard voor de configuratie van de externe debugger (rdbgwiz.exe) is echter alleen beschikbaar wanneer u de externe hulpprogramma's installeert. Mogelijk moet u de wizard gebruiken voor configuratie als u het externe foutopsporingsprogramma als een service wilt uitvoeren. Zie (Optioneel) Het externe foutopsporingsprogramma configureren als een service voor meer informatie.

Opmerking

• Als u fouten wilt opsporen in Windows 10 of latere apps op ARM-apparaten, gebruikt u ARM64, die beschikbaar is met de nieuwste versie van de externe hulpprogramma's.
• Als u fouten wilt opsporen in Windows 10 apps op Windows RT apparaten, gebruikt u ARM, dat alleen beschikbaar is in de download van externe hulpprogramma's van Visual Studio 2015.
• Als u fouten wilt opsporen in x64-apps op een ARM64-besturingssysteem, voert u de x64-msvsmon.exe uit die is geïnstalleerd met de externe ARM64-hulpprogramma's.

Requirements

Systeemvereisten

De externe hulpprogramma's ondersteunen dezelfde systeemvereisten als Visual Studio, met enkele wijzigingen. Zie de systeemvereisten voor uw versie van Visual Studio voor meer informatie:

• Remote Tools voor Visual Studio 2026 systeemvereisten
• Systeemvereisten voor Remote Tools voor Visual Studio 2022
• Systeemvereisten voor Remote Tools voor Visual Studio 2019

Netwerkconfiguratie

De externe computer en de Visual Studio computer moeten zijn verbonden via een netwerk, werkgroep of thuisgroep, of anders rechtstreeks zijn verbonden via een Ethernet-kabel. Foutopsporing tussen twee computers die zijn verbonden via een proxy, wordt niet ondersteund. Foutopsporing via een verbinding met hoge latentie of lage bandbreedte, zoals inbelinternet of via internet in landen/regio's, wordt niet aanbevolen en kan mislukken of onaanvaardbaar traag zijn.

(Optioneel) Het externe foutopsporingsprogramma uitvoeren vanuit een bestandsshare

U vindt het externe foutopsporingsprogramma (msvsmon.exe) op een computer waarop Visual Studio Community, Professional of Enterprise al is geïnstalleerd. Voor sommige scenario's is de eenvoudigste manier om externe foutopsporing in te stellen het externe foutopsporingsprogramma (msvsmon.exe) uit te voeren vanuit een bestandsshare. Zie de Help-pagina van het externe foutopsporingsprogramma (Help-gebruik > in het externe foutopsporingsprogramma) voor gebruiksbeperkingen.

1. Zoek msvsmon.exe in de map die overeenkomt met uw versie van Visual Studio:

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. Deel de map Remote Debugger op de Visual Studio computer.

3. Voer op de externe computer msvsmon.exe uit vanuit de gedeelde map. Volg de installatie-instructies.

Aanbeveling

Voor de opdrachtregelinstallatie en opdrachtregelreferentie, zie de Help-pagina voor msvsmon.exe door msvsmon.exe /? in de opdrachtregel op de computer te typen waarop Visual Studio is geïnstalleerd (of ga naar Help > Gebruik in het externe foutopsporingsprogramma).

Het externe foutopsporingsprogramma instellen

1. Zoek en start op de externe computer het externe foutopsporingsprogramma in het menu Start .

   Als u geen beheerdersmachtigingen op de externe computer hebt, klikt u met de rechtermuisknop op de app Remote Debugger en selecteert u Uitvoeren als administrator. Anders start u het gewoon normaal.

   Als u van plan bent een proces te koppelen dat wordt uitgevoerd als beheerder of wordt uitgevoerd onder een ander gebruikersaccount (zoals IIS), klikt u met de rechtermuisknop op de app Extern foutopsporingsprogramma en selecteert u Uitvoeren als administrator. Zie Het externe foutopsporingsprogramma uitvoeren als beheerder voor meer informatie.

2. De eerste keer dat u het externe foutopsporingsprogramma start (of voordat u het hebt geconfigureerd), wordt de wizard Configuratie voor externe foutopsporing weergegeven.

   In de meeste scenario's selecteert u Externe foutopsporing configureren.

   

3. Selecteer ten minste één netwerktype waarvoor u de externe hulpprogramma's wilt gebruiken. Als de computers zijn verbonden via een domein, moet u het eerste item kiezen. Als de computers zijn verbonden via een werkgroep of thuisgroep, kiest u het tweede of derde item indien van toepassing.

   Selecteer vervolgens Voltooien om het externe foutopsporingsprogramma te starten.

4. Wanneer de configuratie is voltooid, wordt het venster Remote Debugger weergegeven.

   

   Het externe foutopsporingsprogramma wacht nu op een verbinding. Gebruik de servernaam en het poortnummer dat wordt weergegeven om de configuratie van de externe verbinding in te stellen in Visual Studio.

Als u het externe foutopsporingsprogramma wilt stoppen, selecteert u Bestand>afsluiten. U kunt deze opnieuw starten vanuit het menu Start of vanaf de opdrachtregel:

<Remote debugger installation directory>\msvsmon.exe

Het externe foutopsporingsprogramma configureren

U kunt enkele aspecten van de configuratie van het externe foutopsporingsprogramma wijzigen nadat u het voor het eerst hebt gestart.

• Als u machtigingen wilt toevoegen voor andere gebruikers om verbinding te maken met het externe foutopsporingsprogramma, kiest u Extra-machtigingen>. U moet beheerdersbevoegdheden hebben om machtigingen te verlenen of te weigeren.

  Belangrijk

  U kunt het externe foutopsporingsprogramma uitvoeren onder een gebruikersaccount dat verschilt van het gebruikersaccount dat u op de Visual Studio computer gebruikt, maar u moet het verschillende gebruikersaccount toevoegen aan de machtigingen van het externe foutopsporingsprogramma.

  U kunt ook het externe foutopsporingsprogramma starten vanaf de opdrachtregel met de parameter /allow <username> : msvsmon /allow <username@computer>.

• Als u de verificatiemodus of het poortnummer wilt wijzigen of een time-outwaarde voor de externe hulpprogramma's wilt opgeven: kies Extra-opties>.

  Zie Poorttoewijzingen voor externe foutopsporing voor een lijst met poortnummers die standaard worden gebruikt.

  Waarschuwing

  U kunt ervoor kiezen om de externe hulpprogramma's uit te voeren in de modus Geen verificatie, maar deze modus wordt sterk afgeraden. Er is geen netwerkbeveiliging wanneer u deze modus uitvoert. Kies de modus Geen verificatie alleen als u zeker weet dat het netwerk geen risico loopt op schadelijk of vijandig verkeer.

Visual Studio configureren voor externe foutopsporing

Gebruik de koppelingen met betrekking tot uw specifieke scenario aan het begin van dit artikel voor gedetailleerde instructies om vanuit Visual Studio verbinding te maken met de app.

Voor sommige scenario's is het gebruik van Koppelen aan proces vereist om verbinding te maken met een externe app die al is gestart. Voor .NET Core- .NET 5+-, .NET Framework- en C++-apps kunt u de externe app echter starten vanuit Visual Studio door projecteigenschappen te configureren en het foutopsporingsprogramma te starten. Voor meer informatie, zie Remote-foutopsporing in een C# of Visual Basic project of Remote-foutopsporing in een C++-project.

U kunt ook externe fouten opsporen in een uitvoerbaar bestand dat geen deel uitmaakt van een Visual Studio project, hoewel de ondersteunde functies voor foutopsporing afhankelijk zijn van de configuratie, zoals de beschikbaarheid van symbolen. Zie Een app debuggen die geen onderdeel is van een Visual Studio-oplossing voor meer informatie.

(Optioneel) Het externe foutopsporingsprogramma configureren als een service

Voor foutopsporing in ASP.NET en andere serveromgevingen moet u het externe foutopsporingsprogramma uitvoeren als beheerder of, als u wilt dat het altijd wordt uitgevoerd, het externe foutopsporingsprogramma als een service uitvoeren.

Als u het externe foutopsporingsprogramma als een service wilt configureren, volgt u deze stappen.

1. Zoek de Configuratiewizard voor externe foutopsporing (rdbgwiz.exe). (Dit is een afzonderlijke toepassing van het externe foutopsporingsprogramma.) Deze is alleen beschikbaar wanneer u de externe hulpprogramma's installeert. Het is niet geïnstalleerd met Visual Studio.

2. Start met het uitvoeren van de configuratiewizard. Wanneer de eerste pagina wordt weergegeven, klikt u op Volgende.

3. Schakel het selectievakje Run the Visual Studio Remote Debugger as a service in.

4. Voeg de naam van het gebruikersaccount en wachtwoord toe.

   Mogelijk moet u het recht op aanmelden als een servicegebruiker toevoegen aan dit account ( Lokaal beveiligingsbeleid zoeken (secpol.msc) op de startpagina of het venster (of typ secpol bij een opdrachtprompt). Wanneer het venster wordt weergegeven, dubbelklikt u op Toewijzing van gebruikersrechten en zoekt u naar Aanmelden als een service in het rechterdeelvenster. Dubbelklik erop. Voeg het gebruikersaccount toe aan het venster Eigenschappen en klik op OK). Klik op Volgende.

5. Selecteer het type netwerk waarmee u de externe hulpprogramma's wilt communiceren. Er moet ten minste één netwerktype worden geselecteerd. Als de computers zijn verbonden via een domein, moet u het eerste item kiezen. Als de computers zijn verbonden via een werkgroep of thuisgroep, moet u de tweede of derde items kiezen. Klik op Volgende.

6. Als de service kan worden gestart, ziet u U hebt de configuratiewizard van de Visual Studio externe debugger voltooid. Als de service niet kan worden gestart, ziet u Kan de configuratiewizard voor externe foutopsporing van Visual Studio niet voltooien. De pagina bevat ook enkele tips om de service te laten starten.

7. Klik op Voltooien.

   Op dit moment wordt het externe foutopsporingsprogramma uitgevoerd als een service. U kunt dit controleren door naar Configuratiescherm > Services te gaan en te zoeken naar Visual Studio Remote Debugger.

   U kunt de externe foutopsporingsprogrammaservice stoppen en starten vanuit Configuratiescherm > Services.

Debuggen instellen met externe symbolen

U moet fouten in uw code kunnen opsporen met de symbolen die u op de Visual Studio computer genereert. De prestaties van het externe foutopsporingsprogramma zijn veel beter wanneer u lokale symbolen gebruikt. Als u externe symbolen moet gebruiken, moet u de monitor voor externe foutopsporing laten weten om te zoeken naar symbolen op de externe computer.

U kunt de volgende msvsmon-opdrachtregelswitch gebruiken om externe symbolen voor beheerde code te gebruiken: Msvsmon /FallbackLoadRemoteManagedPdbs

Zie de Help voor externe foutopsporing (druk op F1 in het venster voor het externe foutopsporingsprogramma of klik op Help-gebruik>) voor meer informatie.

Verwante inhoud

• Bekijk eerst het foutopsporingsprogramma
• Configureer de Windows Firewall voor Remote Debugging
• Poorttoewijzingen voor externe debuggers
• Externe foutopsporing van ASP.NET Core op een IIS-computer op afstand
• Fouten bij extern debuggen en probleemoplossing