Remotedebuggen von ASP.NET Core in IIS in Azure in Visual StudioRemote Debug ASP.NET Core on IIS in Azure in Visual Studio

In diesem Leitfaden wird erläutert, wie Sie eine Visual Studio ASP.NET Core-App einrichten, konfigurieren und mithilfe von Azure in IIS bereitstellen. Außerdem wird beschrieben, wie Sie den Remotedebugger aus Visual Studio anfügen.This guide explains how to set up and configure a Visual Studio ASP.NET Core app, deploy it to IIS using Azure, and attach the remote debugger from Visual Studio.

Die empfohlene Vorgehensweise für das Remotedebuggen in Azure hängt von Ihrem Szenario ab:The recommended way to remote debug on Azure depends on your scenario:

  • Informationen zum Debuggen von ASP.NET Core in Azure App Service finden Sie unter Debuggen von Azure-Apps mit dem Momentaufnahmedebugger.To debug ASP.NET Core on Azure App Service, see Debug Azure apps using the Snapshot Debugger. Dies ist die empfohlene Methode.This is the recommended method.

  • Um ASP.NET Core in Azure App Service mithilfe von herkömmlichen Debugfunktionen zu debuggen, führen Sie die Schritte in diesem Thema aus (siehe Abschnitt Remotedebuggen in Azure App Service).To debug ASP.NET Core on Azure App Service using more traditional debugging features, follow steps in this topic (see the section Remote debug on Azure App Service).

    In diesem Szenario müssen Sie die App aus Visual Studio in Azure bereitstellen, aber Sie müssen IIS oder den Remotedebugger (diese Komponenten werden durch gepunktete Linien dargestellt) nicht manuell installieren oder konfigurieren, wie in der folgenden Abbildung dargestellt.In this scenario, you must deploy your app from Visual Studio to Azure but you do not need to manually install or configure IIS or the remote debugger (these components are represented with dotted lines), as shown in the following illustration.

    RemotedebuggerkomponentenRemote debugger components

  • Um IIS auf einer Azure-VM zu debuggen, führen Sie die Schritte in diesem Thema aus (weitere Informationen finden Sie im Abschnitt Remotedebuggen auf einer Azure-VM).To debug IIS on an Azure VM, follow steps in this topic (see the section Remote Debug on an Azure VM). Dies ermöglicht es Ihnen, eine angepasste Konfiguration von IIS zu verwenden, die Einrichtungs- und Bereitstellungsschritte sind jedoch komplizierter.This allows you to use a customized configuration of IIS, but the setup and deployment steps are more complicated.

    Für eine Azure-VM müssen Sie Ihre App aus Visual Studio in Azure bereitstellen. Außerdem müssen Sie die IIS-Rolle und den Remotedebugger manuell installieren, wie in der folgenden Abbildung gezeigt.For an Azure VM, you must deploy your app from Visual Studio to Azure and you also need to manually install the IIS role and the remote debugger, as shown in the following illustration.

    RemotedebuggerkomponentenRemote debugger components

  • Informationen zum Debuggen von ASP.NET Core in Azure Service Fabric finden Sie unter Debuggen einer Service Fabric-Remoteanwendung.To debug ASP.NET Core on Azure Service Fabric, see Debug a remote Service Fabric application.

Warnung

Stellen Sie sicher, dass Sie die Azure-Ressourcen löschen, die Sie erstellt haben, nachdem Sie die Schritte in diesem Tutorial ausgeführt haben.Be sure to delete the Azure resources that you create when you have completed the steps in this tutorial. Auf diese Weise können Sie unnötige Kosten vermeiden.That way you can avoid incurring unnecessary charges.

VoraussetzungenPrerequisites

Visual Studio 2019 ist erforderlich, um die in diesem Artikel gezeigten Schritte auszuführen.Visual Studio 2019 is required to follow the steps shown in this article.

Visual Studio 2017 ist erforderlich, um die in diesem Artikel gezeigten Schritte auszuführen.Visual Studio 2017 is required to follow the steps shown in this article.

NetzwerkanforderungenNetwork requirements

Das Debuggen zwischen zwei über einen Proxy verbundenen Computern wird nicht unterstützt.Debugging between two computers connected through a proxy is not supported. Das Debuggen über eine Verbindung mit hoher Latenz oder geringer Bandbreite (z. B. eine Interneteinwählverbindung oder länderübergreifend über das Internet) wird nicht empfohlen und kann fehlschlagen oder inakzeptabel langsam sein.Debugging over a high latency or low bandwidth connection, such as dialup Internet, or over the Internet across countries is not recommended and may fail or be unacceptably slow. Eine vollständige Liste der Anforderungen finden Sie unter Anforderungen.For a complete list of requirements, see Requirements.

Erstellen der ASP.NET Core-Anwendung auf dem Visual Studio-ComputerCreate the ASP.NET Core application on the Visual Studio computer

  1. Erstellen Sie eine neue ASP.NET Core-Anwendung.Create a new ASP.NET Core application.

    Geben Sie in Visual Studio 2019 STRG+Q ein, um das Suchfeld zu öffnen, geben Sie asp.net ein, und wählen Sie Vorlagen und dann Neue ASP.NET Core-Webanwendung erstellen aus.In Visual Studio 2019, type Ctrl + Q to open the search box, type asp.net, choose Templates, then choose Create new ASP.NET Core Web Application. Nennen Sie das Projekt im Dialogfeld, das nun geöffnet wird, MyASPApp, und wählen Sie dann Erstellen aus.In the dialog box that appears, name the project MyASPApp, and then choose Create. Wählen Sie dann die Option Webanwendung (Model-View-Controller) aus, und klicken Sie auf Erstellen.Next, choose Web Application (Model-View-Controller), and then choose Create.

    Wählen Sie in Visual Studio 2017 Datei > Neu > Projekt und dann Visual C# > Web > ASP.NET Core-Webanwendung aus.In Visual Studio 2017, choose File > New > Project, then select Visual C# > Web > ASP.NET Core Web Application. Wählen Sie im Abschnitt zu den ASP.NET Core-Vorlagen Webanwendung (Model-View-Controller) aus.In the ASP.NET Core templates section, select Web Application (Model-View-Controller). Stellen Sie sicher, dass ASP.NET Core 2.1 ausgewählt ist, dass Docker-Unterstützung aktivieren nicht ausgewählt ist und dass Authentifizierungs auf Keine Authentifizierungs festgelegt ist.Make sure that ASP.NET Core 2.1 is selected, that Enable Docker Support is not selected and that Authentication is set to No Authentication. Geben Sie dem Projekt den Namen MyASPApp.Name the project MyASPApp.

  2. Öffnen Sie die Datei „About.cshtml.cs“, und legen Sie einen Breakpoint in der OnGet-Methode fest (in älteren Vorlagen öffnen Sie stattdessen „HomeController.cs“ und legen den Breakpoint in der About()-Methode fest).Open the About.cshtml.cs file and set a breakpoint in the OnGet method (in older templates, open HomeController.cs instead and set the breakpoint in the About() method).

Remotedebuggen von ASP.NET Core in Azure App ServiceRemote Debug ASP.NET Core on an Azure App Service

