Externe foutopsporing ASP.NET Core op een externe IIS-computer in Visual Studio

Als u fouten wilt opsporen in een ASP.NET Core-toepassing die is geïmplementeerd in IIS, installeert en voert u de externe hulpprogramma's uit op de computer waarop u uw app hebt geïmplementeerd en koppelt u deze vervolgens aan uw actieve app vanuit Visual Studio.

In deze handleiding wordt uitgelegd hoe u een Visual Studio ASP.NET Core instelt en configureert, implementeert in IIS en het externe foutopsporingsprogramma koppelt vanuit Visual Studio. Zie Externe foutopsporing ASP.NET op een IIS-computervoor externe foutopsporing ASP.NET 4.8. U kunt iis ook implementeren en fouten opsporen met behulp van Azure. Zie voor Azure App Service Externe foutopsporing ASP.NET Core in Azure of gebruik voor Visual Studio Enterprise de Snapshot Debugger (vereist .NET 4.6.1).

Voorwaarden

Visual Studio 2019 of een latere versie is vereist om de stappen in dit artikel te volgen.

Deze procedures zijn getest op deze serverconfiguraties:

• Windows Server 2022 en IIS 10
• Windows Server 2019 en IIS 10
• Windows Server 2016 en IIS 10

Netwerkvereisten

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. Zie Vereistenvoor een volledige lijst met vereisten.

App wordt al uitgevoerd in IIS?

Dit artikel bevat stappen voor het instellen van een basisconfiguratie van IIS op Windows Server en het implementeren van de app vanuit Visual Studio. Deze stappen zijn opgenomen om ervoor te zorgen dat de server vereiste onderdelen heeft geïnstalleerd, dat de app correct kan worden uitgevoerd en dat u klaar bent voor externe foutopsporing.

• Als uw app wordt uitgevoerd in IIS en u alleen het externe foutopsporingsprogramma wilt downloaden en foutopsporing wilt starten, gaat u naar De externe hulpprogramma's downloaden en installeren op Windows Server.

• Als u hulp nodig hebt om ervoor te zorgen dat uw app is ingesteld, geïmplementeerd en correct wordt uitgevoerd in IIS, zodat u fouten kunt opsporen, volgt u alle stappen in dit artikel.

De ASP.NET Core-toepassing maken op de Visual Studio-computer

1. Maak een nieuwe ASP.NET Core-webtoepassing.

   Kies in Visual Studio Bestand>startvenster om het startvenster te openen en kies vervolgens Een nieuw project maken. Typ web-app in het zoekvaken kies vervolgens C# als taal, kies ASP.NET Core Web Application (Model-View-Controller)en kies vervolgens Volgende. Geef in het volgende scherm de naam van het project MyASPAppen kies vervolgens Volgende.

   Kies het aanbevolen doelnetwerk of .NET 8, en klik daarna op Maken. De versie moet overeenkomen met de versie die op de server is geïnstalleerd.

2. Open het HomeController.cs-bestand in de map Controllers en stel een onderbrekingspunt in de return View;-instructie in de Privacy-methode in.

   Open in oudere sjablonen het Privacy.cshtml.cs bestand en stel een onderbrekingspunt in de methode OnGet in.

IIS installeren en configureren op Windows Server

In deze stappen wordt alleen een basisconfiguratie van IIS weergegeven. Zie Publishing to IIS or IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5voor meer uitgebreide informatie of om te installeren op een Windows-bureaubladcomputer.

Voor Windows Server-besturingssystemen gebruikt u de wizard Functies en onderdelen toevoegen via de koppeling beheren of de koppeling Dashboard in Serverbeheer. Schakel in de serverfuncties stap het selectievakje in voor webserver (IIS).

(Windows Server 2022) Kies in het dialoogvenster dat wordt weergegeven Functies toevoegen om de IIS-beheerconsole toe te voegen.

