Remotedebugging

Sie können eine Visual Studio Anwendung debuggen, die auf einem anderen Computer bereitgestellt wurde. Um dies zu tun, verwenden Sie den Visual Studio Remotedebugger.

Ausführliche Anweisungen zum Remotedebugging finden Sie in diesen Themen.

Wenn Sie nur den Remotedebugger herunterladen und installieren möchten und keine zusätzlichen Anweisungen für Ihr Szenario benötigen, führen Sie die Schritte in diesem Artikel aus.

Herunterladen und Installieren der Remotetools

Laden Sie auf dem Remotegerät oder Server, auf dem Sie debuggen möchten, statt auf dem Visual Studio Computer, die richtige Version der Remotetools aus den Links in der folgenden Tabelle herunter, und installieren Sie sie.

• Laden Sie die Remotetools mit der gleichen Architektur wie den Computer herunter, auf dem Sie sie installieren. Wenn Sie beispielsweise x86-Anwendungen auf einem Remotecomputer mit einem x64-Betriebssystem debuggen möchten, installieren Sie die x64-Remotetools. Installieren Sie die ARM64-Remotetools, um x86-, ARM- oder x64-Anwendungen auf einem ARM64-Betriebssystem zu debuggen.

Sie können den Remotedebugger ausführen, indem Sie msvsmon.exe auf den Remotecomputer kopieren, anstatt die Remotetools zu installieren. Der Remote-Debugger-Konfigurationsassistent (rdbgwiz.exe) ist jedoch nur verfügbar, wenn Sie die Remotetools installieren. Möglicherweise müssen Sie den Assistenten für die Konfiguration verwenden, wenn Sie den Remotedebugger als Dienst ausführen möchten. Weitere Informationen finden Sie unter (Optional) Konfigurieren des Remotedebuggers als Dienst.

Anforderungen

Unterstützte Betriebssysteme

Der Remotecomputer muss eines der folgenden Betriebssysteme ausführen:

• Windows 11

• Windows 10 (nicht telefon)

• Windows 8 oder 8.1 (nicht telefon)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 oder Windows Server 2012 R2

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

Unterstützte Hardwarekonfigurationen

• 1,6 GHz oder schneller Prozessor

• 1 GB RAM (1,5 GB bei Ausführung auf einem virtuellen Computer)

• 1 GB verfügbarer Festplattenspeicher

• 5400-RPM-Festplatte

• DirectX 9-fähige Grafikkarte mit einer Auflösung von 1024 x 768 oder höher

Netzwerkkonfiguration

Der Remotecomputer und der Visual Studio Computer müssen über ein Netzwerk, eine Arbeitsgruppe oder eine Heimnetzgruppe verbunden sein oder über ein Ethernet-Kabel direkt verbunden sein. Das Debuggen zwischen zwei Computern, die über einen Proxy verbunden sind, wird nicht unterstützt. Das Debuggen über eine Verbindung mit hoher Latenz oder geringer Bandbreite, z. B. Internetwählverbindungen oder über das Internet über Länder/Regionen, wird nicht empfohlen und kann fehlschlagen oder unannehmbar langsam sein.

(Optional) So führen Sie den Remotedebugger über eine Dateifreigabe aus

Sie finden den Remotedebugger (msvsmon.exe) auf einem Computer, auf dem Visual Studio Community, Professional oder Enterprise bereits installiert ist. In einigen Szenarien ist die einfachste Möglichkeit zum Einrichten des Remotedebuggens das Ausführen des Remotedebuggers („msvsmon.exe“) aus einer Dateifreigabe. Informationen zu Nutzungseinschränkungen finden Sie auf der Hilfeseite des Remotedebuggers (Hilfe Verwendung im Remotedebugger).

1. Suchen Sie msvsmon.exe im Verzeichnis, das Ihrer Version von Visual Studio entsprechen:

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

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

2. Geben Sie den Ordner Remote Debugger auf dem Visual Studio-Computer frei.

3. Führen Sie auf dem Remotecomputer msvsmon.exe aus dem freigegebenen Ordner aus. Befolgen Sie die Setupanweisungen.

Richten Sie den Remotedebugger ein

1. Suchen und starten Sie auf dem Remotecomputer im Menü Start den Remotedebugger.

   Wenn Sie nicht über Administratorberechtigungen auf dem Remotecomputer verfügen, klicken Sie mit der rechten Maustaste auf die Remotedebugger--App, und wählen Sie Als Administrator ausführenaus. Andernfalls starten Sie es einfach normal.

   Wenn Sie planen, einen Prozess anzufügen, der als Administrator ausgeführt wird oder unter einem anderen Benutzerkonto (z. B. IIS) ausgeführt wird, klicken Sie mit der rechten Maustaste auf die Remotedebugger--App, und wählen Sie Als Administrator ausführenaus. Weitere Informationen erhalten Sie unter Remotedebugger als Administrator ausführen.

