Távoli hibakeresés ASP.NET Core alkalmazásra egy távoli IIS-számítógépen a Visual Studióban

Az IIS-ben üzembe helyezett ASP.NET Core-alkalmazás hibakereséséhez telepítse és futtassa a távoli eszközöket azon a számítógépen, amelyen telepítette az alkalmazást, majd csatolja a futó alkalmazáshoz a Visual Studióból.

Ez az útmutató bemutatja, hogyan állíthat be és konfigurálhat Egy Visual Studio ASP.NET Core-t, hogyan helyezheti üzembe az IIS-ben, és hogyan csatolhatja a távoli hibakeresőt a Visual Studióból. Az ASP.NET 4.8 távoli hibakereséséhez tekintse meg a Távoli hibakeresés ASP.NET az IIS-számítógépenrészt. Az IIS-en az Azure használatával is üzembe helyezhet és hibakeresést végezhet. Az Azure App Service esetében lásd a Távoli ASP.NET Core hibakeresés az Azure-on, vagy a Visual Studio Enterprise-hoz használja a Snapshot Debugger-t (.NET 4.6.1 szükséges).

Előfeltételek

A jelen cikkben ismertetett lépések végrehajtásához Visual Studio 2019 vagy újabb verzió szükséges.

Ezeket az eljárásokat az alábbi kiszolgálókonfigurációkon teszteltük:

• Windows Server 2022 és IIS 10
• Windows Server 2019 és IIS 10
• Windows Server 2016 és IIS 10

Hálózati követelmények

A proxyn keresztül csatlakoztatott két számítógép közötti hibakeresés nem támogatott. Nagy késleltetésű vagy alacsony sávszélességű kapcsolat esetén, mint például a betárcsázós internet, vagy az internetkapcsolat országok/régiók közötti használatakor végzett hibakeresést nem javasoljuk, mivel az sikertelen lehet vagy elfogadhatatlanul lassú. A követelmények teljes listáját a Követelményekcímű témakörben találja.

Az alkalmazás már fut az IIS-ben?

Ez a cikk az IIS alapkonfigurációjának windowsos kiszolgálón történő beállításával és az alkalmazás Visual Studióból való üzembe helyezésével kapcsolatos lépéseket tartalmazza. Ezek a lépések biztosítják, hogy a kiszolgáló telepítve legyen a szükséges összetevőkkel, hogy az alkalmazás megfelelően fusson, és készen álljon a távoli hibakeresésre.

• Ha az alkalmazás IIS alatt fut, és csak le szeretné tölteni a távoli hibakeresőt, majd megkezdeni a hibakeresést, lépjen a Töltse le és telepítse a távoli eszközöket a Windows Serverre.

• Ha segítségre van szüksége annak biztosításához, hogy az alkalmazás megfelelően legyen beállítva, üzembe helyezve és megfelelően fusson az IIS-ben, hogy hibakeresést végezhet, kövesse a cikk összes lépését.

A ASP.NET Core-alkalmazás létrehozása a Visual Studio számítógépén

1. Hozzon létre egy új ASP.NET Core-webalkalmazást.

   A Visual Studióban válassza Fájl>Start ablak lehetőséget a Start ablak megnyitásához, majd válassza Új projekt létrehozásalehetőséget. A keresőmezőbe írja be webalkalmazás, majd válassza C# nyelvként, majd válassza ASP.NET Core Web Application (Model-View-Controller), majd válassza a Továbblehetőséget. A következő képernyőn nevezze el a projektet MyASPApp, majd válassza a Továbblehetőséget.

   Válassza ki az ajánlott cél keretrendszert vagy a .NET 8-at, majd válassza a Létrehozáslehetőséget. A verziónak meg kell egyeznie a kiszolgálón telepített verzióval.

2. Nyissa meg a HomeController.cs fájlt a Vezérlők mappában, és állítson be egy töréspontot a return View; utasításban a Privacy metódusban.

   Régebbi sablonokban nyissa meg a Privacy.cshtml.cs fájlt, és állítson be töréspontot a OnGet metódusban.

