Vzdálené ladění

Můžete ladit aplikaci sady Visual Studio, která byla nasazena na jiném počítači. K tomu použijete vzdálený ladicí program sady Visual Studio.

Podrobné pokyny ke vzdálenému ladění najdete v těchto tématech.

Scénář	Odkaz
C# nebo Visual Basic	vzdálené ladění projektu jazyka C# nebo Visual Basic
C++	vzdálené ladění projektu v jazyce C++
Azure App Service	vzdálené ladění ASP.NET Core v Azure nebo v případě sady Visual Studio Enterprise Snapshot Debugger
ASP.NET	Vzdálené ladění ASP.NET Core nebo vzdálené ladění ASP.NET
Virtuální počítač Azure	vzdálené ladění ASP.NET na virtuálním počítači Azure
Linux	Ladění .NET Core v Linuxu pomocí SSH připojením k procesu
Docker	Připojení k procesu spuštěného v kontejneru Dockeru
Univerzální aplikace pro Windows (UPW)	Spuštění aplikací pro UPW na vzdáleném počítači nebo Ladění nainstalovaného balíčku aplikace

Pokud chcete jenom stáhnout a nainstalovat vzdálený ladicí program a nepotřebujete žádné další pokyny pro váš scénář, postupujte podle kroků v tomto článku.

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

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é nástroje	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 se podívejte na Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2019	Vzdálené nástroje	Nástroje pro vzdálený přístup ve Visual Studio 2019 jsou dostupné na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatné programu Visual Studio Dev Essentials nebo se přihlaste pomocí ID předplatného sady 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 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 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 k bezplatné programu Visual Studio Dev Essentials nebo se přihlaste pomocí ID předplatného sady Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na Windows Serveru najdete informace Odblokování stahování souboru 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í předplatného ID Visual Studio. Na Windows Server podívejte se na Odblokování stahování souboru pro pomoc s 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ých nástrojů	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 ladění 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.

Požadavky

Podporované operační systémy

Na vzdáleném počítači musí být spuštěný jeden z následujících operačních systémů:

• Windows 11

• Windows 10 (ne telefon)

• Windows 8 nebo 8.1 (ne telefon)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 nebo Windows Server 2012 R2

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

Podporované konfigurace hardwaru

• Procesor 1,6 GHz nebo rychlejší

• 1 GB paměti RAM (1,5 GB, pokud běží na virtuálním počítači)

• 1 GB volného místa na pevném disku

• Pevný disk s 5400 RPM

• Grafická karta s rozhraním DirectX 9 běžící na rozlišení 1024 x 768 nebo vyšší

Konfigurace sítě

Vzdálený počítač a počítač sady Visual Studio musí být připojené přes síť, pracovní skupinu nebo domácí skupinu nebo musí být připojené přímo přes ethernetový kabel. Odlaďování mezi dvěma počítači připojenými přes proxy server není podporováno. Ladění přes připojení s vysokou latencí nebo nízkou šířkou pásma, jako je například vytáčené připojení k Internetu, nebo přes Internet mezi různými zeměmi či regiony, se nedoporučuje a může selhat nebo být nepřijatelně pomalé.

(Volitelné) Spuštění vzdáleného ladicího programu ze sdílené složky

Vzdálený ladicí program (msvsmon.exe) najdete na počítači s nainstalovanou sadou Visual Studio Community, Professional nebo Enterprise. V některých scénářích je nejjednodušším způsobem, jak nastavit vzdálené ladění, spustit vzdálený ladicí program (msvsmon.exe) ze sdílené složky. Informace o omezeních použití najdete na stránce nápovědy vzdáleného ladicího programu (nápověda > využití vzdáleného ladicího programu).

1. Vyhledejte msvsmon.exe v adresáři, který odpovídá vaší verzi sady Visual Studio:

   \Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exeprogramových souborů

   \Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exeprogramových souborů

2. Nasdílejte složku vzdáleného ladicího programu na počítači s Visual Studiem.

3. Na vzdáleném počítači spusťte msvsmon.exe ze sdílené složky. Postupujte podle pokynů k nastavení .

Spropitné

Informace o instalaci příkazového řádku a odkaz na příkazový řádek najdete na stránce nápovědy pro msvsmon.exe zadáním msvsmon.exe /? do příkazového řádku v počítači s nainstalovanou sadou Visual Studio (nebo přejděte na Nápovědu > Používání ve vzdáleném ladicím programu).

Nastavte vzdálený ladicí program

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 Spusťte vzdálený ladicí nástroj 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.

   Dále vyberte možnost Dokončit pro spuštění vzdáleného debuggeru.

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

   

   Vzdálený ladicí program nyní č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

Nakonfigurujte vzdálený ladicí program

Po prvním spuštění můžete změnit některé aspekty konfigurace vzdáleného ladicího programu.

• Pokud potřebujete přidat oprávnění pro připojení jiných uživatelů ke vzdálenému ladicímu programu, zvolte Nástroje > Oprávnění. Abyste mohli udělit nebo odepřít oprávnění, musíte mít oprávnění správce.

  Důležitý

  Vzdálený ladicí program můžete spustit pod uživatelským účtem, který se liší od uživatelského účtu, který používáte na počítači sady Visual Studio, ale musíte přidat jiný uživatelský účet do oprávnění vzdáleného ladicího programu.

  Případně můžete spustit vzdálený ladicí program z příkazového řádku pomocí parametru /allow <uživatelské jméno>: msvsmon /allow <username@computer>.

