Távoli hibakeresés

Hibakeresést végezhet egy másik számítógépen üzembe helyezett Visual Studio-alkalmazásban. Ehhez használja a Visual Studio távoli hibakeresőt.

A távoli hibakereséssel kapcsolatos részletes útmutatásért tekintse meg ezeket a témaköröket.

Forgatókönyv	Link
C# vagy Visual Basic	C# vagy Visual Basic projekt távoli hibakeresése
C++	C++ projekt távoli hibakeresése
Azure App Service	Távoli hibakeresés az ASP.NET Core-hoz az Azure-on vagy a Visual Studio Enterprise Snapshot Debugger
ASP.NET	Távoli hibakeresés az ASP.NET Core-hez vagy távoli hibakeresés az ASP.NET-hez
Azure-beli virtuális gép	Távoli hibakeresés ASP.NET alkalmazásokon egy Azure virtuális gépen
Linux	.NET Core hibakeresés Linuxon SSH-n keresztül, folyamathoz csatlakozva
Kikötőmunkás	Csatolás Docker-tárolóban futó folyamathoz
Univerzális Windows-alkalmazások (UWP)	UWP-alkalmazások futtatása távoli gépen vagy Telepített alkalmazáscsomag hibakeresése

Ha csak le szeretné tölteni és telepíteni szeretné a távoli hibakeresőt, és nincs szüksége további utasításokra a forgatókönyvhöz, kövesse az ebben a cikkben ismertetett lépéseket.

A távoli eszközök letöltése és telepítése

A Visual Studio-gép helyett a hibakeresésre használni kívánt távoli eszközön vagy kiszolgálón töltse le és telepítse a távoli eszközök megfelelő verzióját az alábbi táblázat hivatkozásaiból.

• Töltse le a Visual Studio verziójához tartozó távoli eszközök legújabb frissítését. A Visual Studio 2022 és 2026 távoli eszközei a Visual Studio bármelyik verziójával használhatók. A Visual Studio 2022-nél korábbi távoli eszközök verziói azonban nem kompatibilisek a Visual Studio későbbi verzióival. (Ha például a Visual Studio 2019-et használja, töltse le a Visual Studio 2019 távoli eszközeinek legújabb frissítését. Ebben a forgatókönyvben ne töltse le a Visual Studio 2022 távoli eszközeit.)

• Töltse le a távoli eszközöket ugyanazzal az architektúrával, mint a számítógépre, amelyre telepíti őket. Ha például x64 operációs rendszert futtató távoli számítógépen szeretné hibakeresésre használni az x86-alkalmazásokat, telepítse az x64 távoli eszközöket. Az x86-os, ARM- vagy x64-alkalmazások ARM64 operációs rendszeren való hibakereséséhez telepítse az ARM64 távoli eszközeit.

Verzió	Link	Jegyzetek
Visual Studio 2026	Távoli eszközök	Kompatibilis a Visual Studio 2022 és újabb verzióival. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2022	Távoli eszközök	A Visual Studio 2022 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2019	Távoli eszközök	A Visual Studio 2019 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2017	Távoli eszközök	A Visual Studio 2017 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. Windows Serveren a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2015	Távoli eszközök	A Visual Studio 2015 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Windows Serveren a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2013	Távoli eszközök	Oldal letöltése a Visual Studio 2013 dokumentációjában
Visual Studio 2012	Távoli eszközök	Oldal letöltése a Visual Studio 2012 dokumentációjában

A távoli hibakeresőt úgy futtathatja, hogy a távoli eszközök telepítése helyett msvsmon.exe a távoli számítógépre másolja. A Távoli hibakereső konfigurációs varázslója (rdbgwiz.exe) azonban csak a távoli eszközök telepítésekor érhető el. Előfordulhat, hogy a varázslót kell használnia a konfigurációhoz, ha a távoli hibakeresőt szolgáltatásként szeretné futtatni. További információkért tekintse meg: (Nem kötelező) A távoli hibakereső konfigurálása szolgáltatásként.