Az IIS telepítése és konfigurálása Windows Serveren

Ezek a lépések csak az IIS alapkonfigurációját mutatják be. További részletes információkért vagy windowsos asztali gépekre való telepítéshez lásd: Közzététel az IIS vagy IIS 8.0-s verziójában ASP.NET 3.5 és ASP.NET 4.5.

Windows Server operációs rendszerek esetén használja a Szerepkörök és szolgáltatások hozzáadása varázslót a Kezelés hivatkozáson vagy a Server ManagerIrányítópult hivatkozásán keresztül. A kiszolgálói szerepkörök lépésben jelölje be webkiszolgáló (IIS)jelölőnégyzetét.

(Windows Server 2022) A megjelenő párbeszédpanelen válassza a Szolgáltatások hozzáadása lehetőséget az IIS felügyeleti konzoljának hozzáadásához.

A szerepkör-szolgáltatások lépésben válassza ki a kívánt IIS szerepkör-szolgáltatásokat, vagy fogadja el az alapértelmezett szerepkör-szolgáltatásokat. Ha engedélyezni szeretné az üzembe helyezést a közzétételi beállításokkal és a webes üzembe helyezéssel, győződjön meg arról, hogy a következő funkciók vannak kiválasztva:

• IIS felügyeleti szkriptjei és eszközei
• Felügyeleti szolgáltatás
• IIS felügyeleti konzol

A webkiszolgálói szerepkör és szolgáltatások telepítéséhez kövesse a megerősítést kérő lépéseket. A webkiszolgálói (IIS) szerepkör telepítése után nincs szükség kiszolgáló-/IIS-újraindításra.

Böngésző biztonsági beállításainak frissítése a Windows Serveren

Ha a Windows Server régebbi verzióját használja, előfordulhat, hogy megbízható helyként kell hozzáadnia néhány tartományt, hogy lehetővé tegye a webkiszolgáló egyes összetevőinek letöltését. Adja hozzá a megbízható webhelyeket az Internetbeállítások menüpontra > Biztonság > Megbízható helyek > Webhelyekmenüpontok alatt. Adja hozzá a következő tartományokat.

• microsoft.com
• go.microsoft.com
• download.microsoft.com
• iis.net

A szoftver letöltésekor különböző webhelyszkriptek és -erőforrások betöltésére vonatkozó engedély megadására vonatkozó kérelmeket kaphat. Ezen erőforrások némelyike nem szükséges, de a folyamat leegyszerűsítéséhez válassza a hozzáadása lehetőséget, amikor a rendszer kéri.

A ASP.NET Core telepítése Windows Serveren

1. Telepítse a .NET Core-tárhelycsomagot az üzemeltetési rendszerre. A csomag telepíti a .NET Core-futtatókörnyezetet, a .NET Core-kódtárat és a ASP.NET Core-modult. További részletes útmutatásért lásd: Közzététel az IIS-ben.

   Az aktuális .NET Core-üzemeltetési csomaghoz telepítse a ASP.NET Core Hosting Bundle.

   Jegyzet

   Ha korábban telepítette az IIS-t, a ASP.NET Core IIS-modul a ASP.NET Core-val lesz telepítve. Ellenkező esetben telepítse manuálisan a ASP.NET Core IIS-modult.

   A .NET Core 2 esetén telepítse a .NET Core Windows Server Hosting.

   Jegyzet

   Ha a rendszer nem rendelkezik internetkapcsolattal, a .NET Core Windows Server Hosting csomag telepítése előtt szerezze be és telepítse a Microsoft Visual C++ 2015 Terjeszthető.

2. Indítsa újra a rendszert (vagy hajtsa végre a következő parancsokat egy parancssorból a rendszer PATH-jának frissítéséhez: net stop was /y, majd net start w3svc).

Üzembe helyezési lehetőség kiválasztása

Ha segítségre van szüksége az alkalmazás IIS-ben való üzembe helyezéséhez, fontolja meg az alábbi lehetőségeket:

