Vzdálené ladění ASP.NET na IIS vzdáleném počítači

Pokud chcete ladit ASP.NET aplikaci nasazenou do služby IIS, nainstalujte a spusťte vzdálené nástroje na počítači, na kterém jste nasadili aplikaci, a pak se připojte ke spuštěné aplikaci ze sady Visual Studio.

Tato příručka vysvětluje, jak nastavit a nakonfigurovat aplikaci Visual Studio ASP.NET MVC 4.8, nasadit ji do služby IIS a připojit vzdálený ladicí program ze sady Visual Studio.

Poznámka

Pokud chcete vzdáleně ladit ASP.NET Core, přečtěte si téma Vzdálené ladění ASP.NET Core na počítači se službou IIS. Informace o službě Azure App Service najdete v tématu Vzdálené ladění ASP.NET Core v Azure nebo v případě sady Visual Studio Enterprise použijte Snapshot Debugger (vyžaduje se .NET 4.6.1).

Požadavky

K provedení kroků uvedených v tomto článku se vyžaduje Visual Studio 2019 nebo novější verze.

Tyto postupy byly testovány na těchto konfiguracích serveru:

• Windows Server 2022 a IIS 10
• Windows Server 2012 R2 a IIS 8 (pro Windows Server 2008 R2 se postup serveru liší)

Požadavky na síť

Vzdálený ladicí program je podporován ve Windows Serveru počínaje verzí Windows Server 2008 Service Pack 2. Úplný seznam požadavků najdete v tématu Požadavky.

Poznámka

Ladění mezi dvěma počítači připojenými přes proxy server se nepodporuje. Ladění s vysokou latencí nebo připojením s nízkou šířkou pásma, jako je například vytáčené připojení k internetu, nebo napříč zeměmi či oblastmi po internetu, se nedoporučuje, protože může selhat nebo fungovat nepřijatelně pomalu.

Aplikace už běží ve službě IIS?

Tento článek obsahuje postup nastavení základní konfigurace služby IIS na Windows Serveru a nasazení aplikace ze sady Visual Studio. Tyto kroky jsou zahrnuty, aby se zajistilo, že server má nainstalované požadované součásti, že aplikace může běžet správně a že jste připraveni ke vzdálenému ladění.

• Pokud je vaše aplikace spuštěná ve službě IIS a chcete stáhnout vzdálený ladicí program a spustit ladění, přejděte na Stáhnout a nainstalovat vzdálené nástroje na Windows Server.

• Pokud potřebujete pomoc s zajištěním, že je vaše aplikace nastavená, nasazená a správně spuštěná ve službě IIS, abyste ji mohli ladit, postupujte podle všech kroků v tomto článku.

Vytvoření aplikace ASP.NET 4.8 na počítači se sadou Visual Studio

1. Vytvořte novou aplikaci ASP.NET MVC.

   Ve Visual Studiu zvolte Soubor>Okno Start otevřít okno Start a pak zvolte Vytvořit nový projekt. Do vyhledávacího pole zadejte asp.net rozhranía pak zvolte ASP.NET webovou aplikaci (.NET Framework). V dialogovém okně, které se zobrazí, pojmenujte projekt MyASPApp, zvolte ASP.NET Framework 4.8a pak zvolte Vytvořit.

   Vyberte MVC a zvolte Vytvořit.

2. Otevřete soubor HomeController.cs ve složce Controllers a nastavte zarážku v příkazu return View; v metodě Privacy.

   Ve starších šablonách otevřete soubor Privacy.cshtml.cs a nastavte zarážku v metodě OnGet.

Instalace a konfigurace služby IIS na Windows Serveru

Tyto kroky zobrazují pouze základní konfiguraci služby IIS. Podrobnější informace nebo instalaci na stolní počítač s Windows najdete v tématu Publikování do služby IIS nebo IIS 8.0 pomocí ASP.NET 3.5 a ASP.NET 4.5.