Selecteer in de Rolservices stap de gewenste IIS-rolservices of accepteer de standaardrolservices. Als u implementatie wilt inschakelen met behulp van publicatie-instellingen en Web Deploy, moet u ervoor zorgen dat de volgende functies zijn geselecteerd:

• IIS-beheerscripts en -hulpprogramma's
• Beheerservice
• IIS-beheerconsole

Doorloop de bevestigingsstappen om de webserverfunctie en -services te installeren. Het opnieuw opstarten van een server/IIS is niet vereist nadat u de webserverfunctie (IIS) hebt geïnstalleerd.

Browserbeveiligingsinstellingen bijwerken op Windows Server

Als u een oudere versie van Windows Server gebruikt, moet u mogelijk bepaalde domeinen toevoegen als vertrouwde sites om bepaalde onderdelen van de webserver te kunnen downloaden. Voeg de vertrouwde sites toe door naar internetopties > Beveiliging > vertrouwde sites > siteste gaan. Voeg de volgende domeinen toe.

• microsoft.com
• go.microsoft.com
• download.microsoft.com
• iis.net

Wanneer u de software downloadt, krijgt u mogelijk aanvragen om toestemming te verlenen voor het laden van verschillende websitescripts en -resources. Sommige van deze resources zijn niet vereist, maar om het proces te vereenvoudigen, selecteert u Toevoegen wanneer hierom wordt gevraagd.

ASP.NET Core installeren op Windows Server

1. Installeer de .NET Core Hosting Bundle op het hostingsysteem. De bundel installeert de .NET Core Runtime, .NET Core-bibliotheek en de ASP.NET Core-module. Zie Publiceren op IISvoor meer gedetailleerde instructies.

   Installeer voor de huidige .NET Core-hostingbundel de ASP.NET Core Hosting Bundle.

   Notitie

   Als u IIS eerder hebt geïnstalleerd, wordt de ASP.NET Core IIS-module geïnstalleerd met ASP.NET Core. Anders installeert u de ASP.NET Core IIS-module handmatig.

   Installeer voor .NET Core 2 de .NET Core Windows Server Hosting .

   Notitie

   Als het systeem geen internetverbinding heeft, moet u de Microsoft Visual C++ 2015 Redistributable verkrijgen en installeren voordat u de bundel .NET Core Windows Server Hosting installeert.

2. Start het systeem opnieuw op (of voer net stop was /y gevolgd door net start w3svc vanuit de opdrachtprompt om een wijziging in het systeem-pad door te voeren).

Een implementatieoptie kiezen

Als u hulp nodig hebt bij het implementeren van de app in IIS, kunt u de volgende opties overwegen:

• Implementeer door een publicatie-instellingenbestand te maken in IIS en de instellingen te importeren in Visual Studio. In sommige scenario's is dit een snelle manier om uw app te implementeren. Wanneer u het bestand met publicatie-instellingen maakt, worden machtigingen automatisch ingesteld in IIS.

• Implementeer door te publiceren naar een lokale map en de uitvoer te kopiëren door een voorkeursmethode naar een voorbereide app-map in IIS.

(Optioneel) Implementeren met behulp van een bestand met publicatie-instellingen

U kunt deze optie gebruiken om een publicatie-instellingenbestand te maken en dit te importeren in Visual Studio.

Notitie

Als u Web Deploy handmatig wilt configureren in plaats van de publicatie-instellingen te importeren, moet u ervoor zorgen dat een app-map op de server is geconfigureerd met de juiste waarden en machtigingen (zie ASP.NET website configureren).

De ASP.NET Core-website configureren

1. Selecteer in IIS-beheer in het linkerdeelvenster onder Verbindingende Application Pools. Open DefaultAppPool- en stel de .NET CLR-versie in op Geen beheerde code. Dit is vereist voor ASP.NET Core. De standaardwebsite maakt gebruik van de DefaultAppPool.