• Pokud potřebujete změnit režim ověřování nebo číslo portu nebo zadat hodnotu časového limitu pro vzdálené nástroje: zvolte Nástroje > Možnosti.

  Seznam čísel portů používaných ve výchozím nastavení najdete v tématu Přiřazení portů vzdáleného ladicího programu.

  Varování

  Vzdálené nástroje můžete spouštět v režimu bez ověřování, ale tento režim se důrazně nedoporučuje. V tomto režimu není k dispozici žádné zabezpečení sítě, když jej používáte. Režim Bez ověřování zvolte jenom v případě, že máte jistotu, že síť není ohrožená škodlivým nebo nepřátelským provozem.

Konfigurace sady Visual Studio pro vzdálené ladění

Podrobné pokyny pro připojení k aplikaci ze sady Visual Studio najdete v odkazech souvisejících s vaším konkrétním scénářem na začátku tohoto článku.

Některé scénáře vyžadují použití funkce Připojit k procesu pro připojení ke vzdálené aplikaci, která je už spuštěná. Pro aplikace .NET Core, .NET 5+, .NET Framework a C++ však můžete spustit vzdálenou aplikaci ze sady Visual Studio konfigurací vlastností projektu a spuštěním ladicího programu. Další informace naleznete v tématu Vzdálené ladění projektu jazyka C# nebo Visual Basic nebo vzdálené ladění projektu jazyka C++.

Můžete také vzdáleně ladit spustitelný soubor, který není součástí projektu sady Visual Studio, i když podporované funkce ladění závisí na konfiguraci, jako je dostupnost symbolů. Další informace najdete v tématu Ladění aplikace, která není součástí řešení sady Visual Studio.

(Volitelné) Konfigurujte vzdálený ladicí program jako službu

Pro ladění v prostředích ASP.NET a jiných serverových prostředích musíte buď spustit vzdálený ladicí program jako správce, nebo pokud chcete, aby byl vždy spuštěný, spusťte vzdálený ladicí program jako službu.

Pokud chcete nakonfigurovat vzdálený ladicí nástroj jako službu, postupujte takto.

1. Vyhledejte průvodce konfigurací vzdáleného ladicího programu (rdbgwiz.exe). (Toto je samostatná aplikace od vzdáleného ladicího programu.) Je k dispozici pouze při instalaci vzdálených nástrojů. Není nainstalovaný se sadou Visual Studio.

2. Spusťte průvodce konfigurací. Až se zobrazí první stránka, klikněte na Další.

3. Zaškrtněte políčko Spustit vzdálený ladicí program sady Visual Studio jako službu.

4. Přidejte jméno uživatelského účtu a hesla.

   K tomuto účtu možná budete muset přidat uživatelské oprávnění Přihlásit se jako službu (Najděte Místní zásady zabezpečení (secpol.msc) na stránce nebo v okně Start, nebo zadejte secpol na příkazovém řádku). Po zobrazení okna poklepte na Přiřazení uživatelských práva v pravém podokně vyhledejte Přihlásit jako službu. Poklikejte na něj. Přidejte uživatelský účet do okna vlastnosti a klikněte na OK). Klikněte na Další.

5. Vyberte typ sítě, se kterou mají vzdálené nástroje komunikovat. Musí být vybrán alespoň jeden typ sítě. Pokud jsou počítače připojené přes doménu, měli byste zvolit první položku. Pokud jsou počítače připojené přes pracovní skupinu nebo domácí skupinu, měli byste zvolit druhou nebo třetí položku. Klikněte na Další.

6. Pokud je možné službu spustit, zobrazí se Úspěšně jste dokončili Průvodce konfigurací vzdáleného ladicího programu sady Visual Studio. Pokud službu nejde spustit, zobrazí se Nepodařilo se dokončit Průvodce konfigurací vzdáleného ladicího programu sady Visual Studio. Na stránce najdete také několik tipů, jak službu spustit.

7. Klikněte na Dokončit.

   V tuto chvíli běží vzdálený ladicí program jako služba. Můžete to ověřit tak, že přejdete na Ovládací panely > Služby a vyhledáte Visual Studio Remote Debugger.

   Službu vzdáleného ladicího programu můžete zastavit a spustit z Ovládacích panelů > Services.

Nastavení ladění pomocí vzdálených symbolů

Měli byste být schopni ladit kód pomocí symbolů, které vygenerujete na počítači se sadou Visual Studio. Výkon vzdáleného ladicího programu je mnohem lepší, když používáte lokální symboly. Pokud potřebujete použít vzdálené symboly, je třeba informovat monitor vzdáleného ladění, aby symboly hledal na vzdáleném počítači.

K použití vzdálených symbolů pro spravovaný kód můžete použít následující přepínač příkazového řádku msvsmon: Msvsmon /FallbackLoadRemoteManagedPdbs

Další informace naleznete v nápovědě pro vzdálené ladění (stiskněte F1 v okně vzdáleného ladicího programu nebo klikněte na tlačítko Nápověda > Využití).

Související obsah

• Nejprve se podívejte na ladicí program
• Konfigurace brány Windows Firewall pro vzdálené ladění
• Přiřazení Portů Vzdáleného Ladicího Programu
• Vzdálené ladění ASP.NET Core na vzdáleném počítači služby IIS
• Chyby při vzdáleném odstraňování chyb a řešení potíží