Aus Visual Studio können Sie Ihre App schnell in einer vollständig bereitgestellten Instanz von IIS veröffentlichen und debuggen.From Visual Studio, you can quickly publish and debug your app to a fully provisioned instance of IIS. Allerdings ist die Konfiguration von IIS voreingestellt, und Sie können sie nicht anpassen.However, the configuration of IIS is preset and you cannot customize it. Ausführlichere Anweisungen dazu finden Sie unter Veröffentlichen einer ASP.NET Core-App in Azure mit Visual Studio.For more detailed instructions, see Deploy an ASP.NET Core web app to Azure using Visual Studio. (Wenn Sie eine Möglichkeit zum Anpassen von IIS benötigen, versuchen Sie, das Debuggen auf einer Azure-VM auszuführen.)(If you need the ability to customize IIS, try debugging on an Azure VM.)

So stellen Sie die App und Remotedebuggen mit Cloud-Explorer bereitTo deploy the app and remote debug using Cloud Explorer

  1. Klicken Sie in Visual Studio mit der rechten Maustaste auf den Projektknoten, und wählen Sie dann Veröffentlichen aus.In Visual Studio, right-click the project node and choose Publish.

    Wenn Sie bereits Veröffentlichungsprofile konfiguriert haben, wird der Bereich Veröffentlichen angezeigt.If you have previously configured any publishing profiles, the Publish pane appears. Klicken Sie auf Neues Profil.Click New profile.

  2. Wählen Sie Azure App Service im Dialogfeld Veröffentlichen aus, wählen Sie die Option Neu erstellen aus, und befolgen Sie die Anweisungen, um ein Profil zu erstellen.Choose Azure App Service from the Publish dialog box, select Create New, and follow the prompts to create a profile.

    Ausführliche Anweisungen finden Sie unter Veröffentlichen einer ASP.NET Core-App in Azure mit Visual Studio.For detailed instructions, see Deploy an ASP.NET Core web app to Azure using Visual Studio.

    Veröffentlichen in Azure App Service

  3. Wählen Sie im Fenster „Veröffentlichen“ Konfiguration bearbeiten aus, und wechseln Sie zu einer Debugkonfiguration. Wählen Sie dann Veröffentlichen aus.In the Publish window, choose Edit Configuration and switch to a Debug configuration, and then choose Publish.

    Eine Debugkonfiguration ist erforderlich, um die App zu debuggen.A Debug configuration is required to debug the app.

  4. Öffnen Sie Cloud-Explorer (Anzeigen > Cloud-Explorer), klicken Sie mit der rechten Maustaste auf die App Service-Instanz, und wählen Sie Debugger anfügen aus.Open Cloud Explorer (View > Cloud Explorer), right-click on the App Service instance and choose Attach Debugger.

    Wenn Cloud-Explorer nicht verfügbar ist, öffnen Sie stattdessen Server-Explorer.If Cloud Explorer is not available, open Server Explorer instead. Klicken Sie dann mit der rechten Maustaste auf die App Service-Instanz in Server-Explorer, und wählen Sie Debugger anfügen aus.Then, right-click on the App Service instance in Server Explorer and choose Attach Debugger.

  5. Klicken Sie in der ausgeführten ASP.NET-Anwendung auf den Link zur Seite Info.In the running ASP.NET application, click the link to the About page.

    Der Haltepunkt sollte in Visual Studio erreicht werden.The breakpoint should be hit in Visual Studio.

    Das ist alles!That's it! Die restlichen Schritte in diesem Thema gelten für Remotedebuggen auf einer Azure-VM.The rest of the steps in this topic apply to remote debugging on an Azure VM.

Remotedebuggen von ASP.NET Core auf einer Azure-VMRemote Debug ASP.NET Core on an Azure VM

Sie können eine Azure-VM für Windows Server erstellen und anschließend IIS und die anderen erforderlichen Softwarekomponenten installieren und konfigurieren.You can create an Azure VM for Windows Server and then install and configure IIS and the other required software components. Dies nimmt mehr Zeit als die Bereitstellung für einen Azure App Service in Anspruch und erfordert, dass Sie die verbleibenden Schritte in diesem Tutorial ausführen.This takes more time than deploying to an Azure App Service and requires that you follow the remaining steps in this tutorial.

Diese Verfahren wurden für die folgenden Serverkonfigurationen getestet:These procedures have been tested on these server configurations:

  • Windows Server 2012 R2 und IIS 8Windows Server 2012 R2 and IIS 8
  • Windows Server 2016 und IIS 10Windows Server 2016 and IIS 10
  • Windows Server 2019 und IIS 10Windows Server 2019 and IIS 10

Wird die App bereits in IIS auf der Azure-VM ausgeführt?App already running in IIS on the Azure VM?

Dieser Artikel enthält Schritte zum Einrichten einer Basiskonfiguration von IIS unter Windows Server und zum Bereitstellen der App aus Visual Studio.This article includes steps on setting up a basic configuration of IIS on Windows server and deploying the app from Visual Studio. Diese Schritte sind enthalten, um sicherzustellen, dass auf dem Server die erforderlichen Komponenten installiert sind, dass die App ordnungsgemäß ausgeführt werden kann und dass Sie für Remotedebuggen bereit sind.These steps are included to make sure that the server has the required components installed, that the app can run correctly, and that you are ready to remote debug.

  • Wenn Ihre App in IIS ausgeführt wird und Sie nur den Remotedebugger herunterladen und mit dem Debuggen starten möchten, navigieren Sie zu Herunterladen und Installieren der Remotetools unter Windows Server.If your app is running in IIS and you just want to download the remote debugger and start debugging, go to Download and Install the remote tools on Windows Server.

  • Wenn Sie sicherstellen möchten, dass Ihre App in IIS ordnungsgemäß eingerichtet, bereitgestellt und ausgeführt wird, damit Sie mit dem Debuggen beginnen können, führen Sie alle Schritte in diesem Thema aus.If you want help to make sure that your app is set up, deployed, and running correctly in IIS so that you can debug, follow all the steps in this topic.

    • Bevor Sie beginnen, führen Sie alle Schritte aus, die unter Installieren und Ausführen von IIS beschrieben werden.Before you begin, follow all the steps described in Install and run IIS.

    • Wenn Sie Port 80 in der Netzwerksicherheitsgruppe öffnen, öffnen Sie auch den richtigen Port für den Remotedebugger (4024 oder 4022).When you open port 80 in the Network security group, also open the correct port for the remote debugger (4024 or 4022). Auf diese Weise müssen Sie ihn später nicht mehr öffnen.That way, you won't have to open it later. Wenn Sie Web Deploy verwenden, öffnen Sie auch Port 8172.If you're using Web Deploy, also open port 8172.

Aktualisieren der Sicherheitseinstellungen des Browsers unter Windows ServerUpdate browser security settings on Windows Server

Wenn die verstärkte Sicherheitskonfiguration in Internet Explorer aktiviert ist (sie ist standardmäßig aktiviert), müssen Sie möglicherweise einige Domänen als vertrauenswürdige Sites hinzufügen, damit Sie einige der Webserverkomponenten herunterladen können.If Enhanced Security Configuration is enabled in Internet Explorer (it is enabled by default), then you may need to add some domains as trusted sites to enable you to download some of the web server components. Fügen Sie die vertrauenswürdigen Sites hinzu, indem Sie zu Internetoptionen > Sicherheit > vertrauenswürdige Sites > Sites navigieren.Add the trusted sites by going to Internet Options > Security > Trusted Sites > Sites. Fügen Sie die folgenden Domänen hinzu.Add the following domains.

  • microsoft.commicrosoft.com
  • go.microsoft.comgo.microsoft.com
  • 0download.microsoft.comdownload.microsoft.com
  • iis.netiis.net