2. Stop en start de DefaultAppPool opnieuw.

Web deploy installeren en configureren op Windows Server

Web Deploy biedt aanvullende configuratiefuncties waarmee het publicatie-instellingenbestand vanuit de gebruikersinterface kan worden gemaakt.

Notitie

Het webplatforminstallatieprogramma heeft het einde van de levensduur bereikt op 1-7-22. Zie voor meer informatie Web Platform Installer - Einde van de ondersteuning en het beëindigen van de product-/toepassingsfeed. U kunt Web Deploy 4.0 rechtstreeks installeren om het publicatie-instellingenbestand te maken.

1. Als u IIS-beheerscripts en hulpprogramma'snog niet hebt geïnstalleerd, installeert u deze nu.

   Ga naar Serverfuncties selecteren>Webserver (IIS)>Management Toolsen selecteer vervolgens de iis-beheerscripts en hulpprogramma's rol, klik op Volgendeen installeer vervolgens de rol.

   

   De scripts en hulpprogramma's zijn vereist om het genereren van het publicatie-instellingenbestand in te schakelen.

   Zorg ervoor dat u ook de Management Service en IIS Management Console installeert (deze zijn mogelijk al geïnstalleerd).

2. Download web deploy 4.0 op Windows Server.

3. Voer het installatieprogramma Web Deploy uit en zorg ervoor dat u volledige installatie selecteert in plaats van een typische installatie.

   Met een volledige installatie krijgt u de onderdelen die u nodig hebt om een publicatie-instellingenbestand te genereren. (Als u in plaats daarvan Aangepaste kiest, ziet u de lijst met onderdelen, zoals wordt weergegeven in de volgende afbeelding.)

   

4. (Optioneel) Controleer of Web Deploy correct wordt uitgevoerd door Configuratiescherm te openen > Systeem en beveiliging > Systeem- en beveiligingshulpprogramma's > Servicesen controleer vervolgens of:

   • webimplementatieagentservice wordt uitgevoerd (de servicenaam verschilt in oudere versies).

   • webbeheerservice wordt uitgevoerd.

   Als een van de agent-services niet wordt uitgevoerd, start u de Web Deployment Agent-service opnieuw.

   Als de Web Deployment-agentservice helemaal niet aanwezig is, gaat u naar Configuratiescherm > Programma's > Een programma verwijderenen zoekt u Microsoft Web Deploy <versie>. Kies Wijzig de installatie en zorg ervoor dat het wordt geïnstalleerd op de lokale harde schijf voor de Web Deploy-componenten. Voer de stappen voor de installatie van de wijziging uit.

Het bestand met publicatie-instellingen maken in IIS op Windows Server

1. Sluit de IIS-beheerconsole en open deze opnieuw om bijgewerkte configuratieopties weer te geven in de gebruikersinterface.

2. Klik in IIS met de rechtermuisknop op de Standaardwebsite, kies Implementeren>Web Deploy-publicatie configureren.

   

   Als u het menu Implementeren niet ziet, raadpleegt u de vorige sectie om te controleren of Web Deploy wordt uitgevoerd.

3. Bekijk de instellingen in dialoogvenster Web Deploy Publishing configureren.