Jegyzet

• A Windows 10-es vagy újabb alkalmazások ARM-eszközökön való hibakereséséhez használja az ARM64-et, amely a távoli eszközök legújabb verziójával érhető el.
• Windows 10-alkalmazások Windows RT-eszközökön való hibakereséséhez használja az ARM-t, amely csak a Visual Studio 2015 távoli eszközeinek letöltésében érhető el.
• Az x64-alkalmazások ARM64 operációs rendszeren való hibakereséséhez futtassa az ARM64 távoli eszközeivel telepített msvsmon.exe x64-verzióját.

Követelmények

Támogatott operációs rendszerek

A távoli számítógépnek az alábbi operációs rendszerek egyikét kell futtatnia:

• Windows 11

• Windows 10 (nem telefon)

• Windows 8 vagy 8.1 (nem telefon)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 vagy Windows Server 2012 R2

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

Támogatott hardverkonfigurációk

• 1,6 GHz-es vagy gyorsabb processzor

• 1 GB RAM (1,5 GB, ha virtuális gépen fut)

• 1 GB szabad merevlemez-terület

• 5400-RPM merevlemez

• DirectX 9-kompatibilis videokártya, amely 1024 x 768 vagy újabb kijelzőfelbontással fut

Hálózati konfiguráció

A távoli számítógépnek és a Visual Studio-számítógépnek hálózaton, munkacsoporton vagy otthoni csoporton keresztül, vagy közvetlenül Ethernet-kábelen keresztül kell csatlakoznia. A proxyn keresztül csatlakoztatott két számítógép közötti hibakeresés nem támogatott. A magas késésű vagy alacsony sávszélességű kapcsolaton, például a betárcsázós interneten vagy az országok/régiók közötti internetkapcsolaton keresztüli hibakeresés nem ajánlott, és sikertelen vagy elfogadhatatlanul lassú lehet.

(Nem kötelező) A távoli hibakereső futtatása fájlmegosztásból

A távoli hibakereső (msvsmon.exe) olyan számítógépen található, amelyen már telepítve van a Visual Studio Community, a Professional vagy az Enterprise. Bizonyos esetekben a távoli hibakeresés beállításának legegyszerűbb módja a távoli hibakereső (msvsmon.exe) futtatása egy fájlmegosztásból. A használati korlátozásokért tekintse meg a távoli hibakereső súgóoldalát (Súgó > Használat a távoli hibakeresőben).

1. Keresse meg a msvsmon.exe a Visual Studio verziójának megfelelő könyvtárban:

   programfájlok\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   programfájlok\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. Ossza meg a Távoli hibakereső mappát a Visual Studio számítógépen.

3. A távoli számítógépen futtassa a msvsmon.exe a megosztott mappából. Kövesse a beállítási utasításokat.

Borravaló

A parancssori telepítést és a parancssori hivatkozást illetően tekintse meg a msvsmon.exe súgóoldalát, írja be a msvsmon.exe /? parancsot a Visual Studio telepített parancssorában a számítógépen (vagy lépjen a távoli hibakeresőben a Súgó > Használat részre).

A távoli hibakereső beállítása

1. A távoli számítógépen keresse meg és indítsa el a Távoli hibakereső a Start menüből.

   Ha nem rendelkezik rendszergazdai engedélyekkel a távoli számítógépen, kattintson a jobb gombbal a Távoli hibakereső alkalmazásra, és válassza a Futtatás rendszergazdailehetőséget. Ellenkező esetben csak indítsa el a szokásos módon.

   Ha rendszergazdaként futó vagy másik felhasználói fiók (például IIS) alatt futó folyamathoz szeretne csatolni, kattintson a jobb gombbal a Távoli hibakereső alkalmazásra, és válassza a Futtatás rendszergazdakéntlehetőséget. További információ: A távoli hibakereső futtatása rendszergazdaként.