V případě operačních systémů Windows Server použijte průvodce Přidat role a funkce prostřednictvím odkazu Spravovat nebo odkazu Řídicí panel v Správci serveru. Na kroku role serveru zaškrtněte políčko pro webový server (IIS).

(Windows Server 2022) V dialogovém okně, které se zobrazí, zvolte Přidat funkce přidat konzolu pro správu služby IIS.

V kroku Služby rolí vyberte služby role IIS, které chcete, nebo přijměte poskytnuté výchozí služby rolí. Pokud chcete povolit nasazení pomocí nastavení publikování a nasazení webu, ujistěte se, že jsou vybrané následující funkce:

• skripty a nástroje pro správu služby IIS
• služby pro správu
• Konzole pro správu IIS

Pokračujte postupem potvrzení instalace role a služeb webového serveru. Po instalaci role Webového serveru (IIS) není vyžadováno restartování serveru nebo služby IIS.

Aktualizace nastavení zabezpečení prohlížeče ve Windows Serveru

Pokud používáte starší verzi Windows Serveru, možná budete muset přidat některé domény jako důvěryhodné weby, abyste mohli stáhnout některé součásti webového serveru. Přidejte důvěryhodné weby tak, že přejdete na Možnosti internetu > zabezpečení > důvěryhodné servery > weby. Přidejte následující domény.

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

Při stahování softwaru můžete získat žádosti o udělení oprávnění k načtení různých skriptů a prostředků webu. Některé z těchto prostředků se nevyžadují, ale chcete-li proces zjednodušit, vyberte po zobrazení výzvy Přidat.

Instalace ASP.NET 4.8 na Windows Serveru

Pokud chcete získat podrobnější informace o instalaci ASP.NET ve službě IIS, přečtěte si téma IIS 8.0 Pomocí ASP.NET 3.5 a ASP.NET 4.5.

Poznámka

Instalační program webové platformy dosáhl konce životnosti dne 1. 7. 2022. Další informace najdete v tématu Instalační program webové platformy – ukončení podpory a ukončení kanálu produktu nebo aplikace. Můžete přímo nainstalovat ASP.NET 4.8 ze služby IIS.

1. V levém podokně Správce serveru vyberte iis. Klikněte pravým tlačítkem na server a vyberte Přidat role a funkce.

2. V průvodci přejděte do části Funkce a nainstalujte ASP.NET 4.8.

   

   Poznámka

   Pokud používáte Windows Server 2008 R2, nainstalujte místo toho ASP.NET 4 pomocí tohoto příkazu:

   C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir

3. Restartujte systém (nebo spusťte net stop byl /y následovaný net start w3svc z příkazového řádku, aby se zobrazila změna systémové CESTY).

Volba možnosti nasazení

Pokud potřebujete pomoc s nasazením aplikace do služby IIS, zvažte tyto možnosti:

• Nasaďte ho vytvořením souboru nastavení publikování ve službě IIS a importem nastavení v sadě Visual Studio. V některých scénářích je to rychlý způsob nasazení aplikace. Při vytváření souboru nastavení publikování se oprávnění automaticky nastaví ve službě IIS.

• Nasaďte publikováním do místní složky a zkopírováním výstupu upřednostňovanou metodou do připravené složky aplikace ve službě IIS.

(Volitelné) Nasazení pomocí souboru nastavení publikování

Tuto možnost můžete použít k vytvoření souboru nastavení publikování a jeho importu do sady Visual Studio.

Poznámka

Pokud chcete nasazení webu nakonfigurovat ručně místo importu nastavení publikování, musíte se ujistit, že je na serveru nakonfigurovaná složka aplikace se správnými hodnotami a oprávněními (viz Konfigurace ASP.NET webu).

Instalace a konfigurace nasazení webu na Windows Serveru

Web Deploy poskytuje další konfigurační funkce, které umožňují vytvoření souboru publikačních nastavení z uživatelského rozhraní.

Poznámka

