Externe foutopsporing

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

Zie deze onderwerpen voor uitgebreide instructies over externe foutopsporing.

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 op de Visual Studio-computer de juiste versie van de externe hulpprogramma's via de koppelingen in de volgende tabel.

• 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.

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 Externe Debugger Configuratiewizard (rdbgwiz.exe) is echter alleen beschikbaar wanneer u de externe tools 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.

Requirements

Ondersteunde besturingssystemen

Op de externe computer moet een van de volgende besturingssystemen worden uitgevoerd:

• Windows 11

• Windows 10 (niet telefoon)

• Windows 8 of 8.1 (niet telefoon)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 of Windows Server 2012 R2

• Windows Server 2008 Service Pack 2, Windows Server 2008 R2 Service Pack 1

Ondersteunde hardwareconfiguraties

• 1,6 GHz of snellere processor

• 1 GB RAM -geheugen (1,5 GB als deze wordt uitgevoerd op een virtuele machine)

• 1 GB beschikbare schijfruimte

• 5400-RPM harde schijf

• DirectX 9-compatibele videokaart met een beeldschermresolutie van 1024 x 768 of hoger

Netwerkconfiguratie

De externe computer en de Visual Studio-computer moeten zijn verbonden via een netwerk, werkgroep of thuisgroep, of 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

   Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\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.

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 kiest u Volgende totdat u bij de pagina Windows Firewall van de wizard configureren bent.

   

   

   Als de Windows Web Services-API niet is geïnstalleerd, wat alleen op Windows Server 2008 R2 gebeurt, selecteert u de knop Installeren .

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.

   Selecteer vervolgens Externe foutopsporing configureren 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. Zie voor meer informatie Remote debug een C#- of Visual Basic-project of Remote debug 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 Fouten opsporen in een app die geen deel uitmaakt 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 Extern foutopsporingsprogramma van Visual Studio uitvoeren als een 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 dat u de configuratiewizard van Visual Studio Remote Debugger hebt voltooid. Als de service niet kan worden gestart, ziet u dat de configuratiewizard voor extern foutopsporingsprogramma van Visual Studio is mislukt. 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 op zoek te gaan 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
• Windows Firewall configureren voor externe foutopsporing
• Poorttoewijzingen voor extern foutopsporingsprogramma
• Externe foutopsporing ASP.NET Core op een externe IIS-computer
• Fouten bij extern debuggen en probleemoplossing