2. A távoli hibakereső első indításakor (vagy a konfigurálás előtt) megjelenik a Távoli hibakeresési konfiguráció varázsló.

   A legtöbb esetben válassza a Következő lehetőséget, amíg el nem jut a varázsló Windows tűzfal oldalára.

   

3. Válasszon ki legalább egy hálózati típust, amelyen a távoli eszközöket használni szeretné. Ha a számítógépek tartományon keresztül csatlakoznak, ki kell választania az első elemet. Ha a számítógépek munkacsoporton vagy otthoni csoporton keresztül csatlakoznak, szükség szerint válassza a második vagy a harmadik elemet.

   Ezután válassza a Befejezés lehetőséget a távoli hibakeresés indításához.

4. Ha a konfiguráció befejeződött, megjelenik a Távoli hibakereső ablak.

   

   A távoli hibakereső most egy kapcsolatra vár. A Távoli kapcsolat konfigurációjának beállításához használja a megjelenített kiszolgálónevet és portszámot a Visual Studióban.

A távoli hibakereső leállításához válassza Fájl>Kilépéslehetőséget. Újraindíthatja a Start menüből vagy a parancssorból:

<Remote debugger installation directory>\msvsmon.exe

A távoli hibakereső konfigurálása

A távoli hibakereső konfigurációjának néhány aspektusát az első indítás után módosíthatja.

• Ha más felhasználók engedélyeit kell hozzáadnia a távoli hibakeresőhöz való csatlakozáshoz, válassza az Eszközök > Engedélyeklehetőséget. Az engedélyek megadásához vagy megtagadásához rendszergazdai jogosultságokkal kell rendelkeznie.

  Fontos

  A távoli hibakeresőt olyan felhasználói fiók alatt futtathatja, amely eltér a Visual Studio-számítógépen használt felhasználói fióktól, de hozzá kell adnia a másik felhasználói fiókot a távoli hibakereső engedélyeihez.

  Másik lehetőségként elindíthatja a távoli hibakeresőt a parancssorból a /allow <felhasználónév> paraméterrel: msvsmon /allow <username@computer>.

• Ha módosítania kell a hitelesítési módot vagy a portszámot, vagy időtúllépési értéket kell megadnia a távoli eszközökhöz: válassza az Eszközök > Beállításoklehetőséget.

  Az alapértelmezés szerint használt portszámok listáját Távoli hibakereső porthozzárendelésekcímű témakörben talál.

  Figyelmeztetés

  Dönthet úgy, hogy a távoli eszközöket hitelesítés nélküli módban futtatja, de ezt a módot erősen nem ajánljuk. Ebben a módban való futtatáskor nincs hálózati biztonság. Csak akkor válassza a Nem hitelesítési módot, ha biztos benne, hogy a hálózat nem áll veszélyben a rosszindulatú vagy ellenséges forgalom miatt.

A Visual Studio konfigurálása távoli hibakereséshez

Ha részletes útmutatást szeretne az alkalmazáshoz való csatlakozáshoz a Visual Studióból, használja a cikk elején az adott forgatókönyvhöz kapcsolódó hivatkozásokat.

Egyes helyzetekben az Csatolás folyamathoz funkció használata szükséges egy már elindított távoli alkalmazáshoz való csatlakozáshoz. A .NET Core, a .NET 5+, a .NET Framework és a C++ alkalmazások esetében azonban a távoli alkalmazást a Visual Studióból indíthatja el a projekt tulajdonságainak konfigurálásával és a hibakereső elindításával. További információ: C# vagy Visual Basic projekt távoli hibakeresése vagy C++ projekt távoli hibakeresése.

Távoli hibakeresést is végezhet egy olyan végrehajtható fájlban, amely nem része Egy Visual Studio-projektnek, bár a támogatott hibakeresési funkciók a konfigurációtól, például a szimbólumok elérhetőségétől függnek. További információ: Nem Visual Studio-megoldás részét képező alkalmazások hibakeresése.

(Nem kötelező) A távoli hibakereső konfigurálása szolgáltatásként