• Üzembe helyezés: hozzon létre egy közzétételi beállításokat tartalmazó fájlt az IIS-ben, és importálja a beállításokat a Visual Studióban. Bizonyos esetekben ez az alkalmazás gyors üzembe helyezésének módja. A közzétételi beállításfájl létrehozásakor az engedélyek automatikusan be lesznek állítva az IIS-ben.

• Üzembe helyezés egy helyi mappában való közzétételsel és a kimenet egy előnyben részesített módszerrel történő másolásával az IIS előkészített alkalmazásmappájába.

(Nem kötelező) Üzembe helyezés közzétételi beállításfájl használatával

Ezzel a beállítással létrehozhat egy közzétételi beállításfájlt, és importálhatja azt a Visual Studióba.

Jegyzet

Ha a közzétételi beállítások importálása helyett manuálisan szeretné konfigurálni a webes üzembe helyezést, győződjön meg arról, hogy a kiszolgáló alkalmazásmappája a megfelelő értékekkel és engedélyekkel van konfigurálva (lásd ASP.NET webhelykonfigurálását).

A ASP.NET Core-webhely konfigurálása

1. Az IIS Manager bal oldali ablaktábláján, a Kapcsolatokalatt válassza Alkalmazáskészleteklehetőséget. Nyissa meg a DefaultAppPool-t, és állítsa a .NET CLR-verziót-ra Felügyelet nélküli kódra. Ez a ASP.NET Core esetében szükséges. Az alapértelmezett webhely a DefaultAppPoolt használja.

2. Állítsa le és indítsa újra a DefaultAppPoolt.

Webes üzembe helyezés telepítése és konfigurálása Windows Serveren

A Web Deploy további konfigurációs funkciókat biztosít, amelyek lehetővé teszik a közzétételi beállítások fájljának létrehozását a felhasználói felületen.

Jegyzet

A webplatform-telepítő 22.07.12-én elérte az élettartam végét. További információ: Web Platform telepítő – Támogatás megszűnése és a termék-/alkalmazáscsatorna megszüntetése. A közzétételi beállítások fájljának létrehozásához közvetlenül telepítheti a Web Deploy 4.0-t.

1. Ha még nem telepítette IIS felügyeleti szkripteket és eszközöket, telepítse most.

   Nyissa meg Kiszolgálói szerepkörök kiválasztása>Webkiszolgáló (IIS)>Felügyeleti eszközök, majd válassza ki a IIS felügyeleti szkriptek és eszközök szerepkört, kattintson a Továbbgombra, majd telepítse a szerepkört.

   

   A közzétételi beállítások fájljának létrehozásához szkriptekre és eszközökre van szükség.

   Győződjön meg arról, hogy telepíti a Felügyeleti szolgáltatás és IIS felügyeleti konzol is (lehet, hogy már telepítve vannak).

2. Windows Serveren töltse le a Web Deploy 4.0.

3. Futtassa a Web Deploy telepítőprogramot, és ügyeljen arra, hogy egy tipikus telepítés helyett Teljes telepítést válassza.

   A teljes telepítéssel lekérheti a közzétételi beállításfájl létrehozásához szükséges összetevőket. (Ha ehelyett Egyéni választ, az összetevők listája látható az alábbi ábrán látható módon.)

   

4. (Nem kötelező) Ellenőrizze, hogy a Web Deploy megfelelően működik-e a Vezérlőpultrendszer > és a Biztonsági > Windows Tools > Services megnyitásával, majd győződjön meg arról, hogy:

   • Web Deployment Agent Service fut (a szolgáltatás neve a régebbi verziókban eltérő).

   • A Web Management Service működik.

   Ha az egyik ügynökszolgáltatás nem fut, indítsa újra a Web Deployment Agent Service.

   Ha a Web Deployment Agent szolgáltatás egyáltalán nem található, lépjen Vezérlőpult > Programok > Program eltávolításaelemre, és keresse meg Microsoft Web Deploy <verzió>. Válassza A telepítés módosítása lehetőséget, és győződjön meg arról, hogy a A webtelepítés összetevőinek helyi merevlemezére lesz telepítve. Végezze el a módosítás telepítési lépéseit.