2. Wenn Sie den Remotedebugger zum ersten Mal starten oder bevor Sie ihn konfiguriert haben, wird der Assistent Remotedebuggingkonfiguration angezeigt.

   Wählen Sie in den meisten Szenarien " Remotedebugging konfigurieren" aus.

   Screenshot der Remotedebuggerkonfiguration.Remotedebuggerkonfiguration

   Wählen Sie in den meisten Szenarien Next aus, bis Sie zur Seite Konfigurieren der Windows-Firewall Des Assistenten gelangen.

   Screenshot der Remotedebuggerkonfiguration.Remotedebuggerkonfiguration

3. Wählen Sie mindestens einen Netzwerktyp aus, auf dem Sie die Remotetools verwenden möchten. Wenn die Computer über eine Domäne verbunden sind, müssen Sie das erste Element auswählen. Wenn die Computer über eine Arbeitsgruppe oder Heimnetzgruppe verbunden sind, wählen Sie das zweite oder dritte Element entsprechend aus.

   Wählen Sie als Nächstes Fertig stellen aus, um den Remotedebugger zu starten.

4. Wenn die Konfiguration abgeschlossen ist, wird das Fenster Remotedebugger angezeigt.

   Screenshot des Remotedebugger-FenstersFenster des Remotedebuggers

   Screenshot des Remotedebugger-FenstersFenster des Remotedebuggers

   Der Remotedebugger wartet jetzt auf eine Verbindung. Verwenden Sie den Angezeigten Servernamen und die Portnummer, um die Remoteverbindungskonfiguration in Visual Studio festzulegen.

Um den Remotedebugger zu beenden, wählen Sie DateiBeenden aus. Sie können sie über das Menü Start oder über die Befehlszeile neu starten:

<Remote debugger installation directory>\msvsmon.exe

Konfigurieren des Remotedebuggers

Sie können einige Aspekte der Konfiguration des Remotedebuggers ändern, nachdem Sie ihn zum ersten Mal gestartet haben.

• Wenn Sie Berechtigungen für andere Benutzer hinzufügen müssen, um eine Verbindung mit dem Remotedebugger herzustellen, wählen Sie Tools Berechtigungenaus. Sie müssen über Administratorrechte verfügen, um Berechtigungen zu erteilen oder zu verweigern.

  Wichtig

  Sie können den Remotedebugger unter einem Benutzerkonto ausführen, das sich von dem Benutzerkonto unterscheidet, das Sie auf dem Visual Studio Computer verwenden, aber Sie müssen das andere Benutzerkonto zu den Berechtigungen des Remotedebuggers hinzufügen.

  Alternativ können Sie den Remotedebugger über die Befehlszeile mit der /allow Benutzername Parameter starten: msvsmon /allow username@computer.

• Wenn Sie den Authentifizierungsmodus oder die Portnummer ändern müssen, oder geben Sie einen Timeoutwert für die Remotetools an: Wählen Sie Tools Optionenaus.

  Eine Liste der standardmäßig verwendeten Portnummern finden Sie unter Remotedebugger-Portzuweisungen.

  Warnung

  Sie können die Remotetools im Modus "Keine Authentifizierung" ausführen, dieser Modus wird jedoch dringend abgeraten. Es gibt keine Netzwerksicherheit, wenn Sie in diesem Modus arbeiten. Wählen Sie den Modus "Keine Authentifizierung" aus, wenn Sie sicher sind, dass das Netzwerk nicht durch böswilligen oder feindlichen Datenverkehr gefährdet ist.

Konfigurieren von Visual Studio für das Remotedebugging

Ausführliche Anweisungen zum Herstellen einer Verbindung mit der App von Visual Studio aus finden Sie unter den Links zu Ihrem spezifischen Szenario am Anfang dieses Artikels.

Einige Szenarien erfordern die Verwendung von "Anfügen an Prozess", um eine Verbindung mit einer bereits gestarteten Remote-App herzustellen. Für .NET Core-, .NET 5+-, .NET Framework- und C++-Apps können Sie die Remote-App jedoch über Visual Studio starten, indem Sie project Eigenschaften konfigurieren und den Debugger starten. Weitere Informationen finden Sie unter Remote-Debuggen eines C#- oder Visual Basic-Projekts oder Remote-Debuggen eines C++-Projekts.