Wenn Sie die Software herunterladen, erhalten Sie möglicherweise Anforderungen zum Erteilen der Berechtigung zum Laden verschiedener Websiteskripts und -ressourcen.When you download the software, you may get requests to grant permission to load various web site scripts and resources. Einige dieser Ressourcen sind nicht erforderlich. Um den Vorgang zu vereinfachen, klicken Sie jedoch auf Hinzufügen, wenn Sie dazu aufgefordert werden.Some of these resources are not required, but to simplify the process, click Add when prompted.

Installieren von ASP.NET Core unter Windows ServerInstall ASP.NET Core on Windows Server

  1. Installieren Sie das Paket „.NET Core Hosting“ auf dem Hostingsystem.Install the .NET Core Hosting Bundle on the hosting system. Das Paket installiert die .NET Core-Runtime, die .NET Core-Bibliothek und das ASP.NET Core-Modul.The bundle installs the .NET Core Runtime, .NET Core Library, and the ASP.NET Core Module. Ausführlichere Informationen finden Sie unter IIS-Konfiguration.For more in-depth instructions, see Publishing to IIS.

    Installieren Sie für .NET Core 3 das .NET Core-Hostingpaket.For .NET Core 3, install the .NET Core Hosting Bundle. Installieren Sie für .NET Core 2 das Paket .NET Core Windows Server Hosting.For .NET Core 2, install the .NET Core Windows Server Hosting.

    Hinweis

    Wenn das System nicht über eine Internetverbindung verfügt, beziehen und installieren Sie Microsoft Visual C++ 2015 Redistributable , bevor Sie das Paket „.NET Core Windows Server Hosting“ installieren.If the system doesn't have an Internet connection, obtain and install the Microsoft Visual C++ 2015 Redistributable before installing the .NET Core Windows Server Hosting bundle.

  2. Starten Sie das System neu, oder führen Sie über eine Eingabeaufforderung net stop was /y gefolgt von net start w3svc aus, um eine Änderung am Systempfad zu übernehmen.Restart the system (or execute net stop was /y followed by net start w3svc from a command prompt to pick up a change to the system PATH).

Auswählen einer BereitstellungsoptionChoose a deployment option

Wenn Sie Hilfe bei der Bereitstellung der App in IIS benötigen, ziehen Sie die folgenden Optionen in Betracht:If you need help to deploy the app to IIS, consider these options:

  • Führen Sie die Bereitstellung aus, indem Sie eine Datei mit Veröffentlichungseinstellungen in IIS erstellen und die Einstellungen in Visual Studio importieren.Deploy by creating a publish settings file in IIS and importing the settings in Visual Studio. In einigen Szenarien ist dies eine schnelle Möglichkeit, Ihre App bereitzustellen.In some scenarios, this is a fast way to deploy your app. Wenn Sie die Datei mit den Veröffentlichungseinstellungen erstellen, werden Berechtigungen in IIS automatisch eingerichtet.When you create the publish settings file, permissions are automatically set up in IIS.

  • Führen Sie die Bereitstellung durch Veröffentlichen in einem lokalen Ordner und Kopieren der Ausgabe durch eine bevorzugte Methode in einen vorbereiteten App-Ordner in IIS aus.Deploy by publishing to a local folder and copying the output by a preferred method to a prepared app folder on IIS.

(Optional) Bereitstellung mithilfe einer Datei mit Veröffentlichungseinstellungen(Optional) Deploy using a publish settings file

Sie können diese Option verwenden, um eine Datei mit Veröffentlichungseinstellungen zu erstellen und in Visual Studio zu importieren.You can use this option create a publish settings file and import it into Visual Studio.

Hinweis

Bei dieser Bereitstellungsmethode wird Web Deploy verwendet und muss auf dem Server installiert sein.This deployment method uses Web Deploy, which must be installed on the server. Wenn Sie Web Deploy manuell in konfigurieren möchten, anstatt die Einstellungen zu importieren, können Sie Web Deploy 3.6 anstelle von Web Deploy 3.6 für Hostingserver installieren.If you want to configure Web Deploy manually instead of importing the settings, you can install Web Deploy 3.6 instead of Web Deploy 3.6 for Hosting Servers. Wenn Sie Web Deploy jedoch manuell konfigurieren, müssen Sie sicherstellen, dass ein App-Ordner auf dem Server mit den richtigen Werten und Berechtigungen konfiguriert ist (siehe Konfigurieren der ASP.NET-Website).However, if you configure Web Deploy manually, you will need to make sure that an app folder on the server is configured with the correct values and permissions (see Configure ASP.NET Web site).

Konfigurieren einer ASP.NET Core-WebsiteConfigure the ASP.NET Core web site

  1. Wählen Sie in IIS-Manager im linken Bereich unter Verbindungen die Option Anwendungspools aus.In IIS Manager, in the left pane under Connections, select Application Pools. Öffnen Sie DefaultAppPool, und legen Sie die .NET CLR-Version auf Kein verwalteter Code fest.Open DefaultAppPool and set the .NET CLR version to No Managed Code. Dies ist für ASP.NET Core erforderlich.This is required for ASP.NET Core. Die Standardwebsite verwendet DefaultAppPool.The Default Web Site uses the DefaultAppPool.

  2. Beenden Sie DefaultAppPool, und starten Sie ihn dann neu.Stop and restart the DefaultAppPool.

Installieren und Konfigurieren von Web Deploy für Hostingserver unter Windows ServerInstall and configure Web Deploy for Hosting Servers on Windows Server