Instalační program webové platformy dosáhl konce životnosti 22. 7. 22. Další informace najdete v dokumentu Instalační program webové platformy – ukončení podpory a vyřazení kanálu produktu/aplikace. Web Deploy 4.0 můžete přímo nainstalovat a vytvořit soubor nastavení publikování.

1. Pokud jste ještě nenainstalovali skripty a nástroje pro správu služby IIS, nainstalujte ho teď.

   Přejděte na Vyberte role serveru>webový server (IIS)>Nástroje pro správua pak vyberte role Skripty a nástroje pro správu služby IIS, klikněte na Dalšía potom nainstalujte roli.

   

   Skripty a nástroje jsou potřeba k povolení generování souboru nastavení publikování.

   Nezapomeňte také nainstalovat služby pro správu a konzolu pro správu služby IIS (možná už jsou nainstalované).

2. Ve Windows Serveru stáhněte Web Deploy 4.0.

3. Spusťte instalační program Nasazení webu a ujistěte se, že jste místo typické instalace vybrali Dokončit instalaci.

   Po dokončení instalace získáte komponenty, které potřebujete k vygenerování souboru nastavení publikování. (Pokud místo toho zvolíte Vlastní, zobrazí se seznam součástí, jak je znázorněno na následujícím obrázku.)

   

4. (Volitelné) Ověřte, že je Web Deploy správně spuštěný tím, že otevřete Ovládací panely > Systém a zabezpečení > Nástroje pro správu > Službya pak se ujistěte, že:

   • Služba Web Deployment Agent je spuštěná (název služby se ve starších verzích liší).

   • služba pro správu webu je spuštěná.

   Pokud není spuštěna některá ze služeb agenta, restartujte službu agenta pro nasazení webu .

   Pokud Agent služby nasazení webu vůbec není přítomen, přejděte na Ovládací panely > Programy > Odinstalovat programa vyhledejte Microsoft Web Deploy <ve verzi>. Zvolte Změnit instalaci a ujistěte se, že jste zvolili Bude nainstalován na místní pevný disk pro součásti nasazení webu. Dokončete kroky instalace změn.

Vytvoření souboru nastavení publikování ve službě IIS na Windows Serveru

1. Zavřete a znovu otevřete konzolu pro správu služby IIS a zobrazte aktualizované možnosti konfigurace v uživatelském rozhraní.

2. Ve službě IIS klikněte pravým tlačítkem myši na výchozí web, zvolte Nasazení>Publikování konfigurace nasazení webu.

   

   Pokud nabídku Deploy nevidíte, podívejte se do předchozí části a ověřte, že je nasazení webu spuštěné.

3. V dialogovém okně Konfigurace nasazení a publikování webu zkontrolujte nastavení.

