Externe foutopsporing ASP.NET op een externe IIS-computer

Als u fouten wilt opsporen in een ASP.NET 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 MVC 4.8-toepassing instelt en configureert, implementeert in IIS en het externe foutopsporingsprogramma koppelt vanuit Visual Studio.

Notitie

Zie in plaats daarvan Externe foutopsporing ASP.NET Core op een IIS-computervoor externe foutopsporing ASP.NET Core. Zie voor Azure App Service Externe foutopsporing van 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 2012 R2 en IIS 8 (voor Windows Server 2008 R2 zijn de serverstappen anders)

Netwerkvereisten

Het externe foutopsporingsprogramma wordt ondersteund op Windows Server vanaf Windows Server 2008 Service Pack 2. Zie Vereistenvoor een volledige lijst met vereisten.

Notitie

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.

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 bij het instellen, implementeren en correct uitvoeren van uw app in IIS, zodat u fouten kunt opsporen, volgt u alle stappen in dit artikel.

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

1. Maak een nieuwe MVC-ASP.NET-toepassing.

   Kies in Visual Studio Bestand>startvenster om het startvenster te openen en kies vervolgens Een nieuw project maken. Typ asp.net frameworkin het zoekvak en kies ASP.NET Web Application (.NET Framework). Geef in het dialoogvenster dat wordt weergegeven het project de naam MyASPApp, kies ASP.NET Framework 4.8en kies vervolgens Maken.

   Selecteer MVC en kies Aanmaken.

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 stap Rollenservices de gewenste IIS-rollenservices of accepteer de standaardrollenservices die worden aangeboden. 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
• Beheerdienst
• 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.

Installeer ASP.NET 4.8 op Windows Server

Als u meer gedetailleerde informatie wilt over het installeren van ASP.NET op IIS, raadpleegt u IIS 8.0 Met ASP.NET 3.5 en ASP.NET 4,5.

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 afschaffen van de product-/toepassingsfeed. U kunt ASP.NET 4.8 rechtstreeks installeren vanuit IIS.

1. Selecteer in het linkerdeelvenster van Serverbeheer IIS-. Klik met de rechtermuisknop op de server en selecteer Functies en onderdelen toevoegen.

2. Ga in de wizard naar de sectie Functies en installeer ASP.NET 4.8.

   

   Notitie

   Als u Windows Server 2008 R2 gebruikt, installeert u in plaats daarvan ASP.NET 4 met behulp van deze opdracht:

   C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir

3. Start het systeem opnieuw (of voer net stop was /y gevolgd door net start w3svc uit vanaf een opdrachtprompt om een wijziging in de systeem-PATH op te halen).

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

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 agentservices niet wordt uitgevoerd, start u de webimplementatieagentservice opnieuw.

   Als de Web Deployment Agent Service helemaal niet aanwezig is, gaat u naar Configuratiescherm > Programma's > Een programma verwijderen, zoekt u Microsoft Web Deploy <versie>. Kies Wijzig de installatie en zorg ervoor dat u Zal geïnstalleerd worden op de lokale harde schijf kiest 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 het 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. Op de computer waar u het ASP.NET-project in Visual Studio hebt geopend, klikt u met de rechtermuisknop op het project in Solution Explorer, en kiest u 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.

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 een Foutopsporing configuratie en selecteer vervolgens Extra bestanden verwijderen op doel onder de opties Bestand publiceren.
3. Selecteer Opslaan en publiceer de app opnieuw.

Waarschuwing

Het gebruik van inloggegevens voor gebruikersnaam en wachtwoord (basisauthenticatie) is niet de veiligste authenticatiemethode. 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-website op de Windows Server-computer configureren

1. Open Windows Verkenner en maak een nieuwe map, C:\Publish, waar u het ASP.NET project later implementeert.

2. Als deze nog niet is geopend, opent u het IIS-beheer (Internet Information Services). (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 linkerdeelvenster 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 onder Connectionsde optie Application Pools. Open DefaultAppPool en stel het veld Groep van toepassingen in op ASP.NET v4.0 (ASP.NET 4.5 is geen optie voor de groep toepassingen).

8. Als de site is geselecteerd in IIS-beheer, kiest u Machtigingen bewerkenen zorgt u ervoor dat IUSR, IIS_IUSRS of de gebruiker die is geconfigureerd voor de groep van toepassingen 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 deze te publiceren naar een lokale map vanuit Visual Studio.

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

Controleer voor ASP.NET 4.8 of het bestand web.config de juiste versie van .NET bevat.

• Als u zich op ASP.NET 4.8 richt, controleert u of deze versiewaarde wordt vermeld in het bestand web.config:

      <system.web>
        <compilation debug="true" targetFramework="4.8" />
        <httpRuntime targetFramework="4.8" />
        <httpModules>
          <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" />
        </httpModules>
      </system.web>
      ```
  
  

• Als u ASP.NET 4 installeert in plaats van 4.8, moet de versiewaarde worden opgegeven als 4.0 in het bestand web.config.

Volg deze stappen om de app te publiceren en implementeren:

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 Publicerenmap, 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 naar 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. Zie op oudere versies van Windows Server voor het deblokkeren van het downloaden van bestanden voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2019	Externe hulpprogramma's	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. In oudere versies van Windows Server, zie om het downloaden van bestanden te deblokkeren voor hulp bij het downloaden van de externe hulpprogramma's.
Visual Studio 2017	Afstandsbedieningstools	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 hulpprogramma's	Downloadpagina in documentatie voor Visual Studio 2013
Visual Studio 2012	Externe hulpmiddelen	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 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 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. Zie Het externe foutopsporingsprogramma uitvoeren als beheerdervoor 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.

   Kies in de meeste scenario's Volgende totdat u op de Configureer de Windows Firewall pagina 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-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 Debuggen > Aan proces koppelen (Ctrl + Alt + P).

   Tip

   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 verbindingsdoel- 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 de naam van de externe computer<>: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 uitgaande UDP-poort 3702 openen op de server openen.

5. Controleer Processen van alle gebruikers weergeven.

6. Typ de eerste letter van een procesnaam om snel w3wp.exe voor ASP.NET 4,5 te vinden.

   Als u meerdere processen hebt met w3wp.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, kunt u eenvoudig het juiste proces identificeren door een nieuwe benoemde app-pool te maken voor het app-exemplaar dat u wilt opsporen en kunt u deze eenvoudig vinden in de kolom Gebruikersnaam.

   

7. Selecteer en voegtoe.

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.

   Zie Problemen met externe foutopsporing oplossenals u het onderbrekingspunt niet kunt koppelen of bereiken.

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

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

• 4024: Vereist voor externe foutopsporing vanuit Visual Studio 2019 (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 > Poort. Kies Volgende en selecteer onder Specifieke lokale poortenhet poortnummer, selecteer Volgende, De verbindingtoestaan, selecteer Volgende en voeg de naam (IIS-, Web Deployof msvsmon) toe voor de regel voor inkomend verkeer.

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

3. Maak meer regels voor de andere vereiste poorten.