A közzétételi beállítások fájljának létrehozása az IIS-ben Windows Serveren

1. Zárja be és nyissa meg újra az IIS felügyeleti konzolt a frissített konfigurációs beállítások megjelenítéséhez a felhasználói felületen.

2. Az IIS-ben kattintson a jobb gombbal az Alapértelmezett webhelyelemre, válassza a Üzembe helyezés>Webes közzététel konfigurálásalehetőséget.

   

   Ha nem látja a Üzembe helyezés menüt, az előző szakaszban ellenőrizheti, hogy a Web Deploy fut-e.

3. A Webes közzététel konfigurálása párbeszédpanelen vizsgálja meg a beállításokat.

4. Kattintson Beállításgombra.

   Az Eredmények panelen a kimenet azt mutatja, hogy a hozzáférési jogosultságok a megadott felhasználónak vannak megadva, és hogy egy fájlkiterjesztéssel rendelkező .publishsettings fájl lett létrehozva a párbeszédpanelen látható helyen.

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

   A Windows Server és az IIS konfigurációjától függően különböző értékek láthatók az XML-fájlban. Íme néhány részlet a megjelenő értékekről:

   • A attribútumban hivatkozott publishUrl fájl egy dinamikusan létrehozott HTTP-kezelőfájl a Web Deploy számára. (Tesztelési célokra általában http://myhostname:8172 is működik.)

   • A publishUrl port a 8172-s portra van állítva, amely a Web Deploy alapértelmezett értéke.

   • A destinationAppUrl port a 80-ra van állítva, ami az IIS alapértelmezett értéke.

   • Ha a későbbi lépésekben nem tud csatlakozni a távoli hoszthoz Visual Studio-ból a hosztnév használatával, akkor tesztelje a kiszolgáló IP-címét a hosztnév helyett.

     Jegyzet

     Ha Azure-beli virtuális gépen futó IIS-ben tesz közzé, meg kell nyitnia egy bejövő portot a Web Deploy és az IIS számára a Hálózati biztonsági csoportban. További információ: Portok megnyitása virtuális gépeken.

5. Másolja ezt a fájlt arra a számítógépre, amelyen a Visual Studiót futtatja.

A közzétételi beállítások importálása a Visual Studióban és üzembe helyezés

1. Azon a számítógépen, amelyen meg van nyitva a ASP.NET projekt a Visual Studióban, kattintson a jobb gombbal a projektre a Megoldáskezelőben, és válassza a Közzététellehetőséget.

   Ha korábban bármilyen közzétételi profilt konfigurált, megjelenik a Közzététel panel. Kattintson Új vagy Új profillétrehozására.

2. Válassza ki a profil importálásának lehetőségét.

   A Közzététel párbeszédpanelen kattintson a Profil importálásagombra.

   

3. Keresse meg az előző szakaszban létrehozott közzétételi beállításfájl helyét.

4. A Közzétételi beállítások importfájlja párbeszédpanelen keresse meg és válassza ki az előző szakaszban létrehozott profilt, majd kattintson a Megnyitásgombra.

   A közzétételi profil mentéséhez kattintson a Befejezés gombra, majd a Közzétételgombra.

   A Visual Studio megkezdi az üzembe helyezési folyamatot, a Kimenet ablakban pedig az előrehaladás és az eredmények láthatók.

   Ha telepítési hibák merülnek fel, a beállítások szerkesztéséhez kattintson a További műveletek>szerkesztése gombra. Módosítsa a beállításokat, és kattintson a ellenőrzése gombra az új beállítások teszteléséhez. Ha a gazdagép neve nem található, próbálkozzon az IP-címmel a Szerver és a cél URL mezőkben a gazdagép neve helyett.

   

Az alkalmazás sikeres üzembe helyezése után automatikusan el kell indulnia.

• Ha az alkalmazás nem indul el az üzembe helyezés után, indítsa el az alkalmazást az IIS-ben, hogy ellenőrizze, hogy megfelelően fut-e.
• Az ASP.NET Core esetében győződjön meg arról, hogy a DefaultAppPool alkalmazáskészlet mező értéke Nincs kezelt kód.

Ha elkészült, váltson hibakeresési konfigurációra.

Fontos

Ha a kiadási konfiguráció hibakeresését választja, a közzétételkor letiltja a hibakeresést a web.config fájlban.

1. A profil szerkesztéséhez válassza a További beállítások>lehetőséget, majd a Szerkesztés lehetőséget, és végül válassza a Beállításoklehetőséget.
2. Válassza Mentés lehetőséget, majd tegye közzé újra az alkalmazást.
3. Válasszon egy Hibakeresési konfigurációt, majd válassza a További fájlok eltávolítása a célhelyen lehetőséget a Fájl közzététele beállítások alatt.

Figyelmeztetés

A felhasználónév és a jelszó hitelesítő adatainak használata (alapszintű hitelesítés) nem a legbiztonságosabb hitelesítési módszer. Ha lehetséges, használjon alternatív módszereket. Például fontolja meg egy csomag közzétételét a Visual Studio használatával, majd a csomag telepítéséhez használja a parancssorban a WebDeploy.exe parancsokat. Ezzel a módszerrel az IIS Manager használatával konfigurálhatja a webkiszolgálón közzétehető jogosult Windows-felhasználókat, és futtathat WebDeploy.exe az adott Windows-felhasználói fiók alatt. Lásd: Webes üzembe helyezés telepítése és konfigurálása az IIS 8.0-s vagy újabb verzióján. Ha jelszó-hitelesítő adatokat használ, ügyeljen arra, hogy erős jelszót használjon, és gondoskodjon arról, hogy a jelszó ne szivárogjon ki vagy ne legyen megosztódjon.

(Nem kötelező) Üzembe helyezés helyi mappában való közzétételsel

Ezzel a beállítással telepítheti az alkalmazást, ha a PowerShell, a RoboCopy vagy a fájlok manuális másolásával szeretné az alkalmazást az IIS-be másolni.

A ASP.NET Core-webhely konfigurálása a Windows Server számítógépen

1. Nyissa meg a Windows Intézőt, és hozzon létre egy új mappát C:\Publish, a ASP.NET Core-projekt üzembe helyezéséhez.

2. Ha még nincs megnyitva, nyissa meg az Internet Information Services (IIS) kezelőt. (A Kiszolgálókezelő bal oldali ablaktábláján válassza IISlehetőséget. Kattintson a jobb gombbal a kiszolgálóra, és válassza Internet Information Services (IIS) Kezelőlehetőséget.)

3. A bal oldali panelen Kapcsolatok területen lépjen Webhelyekelemre.

4. Válassza ki az Alapértelmezett webhely, válassza Alapbeállításoklehetőséget, és állítsa a fizikai elérési utatC:\Publishértékre.

5. Kattintson a jobb gombbal az Alapértelmezett webhely csomópontra, és válassza Alkalmazás hozzáadásalehetőséget.

6. Állítsa a Alias mezőt a MyASPAppértékre, fogadja el az alapértelmezett alkalmazási fürdőt (DefaultAppPool), és állítsa a Fizikai elérési útvonalC:\Publishértékre.

7. A Kapcsolatokterületen válassza Alkalmazáskészleteklehetőséget. Nyissa meg DefaultAppPool, és állítsa az alkalmazáskészlet mezőjét úgy, hogy Nincs felügyelt kód.

8. Kattintson a jobb gombbal az új webhelyre az IIS-kezelőben, válassza az Engedélyek szerkesztéselehetőséget, és győződjön meg arról, hogy az IUSR, a IIS_IUSRS vagy a webalkalmazáshoz való hozzáférésre konfigurált felhasználó jogosult felhasználó olvasási & Végrehajtási jogosultsággal.

   Ha nem látja a hozzáféréssel rendelkező felhasználók egyikét, végezze el az IUSR felhasználóként való hozzáadását olvasási & végrehajtási jogosultságokkal.

Fontos

A beépített fiókokkal kapcsolatos biztonsági információkért lásd: Built-In Felhasználói és csoportfiókok ismertetése az IIS 7.

Az alkalmazás közzététele és üzembe helyezése helyi mappában való közzétételsel a Visual Studióból

Az alkalmazást a fájlrendszerrel vagy más eszközökkel is közzéteheti és üzembe helyezheti.

1. A Megoldáskezelőbenkattintson a jobb gombbal a projekt csomópontra, és válassza a Közzététel (webes űrlapok esetén Webalkalmazás közzététele).

   Ha korábban már konfigurált közzétételi profilokat, megjelenik a Közzététel panel. Kattintson Új profilelemre.

2. A Közzététel párbeszédpanelen válassza a Mappalehetőséget, kattintson a Tallózáselemre, és hozzon létre egy új mappát, C:\Publish.

   

   Kattintson Befejezés gombra a közzétételi profil mentéséhez.

3. Váltson hibakeresési konfigurációra.

   A profil szerkesztéséhez válassza a Szerkesztés lehetőséget, majd válassza a Beállításoklehetőséget. Válasszon egy Hibakeresési konfigurációt, majd válassza További fájlok eltávolítása a célhelyen lehetőséget a Fájl közzététele beállításnál.

   

   Jegyzet

   Ha Kiadási buildet használ, közzétételkor letiltod a hibakeresést a web.config fájlban.

4. Kattintson Közzétételgombra.

   Az alkalmazás közzéteszi a projekt hibakeresési konfigurációját a helyi mappában. A folyamat a Kimenet ablakban jelenik meg.

5. Másolja a ASP.NET projektkönyvtárat a Visual Studio számítógépről a ASP.NET alkalmazáshoz konfigurált helyi könyvtárba (ebben a példában C:\Publish) a Windows Server-számítógépen. Ebben az oktatóanyagban feltételezzük, hogy manuálisan másol, de más eszközöket is használhat, például a PowerShellt, a Xcopyt vagy a Robocopyt.

   Óvatosság

   Ha módosítania kell a kódot, vagy újra kell építenie, újra kell közzétennie, és meg kell ismételnie ezt a lépést. A távoli gépre másolt végrehajtható fájlnak pontosan meg kell egyeznie a helyi forrással és szimbólumokkal. Ha ezt nem teszi meg, cannot find or open the PDB file figyelmeztetés jelenik meg a Visual Studióban, amikor megpróbál hibakeresést végezni a folyamaton.

6. A Windows Serveren ellenőrizze, hogy megfelelően tudja-e futtatni az alkalmazást az alkalmazás böngészőben való megnyitásával.

   Ha az alkalmazás nem fut megfelelően, előfordulhat, hogy a kiszolgálón és a Visual Studio-gépen telepített ASP.NET verziója nem egyezik, vagy probléma merülhet fel az IIS vagy a webhely konfigurációjával kapcsolatban. Ellenőrizze újra a korábbi lépéseket.

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

Töltse le a Visual Studio verziójának megfelelő távoli eszközök verzióját.

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ó	Hivatkozás	Jegyzetek
Visual Studio 2022	Távoli eszközök	Kompatibilis az összes Visual Studio 2022-verzió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óért lásd: (Nem kötelező) A távoli hibakereső szolgáltatásként történő konfigurálása.

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özökkel telepített x64 msvsmon.exe-t.

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

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óért lásd: A távoli hibakereső rendszergazdaként történő futtatása.

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 konfigurálása 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ő elindí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

Jegyzet

Ha további felhasználók engedélyeit kell hozzáadnia, módosítsa a hitelesítési módot vagy a távoli hibakereső portszámát, olvassa el A távoli hibakereső konfigurálásacímű témakört.

A távoli hibakereső szolgáltatásként való futtatásával kapcsolatos információkért lásd: A távoli hibakereső futtatása szolgáltatásként.

Csatolás a ASP.NET Core-alkalmazáshoz a Visual Studio számítógépről

A Visual Studio 2022 17.10 Preview 2-es verziójától kezdve a Folyamat csatolása párbeszédpanel megváltozott. Ha a régebbi párbeszédpanelnek megfelelő utasításokra van szüksége, váltson a Visual Studio 2019 nézetre (a cikk bal felső verzióválasztója).

1. Nyissa meg a Visual Studio számítógépen a hibakeresésre használt megoldást (MyASPApp, ha a cikkben szereplő összes lépést követi).

2. Visual Studióban válassza a Hibakeresés > Csatolás folyamathoz (Ctrl + Alt + P) lehetőséget.

   Borravaló

   A Visual Studio 2017-ben és az újabb verziókban ugyanahhoz a folyamathoz csatlakozhat újra, amelyhez korábban csatlakozott a Hibakeresés > Újracsatlakozás a folyamathoz... (Shift + Alt + P) használatával.

3. Állítsa a kapcsolattípustTávoli (Windows).

   Megjelenik a kapcsolati cél lehetőség.

   Állítsa be a kapcsolati cél<távoli számítógép nevét>, majd nyomja le Enterbillentyűt.

   Ellenőrizze, hogy a Visual Studio hozzáadja-e a szükséges portot a számítógép nevéhez, amely a következő formátumban jelenik meg: <távoli számítógép neve>:p ort

   A Visual Studio 2022-ben <távoli számítógép neve>:4026

   A portra szükség van. Ha nem látja a portszámot, adja hozzá manuálisan.

4. Válassza a Frissítésparancsot.

   Néhány folyamatnak meg kell jelennie az Elérhető folyamatok ablakban.

   Ha nem lát folyamatokat, próbálja meg az IP-címet használni a távoli számítógép neve helyett (a port megadása kötelező). Az IPv4-cím lekéréséhez használhatja a ipconfig parancssorban.

   Ha a Keresés gombot szeretné használni, előfordulhat, hogy meg kell nyitnia a 3702- kimenő UDP-portot a kiszolgálón.

5. Ellenőrizze Az összes felhasználó folyamatainak megjelenítése.

6. Írja be a megnyitni kívánt alkalmazás nevének első betűjét, hogy gyorsan megtalálja az alkalmazást.

   • Ha a folyamatban lévő üzemeltetési modellt használja az IIS-en, válassza ki a megfelelő w3wp.exe folyamatot. A .NET Core 3-tól kezdődően ez a folyamat az alapértelmezett.

   • Ellenkező esetben válassza ki a dotnet.exe folyamatot. (Ez a folyamaton kívüli üzemeltetési modell.)

   Ha több folyamat is megjelenik w3wp.exe vagy dotnet.exe, ellenőrizze a Felhasználónév oszlopot. Bizonyos esetekben a Felhasználónév oszlop az alkalmazáskészlet nevét jeleníti meg, például IIS APPPOOL\DefaultAppPool. Ha látja az alkalmazáskészletet, de az nem egyedi, hozzon létre egy új, elnevezett alkalmazáskészletet a hibakeresni kívánt alkalmazáspéldány számára, így könnyen megtalálhatja a Felhasználónév oszlopban.

   

7. Válassza Csatoláslehetőséget.

8. Nyissa meg a távoli számítógép webhelyét. Böngészőben lépjen http://<távoli számítógépnév>.

   Látnia kellene az ASP.NET weblapot.

9. A futó ASP.NET alkalmazásban válassza a Adatvédelmi lapra mutató hivatkozást.

   A töréspontot a Visual Studióban kell eltalálni.

   Ha nem tudja csatolni vagy elérni a töréspontot, nézze meg a Távoli hibakereséshibaelhárítása című részt.

Az IIS üzembe helyezésének hibaelhárítása

• Ha nem tud csatlakozni a gazdagéphez a gazdagép nevének használatával, próbálkozzon inkább az IP-címmel.
• Győződjön meg arról, hogy a szükséges portok nyitva vannak a távoli kiszolgálón.
• Az ASP.NET Core esetében meg kell győződnie arról, hogy a DefaultAppPool alkalmazáskészletének mezője Nincs felügyelt kód.
• Ellenőrizze, hogy az alkalmazásban használt ASP.NET verziója megegyezik-e a kiszolgálón telepített verzióval. Az alkalmazáshoz a verziót a Tulajdonságok lapon tekintheti meg és állíthatja be. Az alkalmazás másik verzióra való beállításához telepíteni kell az adott verziót.
• Ha az alkalmazás megpróbált megnyitni, de megjelenik egy tanúsítványra vonatkozó figyelmeztetés, válassza ki, hogy megbízik-e a webhelyen. Ha már bezárta a figyelmeztetést, szerkesztheti a közzétételi profilt, egy *.pubxml fájlt a projektben, és hozzáadhatja a következő elemet (csak teszteléshez): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Az üzembe helyezés után indítsa el az alkalmazást az IIS-ben, hogy tesztelje a helyes üzembe helyezést.
• Ellenőrizze a Visual Studio Kimeneti ablakában az állapotinformációkat, és ellenőrizze a hibaüzeneteket.

A szükséges portok megnyitása a Windows Serveren

A legtöbb beállításban a szükséges portokat a ASP.NET és a távoli hibakereső telepítése nyitja meg. Előfordulhat azonban, hogy ellenőriznie kell, hogy a portok nyitva vannak-e.

Jegyzet

Azure-beli virtuális gépeken a portokat a hálózati biztonsági csoporton keresztül kell megnyitnia.

Szükséges portok:

• 80: Az IIS -hez (HTTP) szükséges.

• 4026: A Visual Studio 2022 távoli hibakereséséhez szükséges (további információért lásd a távoli hibakeresési port-hozzárendeléseket).

• UDP 3702: (Nem kötelező) A felderítési port lehetővé teszi a Keresés gomb használatát a Visual Studio távoli hibakeresőjéhez való csatoláskor.

Ezenkívül ezeket a portokat már meg kell nyitnia a ASP.NET telepítésekor:

• 8172: (Nem kötelező) A Web Deploy használatához szükséges az alkalmazás Visual Studióból történő üzembe helyezéséhez

Port megnyitása

1. Ha portot szeretne megnyitni a Windows Serveren, nyissa meg a Start menüt, keresse meg a Windows Defender tűzfal vagy a Windows tűzfal speciális biztonsági funkciókkal.

   Válassza a Windows Defender Tűzfal, majd a Speciális beállításoklehetőséget.

2. Ezután válassza Bejövő szabályok > Új szabály > Portlehetőséget, majd válassza a Továbblehetőséget. (Az UDP 3702-ben válassza kimenő szabályok helyett.)

3. Az Adott helyi portokterületen adja meg a portszámot, és válassza a Továbblehetőséget.

4. Válassza a Kapcsolat engedélyezéselehetőséget, majd válassza a Továbblehetőséget.

5. Jelöljön ki egy vagy több hálózati típust a port engedélyezéséhez, és válassza a Továbblehetőséget.

   A kiválasztott típusnak tartalmaznia kell azt a hálózatot, amelyhez a távoli számítógép csatlakozik.

6. Adja hozzá a bejövő szabály nevét (például IIS, Web Deployvagy msvsmon) a bejövő szabályhoz, és válassza Befejezéslehetőséget.

   Az új szabálynak meg kell jelennie a Bejövő szabályok vagy a Kimenő szabályok listában.

   Ha további részleteket szeretne a Windows tűzfal konfigurálásáról, olvassa el A Windows tűzfal konfigurálása távoli hibakeresési.

7. Hozzon létre további szabályokat a többi szükséges porthoz.