4. Klepněte na tlačítko Nastavení.

   Na panelu Výsledky výstup ukazuje, že zadanému uživateli jsou udělena přístupová práva a že byl vygenerován soubor s příponou .publishsettings v umístění zobrazeném v dialogovém okně.

   <?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>
   

   V závislosti na konfiguraci Windows Serveru a služby IIS se v souboru XML zobrazí různé hodnoty. Tady je několik podrobností o zobrazených hodnotách:

   • Soubor msdeploy.axd odkazovaný v atributu publishUrl je dynamicky vygenerovaný soubor obslužné rutiny HTTP pro nasazení webu. (Pro účely testování http://myhostname:8172 obecně funguje také.)

   • publishUrl port je nastavený na port 8172, což je výchozí nastavení pro nasazení webu.

   • Port destinationAppUrl je nastavený na port 80, což je výchozí hodnota pro službu IIS.

   • Pokud se v pozdějších krocích nemůžete připojit ke vzdálenému hostiteli ze sady Visual Studio pomocí názvu hostitele, otestujte IP adresu serveru místo názvu hostitele.

     Poznámka

     Pokud publikujete službu IIS spuštěnou na virtuálním počítači Azure, musíte ve skupině zabezpečení sítě otevřít příchozí port pro nasazení webu a službu IIS. Podrobné informace najdete v tématu Otevření portů do virtuálního počítače.

5. Zkopírujte tento soubor do počítače, na kterém používáte Visual Studio.

Import nastavení publikování v sadě Visual Studio a nasazení

1. V počítači, na kterém máte otevřený projekt ASP.NET v sadě Visual Studio, klikněte pravým tlačítkem na projekt v Průzkumníku řešení a zvolte Publikovat.

   Pokud jste dříve nakonfigurovali profily publikování, zobrazí se podokno Publikovat. Klikněte na Nový nebo Vytvořit nový profil.

2. Vyberte možnost importu profilu.

   V dialogovém okně Publikovat klepněte na Importovat profil.

   publikování

3. Přejděte do umístění souboru nastavení publikování, který jste vytvořili v předchozí části.

4. V dialogovém okně Importovat soubor nastavení publikování přejděte na profil, který jste vytvořili v předchozí části, a klikněte na Otevřít.

   Kliknutím na Dokončit uložte profil publikování a potom klikněte na Publikovat.

   Visual Studio zahájí proces nasazení a v okně Výstup se zobrazí průběh a výsledky.

   Pokud dojde k chybám nasazení, klikněte na Další akce>Upravit upravit nastavení. Upravte nastavení a kliknutím na Ověřit otestujte nová nastavení. Pokud se název hostitele nenajde, zkuste místo toho použít IP adresu namísto názvu hostitele v polích serveru a cílové URL.

   

Po úspěšném nasazení by se aplikace měla spustit automaticky. Pokud se aplikace po nasazení nespustí, spusťte aplikaci ve službě IIS a ověřte, že běží správně.

Až budete připraveni, přepněte na ladicí konfiguraci.

Důležitý

Pokud se rozhodnete ladit konfiguraci vydané verze, zakážete ladění v souboru web.config při publikování.

1. Chcete-li upravit profil, vyberte Další možnosti>Upravit a pak vyberte Nastavení.
2. Vyberte konfiguraci pro ladění a potom v možnostech Publikování souboru vyberte Odebrat další soubory na cílovém místě.
3. Vyberte Uložit a pak aplikaci znovu publikujte.

Varování

Použití přihlašovacích údajů pro uživatelské jméno a heslo (základní ověřování) není nejbezpečnější metodou ověřování. Kdykoli je to možné, použijte alternativní metody. Zvažte například publikování balíčku ze sady Visual Studio a pak pomocí WebDeploy.exe z příkazového řádku balíček nasaďte. Pomocí této metody můžete pomocí Správce služby IIS nakonfigurovat autorizované uživatele systému Windows, kteří mohou publikovat na webový server, a spustit WebDeploy.exe v rámci daného uživatelského účtu systému Windows. Viz Instalace a konfigurace Web Deploy na serveru IIS 8.0 nebo novější. Pokud používáte přihlašovací údaje pro heslo, nezapomeňte použít silné heslo a zabezpečit heslo před únikem nebo sdílením hesla.

(Volitelné) Nasazení publikováním do místní složky

Tuto možnost můžete použít k nasazení aplikace, pokud chcete aplikaci zkopírovat do služby IIS pomocí PowerShellu, RoboCopy nebo chcete soubory zkopírovat ručně.

Konfigurace webu ASP.NET na počítači s Windows Serverem

1. Otevřete Průzkumníka Windows a vytvořte novou složku C:\Publish, kde později nasadíte projekt ASP.NET.

2. Pokud ještě není otevřený, otevřete Správce služeb IIS (Internetové informační služby). (V levém podokně Správce serveru vyberte IIS . Klikněte pravým tlačítkem na server a vyberte Správce internetové informační služby (IIS).)

3. V části Připojení v levém podokně přejděte na Weby.

4. Vyberte výchozí web, zvolte Základní nastavenía nastavte fyzickou cestu na C:\Publish.

5. Klikněte pravým tlačítkem myši na uzel Výchozího webu a vyberte Přidat aplikaci.

6. Nastavte pole Alias na MyASPApp, přijměte výchozí fond aplikací (DefaultAppPool) a nastavte fyzickou cestu na C:\Publish.

7. V části Připojenívyberte fondy aplikací. Otevřete DefaultAppPool a nastavte pole Fond aplikací na ASP.NET verze 4.0 (ASP.NET 4.5 není pro fond aplikací možnost).

8. Když ve Správci služby IIS vyberete web, zvolte Upravit oprávněnía ujistěte se, že IUSR, IIS_IUSRS nebo uživatel nakonfigurovaný pro fond aplikací je autorizovaným uživatelem s oprávněními ke čtení & a provádění.

   Pokud nevidíte jednoho z těchto uživatelů s přístupem, projděte si postup přidání IUSR jako uživatele s právy Číst & Spustit.

Důležitý

Informace o zabezpečení související s integrovanými účty najdete v tématu Pochopení Built-In uživatelských a skupinových účtů na IIS 7.

Publikování a nasazení aplikace publikováním do místní složky ze sady Visual Studio

Aplikaci můžete také publikovat a nasadit pomocí systému souborů nebo jiných nástrojů.

V případě ASP.NET 4.8 se ujistěte, že soubor web.config obsahuje správnou verzi .NET.

• Pokud cílíte na ASP.NET 4.8, ujistěte se, že je tato hodnota verze uvedená v souboru web.config:

      <system.web>
        <compilation debug="true" targetFramework="4.8" />
        <httpRuntime targetFramework="4.8" />
        <httpModules>
          <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" />
        </httpModules>
      </system.web>
      ```
  
  

• Pokud instalujete ASP.NET 4 místo 4.8, měla by být hodnota verze v souboru web.config zadána jako 4.0.

Při publikování a nasazení aplikace postupujte takto:

1. V Průzkumníku řešeníklikněte pravým tlačítkem na uzel projektu a vyberte Publikovat (pro webové formuláře vyberte Publikovat webovou aplikaci).

   Pokud jste dříve nakonfigurovali profily publikování, zobrazí se podokno Publikovat. Klikněte na Nový profil.

2. V dialogovém okně Publikovat vyberte složku, klikněte na Procházeta vytvořte novou složku C:\Publish.

   

   Kliknutím na Dokončit uložíte publikační profil.

3. Přepněte na konfiguraci ladění.

   Chcete-li upravit profil, zvolte Upravit a pak zvolte Nastavení. Zvolte konfiguraci Ladění a poté v rámci možnosti Publikování souborů vyberte Odebrat další soubory v cíli.

   

   Poznámka

   Pokud používáte release build, při publikování zakážete ladění v souboru web.config.

4. Klikněte na Publikovat.

   Aplikace publikuje konfiguraci Ladění projektu do místní složky. Průběh se zobrazí v okně Výstup.

5. Zkopírujte adresář projektu ASP.NET z počítače sady Visual Studio do místního adresáře nakonfigurovaného pro aplikaci ASP.NET (v tomto příkladu C:\Publish) na počítači s Windows Serverem. V tomto kurzu předpokládáme, že kopírujete ručně, ale můžete použít jiné nástroje, jako je PowerShell, Xcopy nebo Robocopy.

   Opatrnost

   Pokud potřebujete provést změny kódu nebo opětovného sestavení, musíte tento krok znovu publikovat a opakovat. Spustitelný soubor, který jste zkopírovali do vzdáleného počítače, musí přesně odpovídat místnímu zdroji a symbolům. Pokud to neuděláte, zobrazí se v sadě Visual Studio upozornění cannot find or open the PDB file při pokusu o ladění procesu.

6. Na Windows Serveru ověřte, že aplikaci můžete správně spustit tak, že ji otevřete v prohlížeči.

   Pokud se aplikace nespustí správně, může dojít k neshodě mezi verzí ASP.NET nainstalovanou na serveru a počítačem se sadou Visual Studio nebo může dojít k problému s konfigurací služby IIS nebo webu. Znovu zkontrolujte předchozí kroky.

Stažení a instalace vzdálených nástrojů na Windows Serveru

Stáhněte si verzi vzdálených nástrojů, která odpovídá vaší verzi sady Visual Studio.

Na vzdáleném zařízení nebo serveru, na který chcete ladit, a ne na počítači se sadou Visual Studio, stáhněte a nainstalujte správnou verzi vzdálených nástrojů z odkazů v následující tabulce.

• Stáhněte si nejnovější aktualizaci vzdálených nástrojů pro vaši verzi sady Visual Studio. Starší verze vzdálených nástrojů nejsou kompatibilní s novějšími verzemi sady Visual Studio. (Pokud například používáte Visual Studio 2019, stáhněte si nejnovější aktualizaci vzdálených nástrojů pro Visual Studio 2019. V tomto scénáři nestahujte vzdálené nástroje pro Visual Studio 2022.)
• Stáhněte si vzdálené nástroje se stejnou architekturou jako počítač, na který je instalujete. Pokud například chcete ladit aplikace x86 na vzdáleném počítači s operačním systémem x64, nainstalujte vzdálené nástroje x64. Pokud chcete ladit aplikace x86, ARM nebo x64 v operačním systému ARM64, nainstalujte vzdálené nástroje ARM64.

Verze	Odkaz	Poznámky
Visual Studio 2022	vzdálených nástrojů	Kompatibilní se všemi verzemi sady Visual Studio 2022. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru naleznete v části Odblokování stahování souboru informace o tom, jak stahovat vzdálené nástroje.
Visual Studio 2019	Vzdálené nástroje	Nástroje pro vzdálenou správu ve Visual Studio 2019 jsou k dispozici na "My.VisualStudio.com". Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích systému Windows Server si přečtěte sekci Odblokování stahování souborů pro nápovědu o stahování vzdálených nástrojů.
Visual Studio 2017	Vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2017 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se do bezplatného programu Visual Studio Dev Essentials nebo se přihlaste pomocí ID vašeho předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve Windows Serveru se podívejte na Odblokování stahování souboru pro nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2015	vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2015 jsou k dispozici v My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí Visual Studio předplatného ID. Na Windows Serveru najdete Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2013	Vzdálené nástroje	Stránka ke stažení v dokumentaci k sadě Visual Studio 2013
Visual Studio 2012	Vzdálené nástroje	Stránka ke stažení v dokumentaci k sadě Visual Studio 2012

Vzdálený ladicí program můžete spustit zkopírováním msvsmon.exe do vzdáleného počítače, nikoli instalací vzdálených nástrojů. Průvodce konfigurací vzdáleného ladicího programu (rdbgwiz.exe) je však k dispozici pouze při instalaci vzdálených nástrojů. Pokud chcete spustit vzdálený ladicí program jako službu, možná budete muset použít průvodce pro konfiguraci. Další informace naleznete v tématu (volitelně) Konfigurace vzdáleného debuggeru jako služby.

Poznámka

• Pokud chcete ladit aplikace pro Windows 10 nebo novější na zařízeních ARM, použijte ARM64, který je k dispozici s nejnovější verzí vzdálených nástrojů.
• Pokud chcete ladit aplikace pro Windows 10 na zařízeních s Windows RT, použijte ARM, který je dostupný jenom ve stažení vzdálených nástrojů sady Visual Studio 2015.
• Pokud chcete ladit aplikace x64 v operačním systému ARM64, spusťte msvsmon.exe x64 nainstalované se vzdálenými nástroji ARM64.

Nastavení vzdáleného ladicího programu na Windows Serveru

1. Na vzdáleném počítači vyhledejte a spusťte vzdálený ladicí program z nabídky Start.

   Pokud nemáte oprávnění správce na vzdáleném počítači, klikněte pravým tlačítkem myši na aplikaci vzdáleného ladicího programu a vyberte Spustit jako správce. V opačném případě ho jednoduše zahajte normálně.

   Pokud se chystáte připojit k procesu, který běží jako správce nebo běží pod jiným uživatelským účtem (například IIS), klikněte pravým tlačítkem na aplikaci Remote Debugger a vyberte Spustit jako správce. Další informace naleznete v tématu Spuštění vzdáleného ladicího programu jako správce.

2. Při prvním spuštění vzdáleného ladicího programu (nebo před jeho nakonfigurováním) se zobrazí průvodce konfigurace vzdáleného ladění.

   Ve většině scénářů zvolte Další, dokud se nedostanete na stránku průvodce Konfigurovat bránu Windows Firewall.

   

3. Vyberte aspoň jeden typ sítě, na který chcete používat vzdálené nástroje. Pokud jsou počítače připojené přes doménu, musíte zvolit první položku. Pokud jsou počítače připojené přes pracovní skupinu nebo domácí skupinu, podle potřeby zvolte druhou nebo třetí položku.

   Potom vyberte Dokončit a spusťte vzdálený ladicí program.

4. Po dokončení konfigurace se zobrazí okno vzdáleného debuggeru.

   

   Vzdálený ladicí program teď čeká na připojení. K nastavení konfigurace vzdáleného připojení v sadě Visual Studio použijte název serveru a číslo portu.

Pokud chcete vzdálený ladicí program zastavit, vyberte Soubor>Ukončit. Můžete ho restartovat z nabídky Start nebo z příkazového řádku:

<Remote debugger installation directory>\msvsmon.exe

Poznámka

Pokud potřebujete přidat oprávnění pro další uživatele, změnit režim ověřování nebo číslo portu vzdáleného ladicího programu, přečtěte si téma Konfigurace vzdáleného ladicího programu.

Informace o spuštění vzdáleného ladicího programu jako služby najdete v tématu Spuštění vzdáleného ladicího programu jako služby.

Připojení k aplikaci ASP.NET z počítače sady Visual Studio

Počínaje sadou Visual Studio 2022 verze 17.10 Preview 2 se změnilo dialogové okno Připojit k procesu. Pokud potřebujete pokyny, které odpovídají staršímu dialogovému oknu, přepněte do zobrazení sady Visual Studio 2019 (selektor verze vlevo nahoře v článku).

1. Na počítači se sadou Visual Studio otevřete řešení, které se pokoušíte ladit (MyASPApp, pokud postupujete podle všech kroků v tomto článku).

2. V sadě Visual Studio vyberte: > Připojit k procesu (Ctrl + Alt + P).

   Rada

   Ve Visual Studio 2017 a novějších verzích se můžete znovu připojit ke stejnému procesu, ke kterému jste se dříve připojili, pomocí Ladění > Znovu připojit k procesu... (Shift + Alt + P).

3. Nastavte typ připojení na Vzdálené (Windows).

   Zobrazí se volba Cíl připojení .

   Nastavte cíl připojení na <název vzdáleného počítače> a stiskněte Enter.

   Ověřte, že Visual Studio přidá požadovaný port do názvu počítače, který se zobrazí ve formátu: <název vzdáleného počítače>:port

   Ve Visual Studio 2022 by se měl zobrazit název vzdáleného počítače <>: 4026

   Port je povinný. Pokud číslo portu nevidíte, přidejte ho ručně.

4. Vyberte Aktualizovat.

   Některé procesy by se měly zobrazit v okně Dostupné procesy.

   Pokud nevidíte žádné procesy, zkuste místo názvu vzdáleného počítače použít IP adresu (port je povinný). K získání adresy IPv4 můžete použít ipconfig na příkazovém řádku.

   Pokud chcete použít tlačítko Najít, možná budete muset na serveru otevřít odchozí port UDP 3702.

5. Zkontrolujte, zda se zobrazují procesy od všech uživatelů.

6. Zadejte první písmeno názvu procesu, abyste rychle našli w3wp.exe pro ASP.NET 4.5.

   Pokud se zobrazuje více procesů w3wp.exe, zkontrolujte sloupec Uživatelské jméno. V některých scénářích se ve sloupci Uživatelské jméno zobrazuje název fondu aplikací, například IIS APPPOOL\DefaultAppPool. Pokud se zobrazí fond aplikací, je snadný způsob, jak identifikovat správný proces, vytvořit nový pojmenovaný fond aplikací pro instanci aplikace, kterou chcete ladit, a pak ho snadno najít ve sloupci Uživatelské jméno.

   

7. Vyberte Připojit.

8. Otevřete web vzdáleného počítače. V prohlížeči přejděte na http://<název vzdáleného počítače>.

   Měla by se zobrazit webová stránka ASP.NET.

9. Ve spuštěné aplikaci ASP.NET vyberte odkaz na stránku Ochrana osobních údajů.

   Bod přerušení by měl být dosažen v sadě Visual Studio.

   Pokud se vám nedaří připojit nebo nastavit bod přerušení, přečtěte si Řešení potíží se vzdáleným laděním.

Řešení potíží s nasazením služby IIS

• Pokud se nemůžete připojit k hostiteli pomocí názvu hostitele, zkuste místo toho IP adresu.
• Ujistěte se, že jsou na vzdáleném serveru otevřené požadované porty.
• Ověřte, že verze ASP.NET použitá v aplikaci je stejná jako verze, kterou jste nainstalovali na server. Pro aplikaci můžete zobrazit a nastavit verzi na stránce Vlastnosti. Pokud chcete aplikaci nastavit na jinou verzi, musí být tato verze nainstalovaná.
• Pokud se aplikace pokusila otevřít, ale zobrazí se upozornění na certifikát, zvolte důvěryhodnost webu. Pokud jste upozornění už zavřeli, můžete upravit profil publikování, soubor *.pubxml v projektu a přidat následující prvek (pouze pro testování): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Po nasazení spusťte aplikaci ve službě IIS a otestujte, že je správně nasazená.
• V okně Výstup v sadě Visual Studio vyhledejte informace o stavu a zkontrolujte chybové zprávy.

Otevření požadovaných portů na Windows Serveru

Ve většině nastavení jsou požadované porty otevřeny instalací ASP.NET a vzdáleného ladicího programu. Možná ale budete muset ověřit, že jsou otevřené porty.

Poznámka

Na virtuálním počítači Azure musíte otevřít porty prostřednictvím skupiny zabezpečení sítě .

Požadované porty:

• 80: Požadováno pro službu IIS.

• 4026: Požadováno pro vzdálené ladění ze sady Visual Studio 2022 (viz Přiřazení portů vzdáleného ladicího programu pro více informací).

• 4024: Požadováno pro vzdálené ladění ze sady Visual Studio 2019 (další informace najdete v tématu Přiřazení portů vzdáleného ladicího programu).

• UDP 3702: (Volitelný) Port zjišťování umožňuje použít tlačítko Najít při připojování ke vzdálenému ladicímu programu v sadě Visual Studio.

Kromě toho by tyto porty už měly být otevřeny instalací ASP.NET:

• 8172: (Volitelné) Povinné pro použití Web Deploy k nasazení aplikace ze sady Visual Studio.

Otevření portu

1. Pokud chcete otevřít port na Windows Serveru, otevřete nabídku Start, vyhledejte Firewall Windows Defender nebo Windows Firewall s pokročilým zabezpečením.

   Pro Windows Defender Firewallzvolte Upřesněné nastavení.

2. Pak zvolte Příchozí pravidla > Nové pravidlo > Port. Zvolte Další a v části Konkrétní místní porty, zadejte číslo portu, vyberte Další, pak Povolit připojení, vyberte Další a přidejte název (IIS, Web Deploynebo msvsmon) pro příchozí pravidlo.

   Pokud chcete další podrobnosti o konfiguraci brány Windows Firewall, přečtěte si téma Konfigurace brány Windows Firewall pro vzdálené ladění.

3. Vytvořte další pravidla pro ostatní požadované porty.