Sie können auch eine ausführbare Datei remote zu debuggen, die nicht Teil eines Visual Studio-Projekts ist, obwohl die unterstützten Debugging-Funktionen von der Konfiguration abhängig sind, z. B. die Verfügbarkeit von Symbolen. Weitere Informationen finden Sie unter Debug einer App, die nicht Teil einer Visual Studio Lösung ist.

(Optional) Konfigurieren des Remotedebuggers als Dienst

Für das Debuggen in ASP.NET und anderen Serverumgebungen müssen Sie entweder den Remotedebugger als Administrator ausführen oder, wenn sie immer ausgeführt werden soll, den Remotedebugger als Dienst ausführen.

Wenn Sie den Remotedebugger als Dienst konfigurieren möchten, führen Sie die folgenden Schritte aus.

1. Suchen Sie den Konfigurations-Assistenten für Remote Debugger (rdbgwiz.exe). (Dies ist eine separate Anwendung vom Remotedebugger.) Sie ist nur verfügbar, wenn Sie die Remotetools installieren. Es ist nicht mit Visual Studio installiert.

2. Starten Sie die Ausführung des Konfigurations-Assistenten. Wenn die erste Seite angezeigt wird, klicken Sie auf Weiter.

3. Aktivieren Sie das Kontrollkästchen Visual Studio Remotedebugger als Dienst ausführen.

4. Fügen Sie den Namen des Benutzerkontos und des Kennworts hinzu.

   Sie müssen diesem Konto möglicherweise das Benutzerrecht Anmelden als Dienst hinzufügen (suchen Sie nach Lokale Sicherheitsrichtlinie („secpol.msc“) auf der Startseite oder im Fenster (oder geben Sie secpol an einer Eingabeaufforderung ein). Wenn das Fenster angezeigt wird, doppelklicken Sie auf Zuweisen von Benutzerrechten, und suchen Sie dann Anmelden als Dienst im rechten Bereich. Doppelklicken Sie darauf. Fügen Sie das Benutzerkonto zum Fenster Eigenschaften hinzu, und klicken Sie auf OK). Klicken Sie auf Weiter.

5. Wählen Sie den Netzwerktyp aus, mit dem die Remotetools kommunizieren sollen. Mindestens ein Netzwerktyp muss ausgewählt werden. Wenn die Computer über eine Domäne verbunden sind, sollten Sie das erste Element auswählen. Wenn die Computer über eine Arbeitsgruppe oder Heimnetzgruppe verbunden sind, sollten Sie die zweiten oder dritten Elemente auswählen. Klicken Sie auf Weiter.

6. Wenn der Dienst gestartet werden kann, sehen Sie Sie haben den Assistenten für die Konfiguration des Visual Studio Remotedebuggers erfolgreich abgeschlossen. Wenn der Dienst nicht gestartet werden kann, wird angezeigt, dass der Visual Studio Remote-Debugger-Konfigurationsassistent nicht abgeschlossen werden konnte. Auf der Seite finden Sie auch einige Tipps, die Sie befolgen können, um den Dienst zu starten.

7. Klicken Sie auf Beenden.

   An diesem Punkt wird der Remotedebugger als Dienst ausgeführt. Sie können dies überprüfen, indem Sie zu Control Panel > Services wechseln und nach Visual Studio Remotedebugger suchen.

   Sie können den Remotedebuggerdienst von Control Panel > Services beenden und starten.

Einrichten des Debuggens mit Remotesymbolen

Sie sollten den Code mit den Symbolen debuggen können, die Sie auf dem Visual Studio Computer generieren. Die Leistung des Remotedebuggers ist viel besser, wenn Sie lokale Symbole verwenden. Wenn Sie Remotesymbole verwenden müssen, müssen Sie den Remotedebuggingmonitor anweisen, nach Symbolen auf dem Remotecomputer zu suchen.

Sie können den folgenden Msvsmon-Befehlszeilenschalter verwenden, um Remotesymbole für verwalteten Code zu verwenden:

Weitere Informationen finden Sie in der Hilfe zum Remotedebugging (drücken Sie im Remotedebuggerfenster F1, oder klicken Sie auf Hilfe Nutzung).

Verwandte Inhalte

• Schauen Sie sich zuerst den Debugger an
• Konfigurieren Sie die Windows-Firewall für die Remote-Debugging
• Remotedebugger – Portzuweisungen
• Remote-Debugging von ASP.NET Core auf einem Remote-IIS-Computer
• Remotedebuggingfehler und Problembehandlung