Távoli hibakeresés

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

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	Távoli hibakeresés egy C# vagy Visual Basic projekt esetén
C++	C++ projekt távoli hibakeresése
Azure App Service	Távoli hibakeresés ASP.NET Core az Azure-on vagy Visual Studio Enterprise esetén a Snapshot Debugger
ASP.NET	Távoli hibakeresés ASP.NET Core vagy Távoli hibakeresés ASP.NET
Azure virtuális gép	Távoli hibakeresés ASP.NET-en egy Azure virtuális gépen
Linux	A .NET Core hibakeresése Linux alatt SSH használatával egy folyamathoz csatlakoztatva
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 hibakeresésre használni kívánt távoli eszközön vagy kiszolgálón a Visual Studio gép helyett 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 távoli eszközök legújabb frissítését a Visual Studio verziójához. A 2022-es és 2026-os Visual Studio távoli eszközei a Visual Studio bármelyik verziójával használhatók. A 2022-Visual Studio-nél régebbi távoli eszközök verziói azonban nem kompatibilisek a későbbi Visual Studio verziókkal. (Ha például Visual Studio 2019-et használ, töltse le a 2019-Visual Studio távoli eszközeinek legújabb frissítését. Ebben a forgatókönyvben ne töltse le a 2022-Visual Studio 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 Visual Studio 2022-ben és újabb verziókban. 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 2022-Visual Studio 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 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 2019-Visual Studio 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 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 a My.VisualStudio.com oldalon érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be 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 2015-ös Visual Studio 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 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.
2013 Visual Studio	Távoli eszközök	Lap letöltése a Visual Studio 2013 dokumentációjában
Visual Studio 2012	Távoli eszközök	Lap letöltése 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

• Az ARM-eszközökön Windows 10 vagy újabb alkalmazások hibakereséséhez használja az ARM64-et, amely a távoli eszközök legújabb verziójával érhető el.
• Az Windows RT eszközökön található Windows 10 alkalmazások hibakereséséhez használja az ARM-t, amely csak a Visual Studio 2015-ös távoli eszközök 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 kell csatlakoznia, 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őt (msvsmon.exe) olyan számítógépen találja, amelyen már telepítve van Visual Studio Community, Professional vagy 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 msvsmon.exe a Visual Studio verziójának megfelelő könyvtárban:

   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. Ossza meg a Remote Debugger 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ésről és a parancssori hivatkozásról a msvsmon.exe súgóoldalán olvashat, ha beírja a parancssorba azon a számítógépen, amelyen a Visual Studio telepítve van (vagy lépjen a távoli hibakeresőben a Help > Használat menüpontra).

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 Távoli hibakeresés konfigurálása lehetőséget.

   Távoli hibakereső konfigurációjának képernyőképe.Távoli hibakereső konfiguráció

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.

   Távoli hibakereső ablak képernyőképeTávoli hibakereső ablak

   A távoli hibakereső most egy kapcsolatra vár. A Visual Studio-ban a távoli kapcsolat konfigurációjának beállításához használja a megadott kiszolgáló nevét és portszámát.

A távoli hibakereső leállításához válassza FájlKilé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.

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

Ha részletes útmutatást szeretne az alkalmazáshoz való csatlakozáshoz Visual Studio, 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, .NET 5+, .NET Framework és C++ alkalmazások esetében azonban a távoli alkalmazást Visual Studio indíthatja el a project tulajdonságainak konfigurálásával és a hibakereső elindításával. További információ: C# vagy Visual Basic projekt hibakeresése vagy C++ projekt hibakeresése.

Távoli hibakeresést is végezhet olyan végrehajtható fájlokban, amelyek nem részei a Visual Studio project, bár a támogatott hibakeresési funkciók a konfigurációtól, például a szimbólumok rendelkezésre állásától függnek. További információ: A Visual Studio megoldás részét nem képező alkalmazások hibakeresése.

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

Az ASP.NET és más kiszolgálói környezetekben végzett hibakereséshez vagy 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 Studio.

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 Futtassa Visual Studio távoli hibakeresőt 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, megjelenik a következő üzenet: 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 Control Panel > Services webhelyen ellenőrizheti, és Visual Studio távoli hibakeresőt kereshet.

   A távoli hibakereső szolgáltatást a Control Panel > Services helyről állíthatja le és indíthatja el.

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

Képesnek kell lennie a kód hibakeresésére a Visual Studio számítógépen létrehozott szimbólumokkal. 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:

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és egy távoli IIS számítógépen
• Távoli hibakeresési és hibaelhárítási problémák