4. Klik op Setup.

   In het deelvenster Resultaten ziet u in de uitvoer dat toegangsrechten worden verleend aan de opgegeven gebruiker en dat een bestand met een .publishsettings bestandsextensie is gegenereerd op de locatie die wordt weergegeven in het dialoogvenster.

   <?xml version="1.0" encoding="utf-8"?>
   <publishData>
     <publishProfile
       publishUrl="https://myhostname:8172/msdeploy.axd"
       msdeploySite="Default Web Site"
       destinationAppUrl="http://myhostname:80/"
       profileName="Default Settings"
       publishMethod="MSDeploy"
       userName="myhostname\myusername" />
   </publishData>
   

   Afhankelijk van uw Windows Server- en IIS-configuratie ziet u verschillende waarden in het XML-bestand. Hier volgen enkele details over de waarden die u ziet:

   • Het bestand msdeploy.axd waarnaar wordt verwezen in het kenmerk publishUrl is een dynamisch gegenereerd HTTP-handlerbestand voor Web Deploy. (Voor testdoeleinden werkt http://myhostname:8172 over het algemeen ook.)

   • De publishUrl-poort is ingesteld op poort 8172. Dit is de standaardpoort voor Web Deploy.

   • De destinationAppUrl-poort is ingesteld op poort 80. Dit is de standaardpoort voor IIS.

   • Als u in latere stappen geen verbinding kunt maken met de externe host vanuit Visual Studio met behulp van de hostnaam, test u het IP-adres van de server in plaats van de hostnaam.

     Notitie

     Als u publiceert naar IIS die wordt uitgevoerd op een Virtuele Azure-machine, moet u een binnenkomende poort openen voor Web Deploy en IIS in de netwerkbeveiligingsgroep. Zie Poorten openen voor een virtuele machinevoor gedetailleerde informatie.

5. Kopieer dit bestand naar de computer waarop u Visual Studio uitvoert.

De publicatie-instellingen importeren in Visual Studio en implementeren

1. Klik op de computer waarop u het ASP.NET-project in Visual Studio hebt geopend, met de rechtermuisknop op het project in Solution Explorer, en kies Publiceren.

   Als u eerder publicatieprofielen hebt geconfigureerd, wordt het deelvenster Publiceren weergegeven. Klik op Nieuw of Nieuw profiel maken.

2. Selecteer de optie om een profiel te importeren.

   Klik in het dialoogvenster Publiceren op Profiel importeren.

   

3. Navigeer naar de locatie van het publicatie-instellingenbestand dat u in de vorige sectie hebt gemaakt.

4. Navigeer in het dialoogvenster Publicatie-instellingenbestand importeren naar het profiel dat u in de vorige sectie hebt gemaakt en klik op Openen.

   Klik op voltooien om het publicatieprofiel op te slaan en klik vervolgens op Publiceren.

   Visual Studio begint het implementatieproces en het uitvoervenster toont de voortgang en resultaten.

   Als er implementatiefouten optreden, klikt u op Meer acties>Bewerken om instellingen te bewerken. Wijzig de instellingen en klik op Valideer om nieuwe instellingen te testen. Als de hostnaam niet wordt gevonden, probeert u het IP-adres in plaats van de hostnaam in de velden Server en Doel-URL.

   

Nadat de app is geïmplementeerd, wordt deze automatisch gestart.

• Als de app niet start na de implementatie, start u de app in IIS om te controleren of deze correct wordt uitgevoerd.
• Controleer voor ASP.NET Core of het veld Groep van toepassingen voor de DefaultAppPool- is ingesteld op Geen beheerde code.

Wanneer u klaar bent, schakelt u over naar een foutopsporingsconfiguratie.

Belangrijk

Als u ervoor kiest om fouten in een releaseconfiguratie op te sporen, schakelt u foutopsporing in het web.config-bestand uit wanneer u publiceert.

1. Selecteer Meer opties> bewerken om het profiel te bewerken en selecteer vervolgens Instellingen.
2. Selecteer Opslaan en publiceer de app opnieuw.
3. Selecteer een Foutopsporing configuratie en selecteer vervolgens Extra bestanden verwijderen op doel onder de opties Bestand publiceren.

Waarschuwing

Het gebruik van inloggegevens voor gebruikersnaam en wachtwoord (basisauthenticatie) is niet de veiligste methode van authenticatie. Gebruik waar mogelijk alternatieve methoden. U kunt bijvoorbeeld publiceren naar een pakket vanuit Visual Studio en vervolgens WebDeploy.exe vanaf een opdrachtregel gebruiken om het pakket te implementeren. Met deze methode kunt u IIS-beheer gebruiken om geautoriseerde Windows-gebruikers te configureren die naar de webserver kunnen publiceren en WebDeploy.exe uitvoeren onder dat Windows-gebruikersaccount. Zie Web Deploy installeren en configureren op IIS 8.0 of hoger. Als u wel wachtwoordreferenties gebruikt, moet u een sterk wachtwoord gebruiken en ervoor zorgen dat het wachtwoord niet wordt gelekt of gedeeld.

(Optioneel) Implementeren door te publiceren naar een lokale map

U kunt deze optie gebruiken om uw app te implementeren als u de app wilt kopiëren naar IIS met behulp van PowerShell, RoboCopy of als u de bestanden handmatig wilt kopiëren.

De ASP.NET Core-website op de Windows Server-computer configureren

1. Open Windows Verkenner en maak een nieuwe map, C:\Publish, om het ASP.NET Core-project te implementeren.

2. Als Internet Information Services (IIS) Managernog niet is geopend, opent u deze. (Selecteer in het linkerdeelvenster van Serverbeheer IIS-. Klik met de rechtermuisknop op de server en selecteer IIS-beheer (Internet Information Services).)

3. Ga onder Verbindingen in het linker paneel naar Sites.

4. Selecteer de standaardwebsite, kies basisinstellingenen stel het fysiek pad in op C:\Publish.

5. Klik met de rechtermuisknop op het knooppunt Standaardwebsite en selecteer Toepassing toevoegen.

6. Stel het veld Alias in op MyASPApp-, accepteer de standaardtoepassingsgroep (DefaultAppPool) en stel het fysieke pad in op C:\Publish.

7. Selecteer bij ConnectionsApplication Pools. Open DefaultAppPool- en stel het veld Toepassingsgroep in op Geen beheerde code.

8. Klik met de rechtermuisknop op de nieuwe site in IIS-beheer, kies Machtigingen bewerkenen zorg ervoor dat IUSR, IIS_IUSRS of de gebruiker die is geconfigureerd voor toegang tot de web-app een geautoriseerde gebruiker is met de rechten Lezen & Uitvoeren.

   Als u een van deze gebruikers met toegang niet ziet, voert u de stappen uit om IUSR toe te voegen als gebruiker met leesrechten & Execute.

Belangrijk

Zie Understanding Built-In User and Group Accounts in IIS 7voor beveiligingsinformatie met betrekking tot de ingebouwde accounts.

Publiceer en implementeer de app door vanuit Visual Studio naar een lokale map te publiceren.

U kunt de app ook publiceren en implementeren met behulp van het bestandssysteem of andere hulpprogramma's.

1. Klik in Solution Explorermet de rechtermuisknop op het projectknooppunt en selecteer Publiceren (voor Webformulieren Web-app publiceren).

   Als u eerder publicatieprofielen hebt geconfigureerd, wordt het deelvenster Publiceren weergegeven. Klik op Nieuw profiel.

2. Selecteer in het dialoogvenster Publiceren de Map, klik op Bladerenen maak een nieuwe map C:\Publish.

   

   Klik op Voltooien om het publicatieprofiel op te slaan.

3. Schakel over naar een foutopsporingsconfiguratie.

   Kies bewerken om het profiel te bewerken en kies vervolgens Instellingen. Kies een Foutopsporing configuratie en kies vervolgens Extra bestanden verwijderen op doel onder de opties Bestand publiceren.

   

   Notitie

   Als u een release-build gebruikt, schakelt u foutopsporing in het web.config-bestand uit wanneer u publiceert.

4. Klik op Publiceren.

   De toepassing publiceert een Debug configuratie van het project in de lokale map. Voortgang wordt weergegeven in het venster Uitvoer.

5. Kopieer de ASP.NET projectmap van de Visual Studio-computer naar de lokale map die is geconfigureerd voor de ASP.NET-app (in dit voorbeeld C:\Publish) op de Windows Server-computer. In deze zelfstudie wordt ervan uitgegaan dat u handmatig kopieert, maar u kunt andere hulpprogramma's gebruiken, zoals PowerShell, Xcopy of Robocopy.

   Voorzichtigheid

   Als u wijzigingen wilt aanbrengen in de code of opnieuw moet bouwen, moet u deze stap opnieuw publiceren en herhalen. Het uitvoerbare bestand dat u naar de externe computer hebt gekopieerd, moet exact overeenkomen met uw lokale bron en symbolen. Als u dit niet doet, ontvangt u een cannot find or open the PDB file waarschuwing in Visual Studio wanneer u probeert fouten in het proces op te sporen.

6. Controleer op de Windows Server of u de app correct kunt uitvoeren door de app in uw browser te openen.

   Als de app niet correct wordt uitgevoerd, komt de versie van ASP.NET mogelijk niet overeen met de versie van ASP.NET geïnstalleerd op uw server en uw Visual Studio-computer, of hebt u mogelijk een probleem met de configuratie van uw IIS- of website. Controleer eerdere stappen opnieuw.

De externe hulpprogramma's op Windows Server downloaden en installeren

Download de versie van de externe hulpprogramma's die overeenkomen met uw versie van Visual Studio.

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 meest recente update van de externe hulpprogramma's voor uw versie van Visual Studio. Eerdere versies van externe hulpprogramma's zijn niet compatibel met latere Versies van Visual Studio. (Als u bijvoorbeeld Visual Studio 2019 gebruikt, downloadt u de nieuwste update van de externe hulpprogramma's voor Visual Studio 2019. In dit scenario downloadt u de externe hulpprogramma's voor Visual Studio 2022 niet.)
• 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	Verbinden	Notities
Visual Studio 2022	Externe hulpprogramma's	Compatibel met alle Visual Studio 2022-versies. Download de versie die overeenkomt met het besturingssysteem van uw apparaat (x86, x64 (AMD64) of ARM64. Op oudere versies van Windows Server, zie de bestandsblokkering opheffen voor hulp bij het downloaden van de externe tools.
Visual Studio 2019	Externe gereedschappen	Externe hulpprogramma's voor Visual Studio 2019 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan de gratis Visual Studio Dev Essentials programma 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 ontgrendelen van bestanddownloads op oudere versies van Windows Server voor hulp bij het downloaden van de externe tools.
Visual Studio 2017	Externe hulpprogramma's	Externe hulpprogramma's voor Visual Studio 2017 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan de gratis Visual Studio Dev Essentials programma 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 op Windows Server Het downloaden van bestanden deblokkeren voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2015	Externe hulpprogramma's	Externe hulpprogramma's voor Visual Studio 2015 zijn beschikbaar via My.VisualStudio.com. Als u hierom wordt gevraagd, kunt u deelnemen aan de gratis Visual Studio Dev Essentials programma of u aanmelden met uw Visual Studio-abonnements-id. Zie op Windows Server Het downloaden van bestanden deblokkeren voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2013	Externe hulpmiddelen	Downloadpagina in documentatie voor Visual Studio 2013
Visual Studio 2012	Externe hulpprogramma's	Downloadpagina in documentatie voor Visual Studio 2012

U kunt het externe foutopsporingsprogramma uitvoeren door msvsmon.exe te kopiëren naar de externe computer in plaats van de externe hulpprogramma's te installeren. De wizard voor de configuratie van de remote debugger (rdbgwiz.exe) is echter alleen beschikbaar wanneer u de remote 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 servicevoor meer informatie.

Notitie

• Als u fouten wilt opsporen in Windows 10- of hoger-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.

Het externe foutopsporingsprogramma instellen op Windows Server

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

   Als u geen beheerdersmachtigingen op de externe computer hebt, klikt u met de rechtermuisknop op de externe foutopsporingsprogramma-app en selecteert u Als administrator uitvoeren. 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 Remote Debugger-app en selecteert u Als administrator uitvoeren. Voor meer informatie, zie Het externe foutopsporingsprogramma uitvoeren als beheerder.

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

   Kies in de meeste scenario's Volgende totdat u bij de pagina Windows Firewall configureren van de wizard komt.

   

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 het opnieuw starten vanuit het menu Start of vanaf de opdrachtregel:

<Remote debugger installation directory>\msvsmon.exe

Notitie

Als u machtigingen wilt toevoegen voor extra gebruikers, de verificatiemodus of het poortnummer voor het externe foutopsporingsprogramma wilt wijzigen, raadpleegt u Het externe foutopsporingsprogramma configureren.

Zie Het externe foutopsporingsprogramma uitvoeren als een servicevoor meer informatie over het uitvoeren van het externe foutopsporingsprogramma als een service.

Koppelen aan de ASP.NET Core-toepassing vanaf de Visual Studio-computer

Vanaf Visual Studio 2022 versie 17.10 Preview 2 is het dialoogvenster Koppelen aan proces gewijzigd. Als u instructies nodig hebt die overeenkomen met het oudere dialoogvenster, schakelt u over naar de visual Studio 2019-weergave (linkerbovenhoek van de versiekiezer in het artikel).

1. Open op de Visual Studio-computer de oplossing die u probeert op te sporen (MyASPApp als u alle stappen in dit artikel volgt).

2. Selecteer in Visual Studio Foutopsporing > Koppelen aan proces (Ctrl + Alt + P).

   Fooi

   In Visual Studio 2017 en nieuwere versies kunt u opnieuw koppelen aan hetzelfde proces dat u eerder hebt gekoppeld met behulp van Foutopsporing > Opnieuw koppelen aan Proces... (Shift + Alt + P).

3. Stel het verbindingstype in op Externe (Windows).

   De optie verbindingsdoel wordt weergegeven.

   Stel de doelverbinding in op <externe computernaam> en druk op Enter .

   Controleer of Visual Studio de vereiste poort toevoegt aan de computernaam, die wordt weergegeven in de indeling: <externe computernaam>:poort

   In Visual Studio 2022 ziet u <externe computernaam>:4026

   De poort is vereist. Als u het poortnummer niet ziet, voegt u dit handmatig toe.

4. Selecteer Vernieuwen.

   Er worden enkele processen weergegeven in het venster Beschikbare processen.

   Als u geen processen ziet, gebruikt u het IP-adres in plaats van de naam van de externe computer (de poort is vereist). U kunt ipconfig in een opdrachtregel gebruiken om het IPv4-adres op te halen.

   Als u de knop Zoeken wilt gebruiken, moet u mogelijk de uitgaande UDP-poort 3702 op de server openen.

5. Controleer Processen van alle gebruikers weergeven.

6. Typ de eerste letter van uw procesnaam om snel uw app te vinden.

   • Als u het in-process hostingmodel gebruikt op IIS, selecteert u het juiste w3wp.exe proces. Vanaf .NET Core 3 is dit proces de standaardinstelling.

   • Selecteer anders het dotnet.exe proces. (Dit is het out-of-process hosting model.)

   Als u meerdere processen hebt met w3wp.exe of dotnet.exe, controleert u de kolom gebruikersnaam. In sommige scenario's toont de kolom Gebruikersnaam de naam van uw app-pool, zoals IIS APPPOOL\DefaultAppPool. Als u de app-pool ziet, maar deze niet uniek is, maakt u een nieuwe benoemde app-pool voor het app-exemplaar dat u wilt opsporen en kunt u deze eenvoudig vinden in de kolom gebruikersnaam.

   

7. Selecteer en voegbij.

8. Open de website van de externe computer. Ga in een browser naar http://<externe computernaam>.

   U ziet nu de ASP.NET webpagina.

9. Selecteer in de actieve ASP.NET-toepassing de koppeling naar de pagina Privacy.

   Het onderbrekingspunt moet worden bereikt in Visual Studio.

   Als je het onderbrekingspunt niet kunt koppelen of bereiken, zie dan Problemen met externe debugging oplossen.

Problemen met IIS-implementatie oplossen

• Als u geen verbinding kunt maken met de host met behulp van de hostnaam, probeert u in plaats daarvan het IP-adres.
• Zorg ervoor dat de vereiste poorten zijn geopend op de externe server.
• Voor ASP.NET Core moet u ervoor zorgen dat het veld Groep van toepassingen voor de DefaultAppPool- is ingesteld op Geen beheerde code.
• Controleer of de versie van ASP.NET die in uw app wordt gebruikt, gelijk is aan de versie die u op de server hebt geïnstalleerd. Voor uw app kunt u de versie bekijken en instellen op de pagina Eigenschappen. Als u de app wilt instellen op een andere versie, moet die versie zijn geïnstalleerd.
• Als de app probeert te openen, maar u een certificaatwaarschuwing ziet, kiest u ervoor om de site te vertrouwen. Als u de waarschuwing al hebt gesloten, kunt u het publicatieprofiel, een *.pubxml-bestand, in uw project bewerken en het volgende element toevoegen (alleen voor test): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Nadat de app is geïmplementeerd, start u de app in IIS om te testen of deze correct is geïmplementeerd.
• Controleer het uitvoervenster in Visual Studio op statusinformatie en controleer uw foutberichten.

Vereiste poorten openen op Windows Server

In de meeste instellingen worden vereiste poorten geopend door de installatie van ASP.NET en het externe foutopsporingsprogramma. Mogelijk moet u echter controleren of poorten zijn geopend.

Notitie

Op een Virtuele Azure-machine moet u poorten openen via de netwerkbeveiligingsgroep.

Vereiste poorten:

• 80: vereist voor IIS (HTTP).

• 4026: Vereist voor externe foutopsporing vanuit Visual Studio 2022 (zie Poorttoewijzingen voor externe foutopsporingsprogramma's voor meer informatie).

• Met de detectiepoort UDP 3702: (optioneel) kunt u de knop Zoeken gebruiken bij het koppelen aan het externe foutopsporingsprogramma in Visual Studio.

Bovendien moeten deze poorten al worden geopend door de ASP.NET installatie:

• 8172: (optioneel) Vereist voor Web Deploy om de app te implementeren vanuit Visual Studio

Een poort openen

1. Als u een poort op Windows Server wilt openen, opent u het menu Start, zoekt u naar Windows Defender Firewall- of Windows Firewall met geavanceerde beveiliging.

   Voor Windows Defender Firewall-kiest u Geavanceerde instellingen.

2. Kies vervolgens Regels voor inkomend verkeer > Nieuwe regel > Poorten selecteer vervolgens Volgende. (Voor UDP 3702 kiest u in plaats daarvan uitgaande regels.)

3. Voer onder Specifieke lokale poortenhet poortnummer in en selecteer Volgende.

4. Selecteer De verbindingtoestaan, selecteer Volgende.

5. Selecteer een of meer netwerktypen die u wilt inschakelen voor de poort en selecteer Volgende.

   Het type dat u selecteert, moet het netwerk bevatten waarmee de externe computer is verbonden.

6. Voeg de naam (bijvoorbeeld IIS-, Web Deployof msvsmon) toe voor de regel voor inkomend verkeer en selecteer Voltooien.

   U ziet de nieuwe regel in de lijst Binnenkomende regels of Regels voor uitgaand verkeer.

   Zie Windows Firewall configureren voor externe foutopsporingals u meer informatie wilt over het configureren van Windows Firewall.

7. Maak meer regels voor de andere vereiste poorten.