A ASP.NET és más kiszolgálói környezetekben végzett hibakereséshez rendszergazdaként kell futtatnia a távoli hibakeresőt, vagy ha azt szeretné, hogy mindig futtassa, futtassa a távoli hibakeresőt szolgáltatásként.

Ha szolgáltatásként szeretné konfigurálni a távoli hibakeresőt, kövesse az alábbi lépéseket.

1. Keresse meg a Távoli Hibakereső Konfigurációs Varázsló (rdbgwiz.exe). (Ez egy külön alkalmazás a távoli hibakeresőtől.) Ez csak a távoli eszközök telepítésekor érhető el. Nincs telepítve a Visual Studióval.

2. Indítsa el a konfigurációs varázsló futtatását. Amikor megjelenik az első oldal, kattintson a Továbbgombra.

3. Jelölje be a Visual Studio távoli hibakereső futtatása szolgáltatásként jelölőnégyzetet.

4. Adja hozzá a felhasználói fiók nevét és jelszavát.

   Előfordulhat, hogy hozzá kell adnia a Bejelentkezés szolgáltatásként felhasználót ehhez a fiókhoz (Helyi biztonsági házirend (secpol.msc) keresése a Start lapon vagy ablakban (vagy írja be secpol parancssorba). Amikor megjelenik az ablak, kattintson duplán Felhasználói jogok hozzárendeléseelemre, majd keresse meg Bejelentkezés szolgáltatásként a jobb oldali panelen. Kattintson rá duplán. Adja hozzá a felhasználói fiókot a Tulajdonságok ablakhoz, majd kattintson OKgombra. Kattintson a Továbbgombra.

5. Válassza ki azt a hálózattípust, amellyel a távoli eszközök kommunikálni szeretnének. Legalább egy hálózati típust ki kell jelölni. Ha a számítógépek tartományon keresztül csatlakoznak, válassza ki az első elemet. Ha a számítógépek munkacsoporton vagy otthoni csoporton keresztül csatlakoznak, a második vagy a harmadik elemet kell választania. Kattintson a Továbbgombra.

6. Ha a szolgáltatás elindítható, megjelenik Sikeresen elvégezte a Visual Studio távoli hibakereső konfigurációs varázslóját. Ha a szolgáltatás nem indítható el, látni fogja, Nem sikerült befejezni a Visual Studio távoli hibakereső konfigurációs varázslóját. Az oldal néhány követendő tippet is ad a szolgáltatás elindításához.

7. Kattintson a Befejezésgombra.

   Ezen a ponton a távoli hibakereső szolgáltatásként fut. Ezt a Vezérlőpult > Szolgáltatások és Visual Studio Remote Debuggermegkeresésével ellenőrizheti.

   Távoli hibakereső szolgáltatást leállíthat, és elindíthat a Vezérlőpult > Szolgáltatások-ban.

Hibakeresés beállítása távoli szimbólumokkal

A Visual Studio-számítógépen létrehozott szimbólumokkal képesnek kell lennie a kód hibakeresésére. A távoli hibakereső teljesítménye sokkal jobb, ha helyi szimbólumokat használ. Ha távoli szimbólumokat kell használnia, meg kell adnia a távoli hibakereső monitornak, hogy keressen szimbólumokat a távoli gépen.

Az alábbi msvsmon parancssori kapcsolóval használhat távoli szimbólumokat felügyelt kód esetén: Msvsmon /FallbackLoadRemoteManagedPdbs

További információt a távoli hibakeresési súgóban talál (nyomja le F1 a távoli hibakereső ablakban, vagy kattintson Súgó > Használati).

Kapcsolódó tartalom

• Első pillantás a hibakeresőre
• A Windows tűzfal konfigurálása távoli hibakeresési
• Távoli hibakereső portkiosztások
• ASP.NET Core távoli hibakeresése egy távoli IIS-számítógépen
• Távoli hibakeresési és hibaelhárítási problémák