Web Deploy 3.6 für Hostingserver umfasst zusätzliche Konfigurationsfeatures für die Erstellung der Datei mit Veröffentlichungseinstellungen über die Benutzeroberfläche.Web Deploy 3.6 for Hosting Servers provides additional configuration features that enable the creation of the publish settings file from the UI.

  1. Wenn Sie Web Deploy bereits unter Windows Server installiert haben, führen Sie über Einstellungen > Programme > Programm deinstallieren eine Deinstallation durch.If you have Web Deploy already installed on Windows Server, uninstall it using Control Panel > Programs > Uninstall a Program.

  2. Installieren Sie anschließend Web Deploy 3.6 für Hostingserver in Windows Server.Next, install Web Deploy 3.6 for Hosting Servers on Windows Server.

    Verwenden Sie den Webplattform-Installer (Web PI) für die Installation von Web Deploy für Hostingserver.To install Web Deploy for Hosting Servers, use the Web Platform Installer (WebPI). (Sie finden den Link zum Web PI über IIS, wenn Sie links im Server-Manager auf IIS klicken.(To find the Web Platform Installer link from IIS, select IIS in the left pane of Server Manager. Klicken sie zuerst im Serverbereich mit der rechten Maustaste auf den Server, und wählen Sie dann Internet Information Services (IIS) Manager (Internetinformationsdienste-Manager) aus.In the server pane, right-click the server and select Internet Information Services (IIS) Manager. Verwenden Sie dann den Link Neue Webplattformkomponenten abrufen im Fenster Aktionen. Sie können den Webplattform-Installer (Web PI) auch über Downloads abrufen.Then use the Get New Web Platform Components link in the Actions window.) You can also obtain the Web Platform Installer (WebPI) from downloads.

    Im Webplattform-Installer finden Sie Web Deploy 3.6 für Hostingserver auf der Registerkarte „Anwendungen“.In the Web Platform Installer, you find Web Deploy 3.6 for Hosting Servers in the Applications tab.

  3. Installieren Sie, falls noch nicht geschehen, die Verwaltungsskripts und -tools für IIS.If you did not already install IIS Management Scripts and Tools, install it now.

    Navigieren Sie zu Serverrollen auswählen > Web Server (IIS) > Verwaltungstools, wählen Sie die Rolle IIS Management Scripts and Tools (Verwaltungsskripts und -tools für IIS) aus, klicken Sie auf Weiter, und installieren Sie die Rolle.Go to Select server roles > Web Server (IIS) > Management Tools, and then select the IIS Management Scripts and Tools role, click Next, and then install the role.

    Installieren von Verwaltungsskripts und -tools für IIS

    Sie müssen die Skripts und Tools installieren, damit die Datei mit Veröffentlichungseinstellungen erstellt werden kann.The scripts and tools are required to enable the generation of the publish settings file.

  4. (Optional) Überprüfen Sie, ob Web Deploy ordnungsgemäß ausgeführt wird, indem Sie Einstellungen > System und Sicherheit > Verwaltung > Dienste öffnen und sich vergewissern, dass der:(Optional) Verify that Web Deploy is running correctly by opening Control Panel > System and Security > Administrative Tools > Services, and then make sure that:

    • Webbereitstellungs-Agent-Dienst ausgeführt wird (in älteren Versionen lautet der Dienstname anders).Web Deployment Agent Service is running (the service name is different in older versions).

    • Webverwaltungsdienst ausgeführt wird.Web Management Service is running.

    Wenn einer der Agent-Dienste nicht läuft, starten Sie den Webbereitstellungs-Agent-Dienst neu.If one of the agent services is not running, restart the Web Deployment Agent Service.

    Wenn der Webbereitstellungs-Agent-Dienst gar nicht vorhanden ist, navigieren Sie zu Einstellungen > Programm > Programm deinstallieren, und suchen Sie die Microsoft Web Deploy-<version> .If the Web Deployment Agent Service is not present at all, go to Control Panel > Programs > Uninstall a program, find Microsoft Web Deploy <version>. Ändern Sie die Installation, und vergewissern Sie sich, dass Sie für die Web Deploy-Komponenten Will be installed to the local hard drive (Wird auf der lokalen Festplatte installiert) auswählen.Choose to Change the installation and make sure that you choose Will be installed to the local hard drive for the Web Deploy components. Führen Sie die Schritte zur Änderung der Installation durch.Complete the change installation steps.

Erstellen der Veröffentlichungseinstellungsdatei in IIS unter Windows ServerCreate the publish settings file in IIS on Windows Server

  1. Schließen Sie die IIS-Verwaltungskonsole, und öffnen Sie sie anschließend erneut. Dann werden die aktualisierten Konfigurationsoptionen auf der Benutzeroberfläche angezeigt.Close and reopen the IIS Management Console to show updated configuration options in the UI.

  2. Klicken Sie in IIS erst mit der rechten Maustaste auf Standardwebsite und anschließend mit der linken auf Bereitstellen > Configure Web Deploy Publishing (Web Deploy-Veröffentlichung konfigurieren).In IIS, right-click the Default Web Site, choose Deploy > Configure Web Deploy Publishing.

    Web Deploy-Veröffentlichung konfigurieren

    Wenn das Menü Bereitstellen nicht angezeigt wird, lesen Sie den vorherigen Abschnitt, um zu überprüfen, ob Web Deploy ausgeführt wird.If you don't see the Deploy menu, see the preceding section to verify that Web Deploy is running.

  3. Überprüfen Sie die Einstellungen im Dialogfeld Configure Web Deploy Publishing (Web Deploy-Veröffentlichung konfigurieren).In the Configure Web Deploy Publishing dialog box, examine the settings.

  4. Klicken Sie auf Einrichten.Click Setup.

    Im Bereich Ergebnisse sehen Sie, dass dem angegebenen Benutzer Zugriffsrechte gewährt wurden und eine Datei mit der Erweiterung .publishsettings erstellt und an dem im Dialogfeld angegebenen Ort gespeichert wurde.In the Results panel, the output shows that access rights are granted to the specified user, and that a file with a .publishsettings file extension has been generated in the location shown in the dialog box.

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

    Je nach Windows Server- und IIS-Konfiguration werden in der XML-Datei unterschiedliche Werte angezeigt.Depending on your Windows Server and IIS configuration, you see different values in the XML file. Nachfolgend erhalten Sie Informationen zu den angezeigten Werten:Here are a few details about the values that you see:

    • Bei der msdeploy.axd-Datei, auf die im publishUrl-Attribut verwiesen wird, handelt es sich um eine HTTP-Handlerdatei für Web Deploy.The msdeploy.axd file referenced in the publishUrl attribute is a dynamically generated HTTP handler file for Web Deploy. (Zu Testzwecken können Sie auch http://myhostname:8172 verwenden.)(For testing purposes, http://myhostname:8172 generally works as well.)

    • Der publishUrl-Port ist auf Port 8172 festgelegt. Dabei handelt es sich um die Standardeinstellung für Web Deploy.The publishUrl port is set to port 8172, which is the default for Web Deploy.

    • Der destinationAppUrl-Port ist auf Port 80 festgelegt. Dabei handelt es sich um die Standardeinstellung für IIS.The destinationAppUrl port is set to port 80, which is the default for IIS.

    • Wenn Sie über den Hostnamen (später beschrieben) keine Verbindung mit dem Remotehost in Visual Studio herstellen können, nehmen Sie stattdessen die IP-Adresse.If you are unable to connect to the remote host in Visual Studio using the host name (in later steps), test the IP address in place of the host name.

      Hinweis

      Wenn Sie in IIS veröffentlichen, die auf einer Azure-VM ausgeführt werden, müssen Sie Web Deploy und die IIS-Ports in der Netzwerksicherheitsgruppe öffnen.If you are publishing to IIS running on an Azure VM, you must open the Web Deploy and IIS ports in the Network Security group. Ausführlichere Informationen dazu finden Sie unter Installieren und Ausführen von IIS.For detailed information, see Install and run IIS.

  5. Kopieren Sie diese Datei auf den Computer, auf dem Visual Studio ausgeführt wird.Copy this file to the computer where you are running Visual Studio.

Importieren und Bereitstellen der Veröffentlichungseinstellungen in Visual StudioImport the publish settings in Visual Studio and deploy

  1. Klicken Sie auf dem Computer, auf dem das ASP.NET-Projekt in Visual Studio geöffnet ist, erst mit der rechten Maustaste auf das Projekt im Projektmappen-Explorer und anschließend mit der linken auf Veröffentlichen.On the computer where you have the ASP.NET project open in Visual Studio, right-click the project in Solution Explorer, and choose Publish.

  2. Wenn Sie bereits Veröffentlichungsprofile konfiguriert haben, wird der Bereich Veröffentlichen angezeigt.If you have previously configured any publishing profiles, the Publish pane appears. Klicken Sie auf Neues Profil erstellen.Click Create new profile.

  3. Klicken Sie im Dialogfeld Pick a publish target (Veröffentlichungsziel auswählen) auf Profil importieren.In the Pick a publish target dialog box, click Import Profile.

    „Veröffentlichen“ auswählen

  4. Navigieren Sie zum Speicherort der Datei mit Veröffentlichungseinstellungen, die Sie bereits erstellt haben.Navigate to the location of the publish settings file that you created in the previous section.

  5. Navigieren Sie im Dialogfeld Datei mit Veröffentlichungseinstellungen importieren zu dem Profil, das Sie im vorherigen Abschnitt erstellt haben, wählen Sie es aus, und klicken Sie dann auf Öffnen.In the Import Publish Settings File dialog, navigate to and select the profile that you created in the previous section, and click Open.

    Dann beginnt Visual Studio mit dem Bereitstellungsprozess, und im Ausgabefenster werden der Fortschritt und die Ergebnisse angezeigt.Visual Studio begins the deployment process, and the Output window shows progress and results.

    Wenn bei der Bereitstellung Fehler entstehen sollten, klicken Sie auf Einstellungen, um die Einstellungen zu bearbeiten.If you get an any deployment errors, click Settings to edit settings. Ändern Sie die Einstellungen, und klicken Sie auf Überprüfen, um die neuen Einstellungen zu testen.Modify settings and click Validate to test new settings. Wenn der Hostname nicht gefunden wird, geben Sie stattdessen die IP-Adresse in die Felder Server und Ziel-URL ein.If the host name is not found, try the IP address instead of the host name in the Server and Destination URL fields.

    Bearbeiten von Einstellungen im Tool zum Veröffentlichen

Hinweis

Wenn Sie eine Azure-VM neu starten, wird die IP-Adresse möglicherweise geändert.If you restart an Azure VM, the IP address may change.

Nachdem die App erfolgreich bereitgestellt wurde, sollte sie automatisch gestartet werden.After the app deploys successfully, it should start automatically. Wenn die App nicht aus Visual Studio gestartet wird, starten Sie die App in IIS, um zu bestätigen, dass sie ordnungsgemäß ausgeführt wird.If the app does not start from Visual Studio, start the app in IIS to verify that it runs correctly. Für ASP.NET Core müssen Sie außerdem sicherstellen, dass das Feld „Anwendungspool“ für DefaultAppPool auf Kein verwalteter Code festgelegt ist.For ASP.NET Core, you also need to make sure that the Application pool field for the DefaultAppPool is set to No Managed Code.

  1. Aktivieren Sie im Dialogfeld Einstellungen das Debuggen, indem Sie auf Weiter klicken, eine Debugkonfiguration auswählen und dann Weitere Dateien im Ziel entfernen unter den Dateiveröffentlichungsoptionen auswählen.In the Settings dialog box, enable debugging by clicking Next, choose a Debug configuration, and then choose Remove additional files at destination under the File Publish options.

    Wichtig

    Wenn Sie eine Releasekonfiguration auswählen, deaktivieren Sie beim Veröffentlichen das Debuggen in der Datei Web.config.If you choose a Release configuration, you disable debugging in the web.config file when you publish.

  2. Klicken Sie auf Speichern, und veröffentlichen Sie die App dann erneut.Click Save and then republish the app.

(Optional) Bereitstellung durch Veröffentlichen in einem lokalen Ordner(Optional) Deploy by publishing to a local folder

Sie können diese Option verwenden, um Ihre App bereitzustellen, wenn Sie die App mithilfe von PowerShell bzw. RoboCopy in IIS kopieren möchten, oder wenn Sie die Dateien manuell kopieren möchten.You can use this option to deploy your app if you want to copy the app to IIS using PowerShell, RoboCopy, or you want to manually copy the files.

Konfigurieren der ASP.NET Core-Website auf dem Windows Server-ComputerConfigure the ASP.NET Core Web site on the Windows Server computer

Wenn Sie Veröffentlichungseinstellungen importieren, können Sie diesen Abschnitt überspringen.If you are importing publish settings, you can skip this section.

  1. Öffnen Sie den Internetinformationsdienste-Manager (IIS) , und navigieren Sie zu Websites.Open the Internet Information Services (IIS) Manager and go to Sites.

  2. Klicken Sie mit der rechten Maustaste auf den Knoten Standardwebsite , und wählen Sie Anwendung hinzufügenaus.Right-click the Default Web Site node and select Add Application.

  3. Legen Sie das Feld Alias auf MyASPApp und das Feld „Anwendungspool“ auf Kein verwalteter Code fest.Set the Alias field to MyASPApp and the Application pool field to No Managed Code. Legen Sie den physischen Pfad auf C:\Publish fest (in dem Sie das ASP.NET Core-Projekt später bereitstellen).Set the Physical path to C:\Publish (where you will later deploy the ASP.NET Core project).

  4. Wenn die Site im IIS-Manager ausgewählt ist, wählen Sie Berechtigungen bearbeiten aus, und stellen Sie sicher, dass IUSR, IIS_IUSRS oder der Benutzer, der für den Anwendungspool konfiguriert ist, ein autorisierter Benutzer mit Lese- und Ausführungsrechten ist.With the site selected in the IIS Manager, choose Edit Permissions, and make sure that IUSR, IIS_IUSRS, or the user configured for the Application Pool is an authorized user with Read & Execute rights.

    Wenn einer dieser Benutzer keinen Zugriff hat, führen Sie die Schritte zum Hinzufügen von IUSR als Benutzer mit Lese- und Ausführungsrechten aus.If you don't see one of these users with access, go through steps to add IUSR as a user with Read & Execute rights.

(Optional) Veröffentlichung und Bereitstellung der App durch Veröffentlichen in einem lokalen Ordner in Visual Studio(Optional) Publish and Deploy the app by publishing to a local folder from Visual Studio

Wenn Sie Web Deploy nicht verwenden, müssen Sie die App mit dem Dateisystem oder anderen Tools veröffentlichen und bereitstellen.If you're not using Web Deploy, you must publish and deploy the app using the file system or other tools. Sie können beginnen, indem Sie ein Paket mit dem Dateisystem erstellen und das Paket dann entweder manuell bereitstellen oder andere Tools wie PowerShell, RoboCopy oder XCopy verwenden.You can start by creating a package using the file system, and then either deploy the package manually or use other tools like PowerShell, RoboCopy, or XCopy. In diesem Abschnitt wird davon ausgegangen, dass Sie das Paket manuell kopieren, wenn Sie Web Deploy nicht verwenden.In this section, we assume you are manually copying the package if you are not using Web Deploy.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie Veröffentlichen (für Web Forms Web-App veröffentlichen) aus.In the Solution Explorer, right-click the project node and select Publish (for Web Forms, Publish Web App).

    Wenn Sie bereits Veröffentlichungsprofile konfiguriert haben, wird der Bereich Veröffentlichen angezeigt.If you have previously configured any publishing profiles, the Publish pane appears. Klicken Sie auf Neues Profil.Click New profile.

  2. Wählen Sie im Dialogfeld Veröffentlichen die Option Ordner aus, klicken Sie auf Durchsuchen, und erstellen Sie den neuen Ordner C:\Publish.In the Publish dialog box, select Folder, click Browse, and create a new folder, C:\Publish.

    RemoteDBG_Publish_LocalRemoteDBG_Publish_Local

    Wählen Sie für eine Web Forms-App im Dialogfeld „Veröffentlichen“ Benutzerdefiniert aus, geben Sie einen Profilnamen ein, und wählen Sie OK aus.For a Web Forms app, choose Custom in the Publish dialog box, enter a profile name, and choose OK.

  3. Klicken Sie in der Dropdownliste auf Profil erstellen (der Standardwert lautet Veröffentlichen).Click Create profile in the drop-down list (Publish is the default value).

  4. Klicken Sie im Dialogfeld Veröffentlichen auf den Link Einstellungen, und wählen Sie dann die Registerkarte Einstellungen aus.In the Publish dialog box, click the Settings link, and then select the Settings tab.

  5. Legen Sie die Konfiguration auf Debuggen fest, wählen Sie Alle vorhandenen Dateien vor der Veröffentlichung löschen aus, und klicken Sie dann auf Speichern.Set the configuration to Debug, select Delete all existing files prior to publish, and then click Save.

    Hinweis

    Wenn Sie einen Releasebuild verwenden, deaktivieren Sie beim Veröffentlichen das Debuggen in der Datei „Web.config“.If you use a Release build, you disable debugging in the web.config file when you publish.

  6. Klicken Sie auf Veröffentlichen.Click Publish.

    RemoteDBG_Publish_Debug_ConfigRemoteDBG_Publish_Debug_Config

    Die Anwendung veröffentlicht eine Debugkonfiguration des Projekts im lokalen Ordner.The application publishes a Debug configuration of the project to the local folder. Der Status wird im Fenster „Ausgabe“ angezeigt.Progress shows in the Output window.

  7. Kopieren Sie das ASP.NET-Projektverzeichnis vom Visual Studio-Computer in ein für die ASP.NET-App konfiguriertes lokales Verzeichnis (in diesem Beispiel C:\Publish) auf dem Windows Server-Computer.Copy the ASP.NET project directory from the Visual Studio computer to the local directory configured for the ASP.NET app (in this example, C:\Publish) on the Windows Server computer. In diesem Tutorial wird davon ausgegangen, dass Sie den Kopiervorgang manuell durchführen, Sie können aber auch andere Tools wie PowerShell, XCopy oder Robocopy verwenden.In this tutorial, we assume you are copying manually, but you can use other tools like PowerShell, Xcopy, or Robocopy.

    Achtung

    Wenn Sie Änderungen am Code vornehmen müssen, müssen Sie die Veröffentlichung erneut ausführen und diesen Schritt wiederholen.If you need to make changes to the code or rebuild, you must republish and repeat this step. Die ausführbare Datei, die Sie auf den Remotecomputer kopiert haben, muss genau mit der lokalen Quelle und den lokalen Symbolen übereinstimmen.The executable you copied to the remote machine must exactly match your local source and symbols. Wenn Sie dies nicht beachten, wird in Visual Studio beim Debuggen des Prozesses die Warnung cannot find or open the PDB file angezeigt.If you do not do this you will receive a cannot find or open the PDB file warning in Visual Studio when you attempt to debug the process.

  8. Überprüfen Sie auf dem Windows-Server, ob Sie die App ordnungsgemäß ausführen können, indem Sie die App in Ihrem Browser öffnen.On the Windows Server, verify that you can run the app correctly by opening the app in your browser.

    Wenn die App nicht ordnungsgemäß ausgeführt wird, liegt möglicherweise ein Konflikt zwischen der auf dem Server und der auf dem Visual Studio-Computer installierten ASP.NET-Version vor, oder es liegt ein Problem bei der IIS- oder Websitekonfiguration vor.If the app doesn't run correctly, there may be a mismatch between the version of ASP.NET installed on your server and your Visual Studio machine, or you may have an issue with your IIS or Web site configuration. Überprüfen Sie die vorherigen Schritte.Recheck earlier steps.

Herunterladen und Installieren der Remotetools unter Windows ServerDownload and Install the remote tools on Windows Server

Laden Sie die Version der Remotetools herunter, die mit Ihrer Version von Visual Studio übereinstimmt.Download the version of the remote tools that matches your version of Visual Studio.

Laden Sie über die Links in der folgenden Tabelle die richtige Version der Remotetools herunter, und installieren Sie sie nicht auf dem Visual Studio-Computer, sondern auf dem Remotegerät oder -server, auf dem Sie das Debugging durchführen möchten.On the remote device or server that you want to debug on, rather than the Visual Studio machine, download and install the correct version of the remote tools from the links in the following table.

  • Laden Sie die aktuellen Remotetools für Ihre Visual Studio-Version herunter.Download the most recent remote tools for your version of Visual Studio. Die aktuelle Version der Remotetools ist mit früheren Versionen von Visual Studio kompatibel, frühere Versionen der Remotetools sind jedoch nicht mit neueren Visual Studio-Versionen kompatibel.The latest remote tools version is compatible with earlier Visual Studio versions, but earlier remote tools versions aren't compatible with later Visual Studio versions. (Beispiel: Laden Sie bei Verwendung von Visual Studio 2017 das aktuelle Update der Remotetools für Visual Studio 2017 herunter.(For example, if you are using Visual Studio 2017, download the latest update of the remote tools for Visual Studio 2017. Laden Sie in diesem Szenario nicht die Remotetools für Visual Studio 2019 herunter.)In this scenario, do not download the remote tools for Visual Studio 2019.)
  • Laden Sie die Remotetools herunter, die die gleiche Architektur wie der Computer aufweisen, auf dem Sie sie installieren.Download the remote tools with the same architecture as the machine you're installing them on. Wenn Sie beispielsweise eine 32-Bit-App auf einem Remotecomputer mit einem 64-Bit-Betriebssystem debuggen möchten, installieren Sie die 64-Bit-Remotetools.For example, if you want to debug a 32-bit app on a remote computer running a 64-bit operating system, install the 64-bit remote tools.
VersionVersion LinkLink HinweiseNotes
Visual Studio 2019Visual Studio 2019 RemotetoolsRemote tools Kompatibel mit allen Visual Studio 2019-Versionen.Compatible with all Visual Studio 2019 versions. Laden Sie die Version herunter, die Ihrem Gerätebetriebssystem entspricht (x86, x64 oder ARM64).Download the version matching your device operating system (x86, x64, or ARM64). Wenn Sie Unterstützung beim Herunterladen der Remotetools unter Windows Server benötigen, lesen Sie die Informationen unter Entsperren des Dateidownloads.On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2017Visual Studio 2017 RemotetoolsRemote tools Kompatibel mit allen Visual Studio 2017-Versionen.Compatible with all Visual Studio 2017 versions. Laden Sie die Version herunter, die Ihrem Gerätebetriebssystem entspricht (x86, x64 oder ARM64).Download the version matching your device operating system (x86, x64, or ARM64). Wenn Sie Unterstützung beim Herunterladen der Remotetools unter Windows Server benötigen, lesen Sie die Informationen unter Entsperren des Dateidownloads.On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2015Visual Studio 2015 RemotetoolsRemote tools Remotetools für Visual Studio 2015 stehen auf My.VisualStudio.com zur Verfügung.Remote tools for Visual Studio 2015 are available from My.VisualStudio.com. Treten Sie bei entsprechender Aufforderung dem kostenlosen Programm Visual Studio Dev Essentials bei, oder melden Sie sich mit Ihrer Visual Studio-Abonnement-ID an.If prompted, join the free Visual Studio Dev Essentials program, or sign in with your Visual Studio subscription ID. Wenn Sie Unterstützung beim Herunterladen der Remotetools unter Windows Server benötigen, lesen Sie die Informationen unter Entsperren des Dateidownloads.On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2013Visual Studio 2013 RemotetoolsRemote tools Downloadseite in der Visual Studio 2013-DokumentationDownload page in Visual Studio 2013 documentation
Visual Studio 2012Visual Studio 2012 RemotetoolsRemote tools Downloadseite in der Visual Studio 2012-DokumentationDownload page in Visual Studio 2012 documentation
VersionVersion LinkLink HinweiseNotes
Visual Studio 2017Visual Studio 2017 RemotetoolsRemote tools Kompatibel mit allen Visual Studio 2017-Versionen.Compatible with all Visual Studio 2017 versions. Laden Sie die Version herunter, die Ihrem Gerätebetriebssystem entspricht (x86, x64 oder ARM64).Download the version matching your device operating system (x86, x64, or ARM64). Wenn Sie Unterstützung beim Herunterladen der Remotetools unter Windows Server benötigen, lesen Sie die Informationen unter Entsperren des Dateidownloads.On Windows Server, see Unblock the file download for help downloading the remote tools. Informationen zur aktuellen Version der Remotetools finden Sie in der Visual Studio 2019-Dokumentation.For the most recent version of the remote tools, open the Visual Studio 2019 doc.
Visual Studio 2015Visual Studio 2015 RemotetoolsRemote tools Remotetools für Visual Studio 2015 stehen auf My.VisualStudio.com zur Verfügung.Remote tools for Visual Studio 2015 are available from My.VisualStudio.com. Treten Sie bei entsprechender Aufforderung dem kostenlosen Programm Visual Studio Dev Essentials bei, oder melden Sie sich mit Ihrer Visual Studio-Abonnement-ID an.If prompted, join the free Visual Studio Dev Essentials program, or sign in with your Visual Studio subscription ID. Wenn Sie Unterstützung beim Herunterladen der Remotetools unter Windows Server benötigen, lesen Sie die Informationen unter Entsperren des Dateidownloads.On Windows Server, see Unblock the file download for help downloading the remote tools.
Visual Studio 2013Visual Studio 2013 RemotetoolsRemote tools Downloadseite in der Visual Studio 2013-DokumentationDownload page in Visual Studio 2013 documentation
Visual Studio 2012Visual Studio 2012 RemotetoolsRemote tools Downloadseite in der Visual Studio 2012-DokumentationDownload page in Visual Studio 2012 documentation

Sie können den Remotedebugger ausführen, indem Sie msvsmon.exe auf den Remotecomputer kopieren, statt die Remotetools zu installieren.You can run the remote debugger by copying msvsmon.exe to the remote computer, rather than installing the remote tools. Der Konfigurations-Assistent für den Remotedebugger (rdbgwiz.exe) ist jedoch nur verfügbar, wenn Sie die Remotetools installieren.However, the Remote Debugger Configuration Wizard (rdbgwiz.exe) is available only when you install the remote tools. Unter Umständen müssen Sie den Assistenten für die Konfiguration verwenden, wenn Sie den Remotedebugger als Dienst ausführen möchten.You may need to use the wizard for configuration if you want to run the remote debugger as a service. Weitere Informationen finden Sie unter (Optional) Konfigurieren des Remotedebuggers als Dienst.For more information, see (Optional) Configure the remote debugger as a service.

Hinweis

  • Verwenden Sie ARM64 (verfügbar mit der aktuellen Version der Remotetools) zum Debuggen von Windows 10-Apps auf ARM-Geräten.To debug Windows 10 apps on ARM devices, use ARM64, which is available with the latest version of the remote tools.
  • Zum Debuggen von Windows 10-Apps auf Windows RT-Geräten verwenden Sie ARM (nur im Download der Visual Studio 2015-Remotetools verfügbar).To debug Windows 10 apps on Windows RT devices, use ARM, which is available only in the Visual Studio 2015 remote tools download.

Einrichten des Remotedebuggers unter Windows ServerSet up the remote debugger on Windows Server

  1. Suchen und starten Sie auf dem Remotecomputer im Menü Start den Remotedebugger.On the remote computer, find and start the Remote Debugger from the Start menu.

    Wenn Sie auf dem Remotecomputer nicht über Administratorberechtigungen verfügen, klicken Sie mit der rechten Maustaste auf die App Remotedebugger, und wählen Sie Als Administrator ausführen aus.If you don't have administrative permissions on the remote computer, right-click the Remote Debugger app and select Run as administrator. Starten Sie andernfalls die App auf normale Weise.Otherwise, just start it normally.

    Wenn Sie beabsichtigen, eine Verbindung mit einem Prozess herzustellen, der unter einem Administratorkonto oder einem anderen Benutzerkonto ausgeführt wird (z. B IIS), klicken Sie mit der rechten Maustaste auf die App Remotedebugger, und wählen Sie Als Administrator ausführen aus.If you are planning to attach to a process which is running as an administrator, or is running under a different user account (such as IIS), right-click the Remote Debugger app and select Run as administrator. Weitere Informationen finden Sie unter Ausführen des Remotedebuggers als Administrator.For more information, see Run the remote debugger as an administrator.

  2. Wenn Sie den Remotedebugger zum ersten Mal starten (oder bevor Sie ihn konfiguriert haben), wird das Dialogfeld Konfiguration für Remotedebugging angezeigt.The first time you start the remote debugger (or before you have configured it), the Remote Debugging Configuration dialog box appears.

    Konfiguration des RemotedebuggersRemote Debugger configuration

  3. Wenn die Windows-Webdienste-API nicht installiert ist (geschieht nur unter Windows Server 2008 R2), klicken Sie auf die Schaltfläche Installieren.If the Windows Web Services API is not installed, which happens only on Windows Server 2008 R2, select the Install button.

  4. Wählen Sie mindestens einen Netzwerktyp aus, für den Sie die Remotetools verwenden möchten.Select at least one network type you want to use the remote tools on. Wenn die Computer über eine Domäne verbunden sind, müssen Sie das erste Element auswählen.If the computers are connected through a domain, you must choose the first item. Wenn die Computer über eine Arbeitsgruppe oder eine Heimnetzgruppe verbunden sind, wählen Sie das zweite bzw. dritte Element aus.If the computers are connected through a workgroup or homegroup, choose the second or third item as appropriate.

  5. Wählen Sie Remotedebugging konfigurieren aus, um die Firewall zu konfigurieren und den Remotedebugger zu starten.Select Configure remote debugging to configure the firewall and start the remote debugger.

  6. Wenn die Konfiguration abgeschlossen ist, wird das Fenster Remotedebugger angezeigt.When configuration is complete, the Remote Debugger window appears.

    Fenster des RemotedebuggersRemote Debugger window

    Der Remotedebugger wartet nun auf eine Verbindung.The remote debugger is now waiting for a connection. Verwenden Sie den Servernamen und die Portnummer, die angezeigt werden, um die Remoteverbindungskonfiguration in Visual Studio festzulegen.Use the server name and port number shown to set the remote connection configuration in Visual Studio.

Um den Remotedebugger zu beenden, wählen Sie Datei > Beenden aus.To stop the remote debugger, select File > Exit. Sie können ihn über das Menü Start oder über die Befehlszeile neu starten:You can restart it from the Start menu, or from the command line:

<Remote debugger installation directory>\msvsmon.exe

Hinweis

Wenn Sie Berechtigungen für weitere Benutzer hinzufügen, den Authentifizierungsmodus oder die Portnummer für den Remotedebugger ändern müssen, finden Sie weitere Informationen unter Konfigurieren des Remotedebuggers.If you need to add permissions for additional users, change the authentication mode, or port number for the remote debugger, see Configure the remote debugger.

Anfügen an die ASP.NET-Anwendung vom Visual Studio-Computer ausAttach to the ASP.NET application from the Visual Studio computer

  1. Öffnen Sie auf dem Visual Studio-Computer die Projekt Mappe, die Sie debuggen möchten (MyASPApp, wenn Sie die Schritte in diesem Artikel befolgen).On the Visual Studio computer, open the solution that you are trying to debug (MyASPApp if you are following the steps in this article).

  2. Klicken Sie in Visual Studio auf Debuggen > An Prozess anfügen (STRG+ALT+P).In Visual Studio, click Debug > Attach to Process (Ctrl + Alt + P).

    Tipp

    In Visual Studio 2017 und höheren Versionen können Sie an denselben Prozess, an den Sie zuvor angefügt haben, erneut anfügen, indem Sie Debuggen > Erneut an Prozess anfügen... (UMSCHALT+ALT+P) verwenden.In Visual Studio 2017 and later versions, you can re-attach to the same process you previously attached to by using Debug > Reattach to Process... (Shift+Alt+P).

  3. Legen Sie das Feld „Qualifizierer“ auf <remote computer name> fest, und drücken Sie die EINGABETASTE.Set the Qualifier field to <remote computer name> and press Enter.

    Vergewissern Sie sich, dass Visual Studio den erforderlichen Port dem Computernamen hinzufügt, der im folgenden Format angezeigt wird: <remote computer name>:port.Verify that Visual Studio adds the required port to the computer name, which appears in the format: <remote computer name>:port

    In Visual Studio 2019 sollte <remote computer name>:4024 angezeigt werden.On Visual Studio 2019, you should see <remote computer name>:4024

    In Visual Studio 2017 sollte <remote computer name>:4022 angezeigt werden.On Visual Studio 2017, you should see <remote computer name>:4022

    Der Port ist erforderlich.The port is required. Wenn die Portnummer nicht angezeigt wird, fügen Sie sie manuell hinzu.If you don't see the port number, add it manually.

  4. Klicken Sie auf Aktualisieren.Click Refresh. Im Fenster sollten einige Prozesse Verfügbare Prozesse angezeigt werden.You should see some processes appear in the Available Processes window.

    Wenn keine Prozesse angezeigt werden, versuchen Sie, die IP-Adresse anstelle des Remotecomputernamens zu verwenden (der Port ist erforderlich).If you don't see any processes, try using the IP address instead of the remote computer name (the port is required). Sie können ipconfig in einer Befehlszeile verwenden, um die IPv4-Adresse abzurufen.You can use ipconfig in a command line to get the IPv4 address.

    Wenn Sie die Schaltfläche Suchen verwenden möchten, müssen Sie möglicherweise UDP-Port 3702 auf dem Server öffnen.If you want to use the Find button, you may need to open UDP port 3702 on the server.

  5. Aktivieren Sie Prozesse aller Benutzer anzeigen.Check Show processes from all users.

  6. Geben Sie den ersten Buchstaben des Namens Ihres Prozesses ein, um Ihre App schnell zu suchen.Type the first letter of your process name to quickly find your app.

    • Wenn Sie das prozessinterne Hostingmodell unter IIS verwenden, wählen Sie den richtigen w3wp.exe-Prozess aus.If you're using the in-process hosting model on IIS, select the correct w3wp.exe process. Ab .NET Core 3 ist dies der Standardprozess.Starting in .NET Core 3, this is the default.

    • Wählen Sie andernfalls den Prozess dotnet.exe aus.Otherwise, select the dotnet.exe process. (Dies ist das prozessexterne Hostingmodell.)(This is the out-of-process hosting model.)

    Wenn für mehrere Prozesse w3wp.exe oder dotnet.exe angezeigt wird, müssen Sie in der Spalte Benutzername nachsehen.If you have multiple processes showing w3wp.exe or dotnet.exe, check the User Name column. In einigen Szenarios wird in der Spalte Benutzername der Name Ihres App-Pools angezeigt, z. B. IIS APPPOOL\DefaultAppPool.In some scenarios, the User Name column shows your app pool name, such as IIS APPPOOL\DefaultAppPool. Wenn Ihnen der App-Pool angezeigt wird, der Name jedoch nicht eindeutig ist, erstellen Sie einen neuen benannten App-Pool für die App-Instanz, die Sie debuggen möchten. Sie können ihn dann leicht in der Spalte Benutzername wiederfinden.If you see the App Pool, but it's not unique, create a new named App Pool for the app instance you want to debug, and then you can find it easily in the User Name column.

    RemoteDBG_AttachToProcessRemoteDBG_AttachToProcess

    RemoteDBG_AttachToProcessRemoteDBG_AttachToProcess

  7. Klicken Sie auf Anfügenaus.Click Attach.

  8. Öffnen Sie die Website des Remotecomputers.Open the remote computer's website. Navigieren Sie in einem Browser zu http://<remote computer name> .In a browser, go to http://<remote computer name>.

    Es sollte die ASP.NET-Webseite angezeigt werden.You should see the ASP.NET web page.

  9. Klicken Sie in der ausgeführten ASP.NET-Anwendung auf den Link zur Seite Info.In the running ASP.NET application, click the link to the About page.

    Der Haltepunkt sollte in Visual Studio erreicht werden.The breakpoint should be hit in Visual Studio.

Problembehandlung: Öffnen erforderlicher Ports unter Windows ServerTroubleshooting: Open required ports on Windows Server

In den meisten Setups werden erforderliche Ports durch die Installation von ASP.NET und des Remotedebuggers geöffnet.In most setups, required ports are opened by the installation of ASP.NET and the remote debugger. Wenn Sie jedoch Bereitstellungsprobleme behandeln und die App hinter einer Firewall gehostet wird, müssen Sie möglicherweise überprüfen, ob die richtigen Ports geöffnet sind.However, if you are troubleshooting deployment issues and the app is hosted behind a firewall, you may need to verify that the correct ports are open.

Auf einer Azure-VM müssen Sie Ports über die Netzwerksicherheitsgruppe öffnen.On an Azure VM, you must open ports through the Network security group.

Erforderliche Ports:Required ports:

  • 80 – erforderlich für IIS80 - Required for IIS
  • UDP 3702 (optional) – Der Ermittlungsport aktiviert für Sie die Schaltfläche Suchen, wenn Sie den Remotedebugger in Visual Studio anfügen.UDP 3702 - (Optional) Discovery port enables you to the Find button when attaching to the remote debugger in Visual Studio.

Außerdem sollten diese Ports bereits von der ASP.NET-Installation geöffnet worden sein:In addition, these ports should already be opened by the ASP.NET installation:

  • 8172 (optional) – erforderlich, damit Web Deploy die App aus Visual Studio bereitstellen kann.8172 - (Optional) Required for Web Deploy to deploy the app from Visual Studio