Vzdálené ladění

můžete ladit aplikaci Visual Studio, která byla nasazena v jiném počítači. k tomu slouží Visual Studio vzdálený ladicí program.

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

Scenario Odkaz
Azure App Service vzdálené ladění ASP.NET v Azure nebo pro Visual Studio Enterprise Snapshot Debugger
Virtuální počítač Azure Vzdálené ladění ASP.NET ve službě Azure
Azure Service Fabric ladění aplikace Service Fabric Azure
ASP.NET vzdálené ladění ASP.NET Core nebo vzdálené ladění ASP.NET
C# nebo Visual Basic Vzdálené ladění projektu v jazyce C# nebo Visual Basic
C++ Vzdálené ladění projektu v jazyce C++
aplikace Universal Windows (UWP) Spouštění aplikací pro UWP na vzdáleném počítači nebo ladění nainstalovaného balíčku aplikace

Pokud chcete 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 nástrojů Remote Tools

Na vzdáleném zařízení nebo serveru, na které chcete ladit, místo počítače 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ší vzdálené nástroje pro vaši verzi Visual Studio. Nejnovější verze vzdálených nástrojů je kompatibilní se staršími Visual Studio verzemi, ale starší verze vzdálených nástrojů nejsou kompatibilní s novějšími Visual Studio verzemi. (Pokud například používáte verzi Visual Studio 2017, stáhněte si nejnovější aktualizaci vzdálených nástrojů pro Visual Studio 2017. V tomto scénáři nestáhněte vzdálené nástroje pro Visual Studio 2019.)
  • Stáhněte si vzdálené nástroje se stejnou architekturou jako počítač, na který je instalujete. Pokud například chcete ladit 32bitovou aplikaci na vzdáleném počítači s 64bitovým operačním systémem, nainstalujte 64bitové vzdálené nástroje.
Verze Odkaz Poznámky
Visual Studio 2022 Vzdálené nástroje Kompatibilní se všemi Visual Studio verzemi 2022. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů.
Visual Studio 2019 Vzdálené nástroje Kompatibilní se všemi Visual Studio verzemi 2019. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů.
Visual Studio 2017 Vzdálené nástroje Kompatibilní se všemi Visual Studio verzemi 2017. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů.
Visual Studio 2015 Vzdálené nástroje Vzdálené nástroje pro Visual Studio 2015 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému Visual Studio Dev Essentials programu nebo se přihlaste pomocí ID Visual Studio předplatného. V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů.
Visual Studio 2013 Vzdálené nástroje Stránka pro stažení v Visual Studio 2013 dokumentaci
Visual Studio 2012 Vzdálené nástroje Stránka ke stažení v Visual Studio 2012
Verze Odkaz Poznámky
Visual Studio 2019 Vzdálené nástroje Kompatibilní se všemi Visual Studio verzemi 2019. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů. Nejnovější verzi vzdálených nástrojů otevřete v dokumentu Visual Studio 2022.
Visual Studio 2017 Vzdálené nástroje Kompatibilní se všemi Visual Studio verzemi 2017. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů.
Visual Studio 2015 Vzdálené nástroje Vzdálené nástroje pro Visual Studio 2015 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému Visual Studio Dev Essentials programu nebo se přihlaste pomocí ID Visual Studio předplatného. V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů.
Visual Studio 2013 Vzdálené nástroje Stránka pro stažení v Visual Studio 2013 dokumentaci
Visual Studio 2012 Vzdálené nástroje Stránka ke stažení v Visual Studio 2012
Verze Odkaz Poznámky
Visual Studio 2017 Vzdálené nástroje Kompatibilní se všemi Visual Studio verzemi 2017. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 nebo ARM64). V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů. Nejnovější verzi vzdálených nástrojů otevřete v dokumentu Visual Studio 2019.
Visual Studio 2015 Vzdálené nástroje Vzdálené nástroje pro Visual Studio 2015 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému Visual Studio Dev Essentials programu nebo se přihlaste pomocí ID Visual Studio předplatného. V Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v tématu Odblokování stahování souborů.
Visual Studio 2013 Vzdálené nástroje Stránka pro stažení v Visual Studio 2013 dokumentaci
Visual Studio 2012 Vzdálené nástroje Stránka ke stažení v Visual Studio 2012

Vzdálený ladicí program můžete spustit zkopírováním msvsmon.exedo vzdáleného počítače místo instalace 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, budete možná muset použít průvodce pro konfiguraci. Další informace najdete v tématu (Volitelné) Konfigurace vzdáleného ladicího programu jako služby.

Poznámka

  • K ladění Windows 10 na zařízeních ARM použijte ARM64, který je k dispozici s nejnovější verzí vzdálených nástrojů.
  • Pokud chcete Windows 10 aplikace na Windows RT, použijte ARM, který je k dispozici pouze ve vzdáleném Visual Studio 2015 ke stažení.

Požadavků

Podporované operační systémy

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

  • 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

Poznámka

Windows Phone vyžaduje připojení USB k ladění (nevyžaduje vzdálené nástroje).

Podporované konfigurace hardwaru

  • Procesor 1,6 GHz nebo rychlejší

  • 1 GB paměti RAM (1,5 GB při spouštění ve virtuálním počítači)

  • 1 GB volného místa na disku

    1. pevný disk na úrovni ot./min.
  • Grafická karta s rozhraním DirectX 9 a rozlišením 1024 × 768 nebo vyšším

Konfigurace sítě

vzdálený počítač a Visual Studio počítač musí být připojeni přes síť, pracovní skupinu nebo domácí skupinu nebo jinak připojeni přímo přes kabel Ethernet. Ladění mezi dvěma počítači připojenými prostřednictvím proxy serveru není podporováno. Ladění přes vysokou latenci nebo připojení s nízkou šířkou pásma, jako je například telefonické připojení k Internetu nebo přes Internet v zemích, se nedoporučuje a může být neúspěšné nebo nepřijatelně pomalé.

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

vzdálený ladicí program (msvsmon.exe) můžete najít na počítači s Visual Studio Community, Professional nebo Enterprise už je nainstalovaný. V některých scénářích nejjednodušší způsob, jak nastavit vzdálené ladění, je spuštění vzdáleného ladicího programu (msvsmon.exe) ze sdílené složky. Omezení použití najdete na stránce s nápovědu pro vzdálený ladicí program (nápovědu > používání ve vzdáleném ladicím programu).

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

    programové soubory \ Microsoft Visual Studio \ 2022 \ Enterprise \Common7\IDE\Remote Debugger\x64\msvsmon.exe

    programové soubory \ Microsoft Visual Studio \ 2022 \ Enterprise \Common7\IDE\Remote Debugger\x86\msvsmon.exe

    Program Files (x86) \ Microsoft Visual Studio \ 2019 \ Enterprise \Common7\IDE\Remote Debugger\x64\msvsmon.exe

    Program Files (x86) \ Microsoft Visual Studio \ 2019 \ Enterprise \Common7\IDE\Remote Debugger\x86\msvsmon.exe

    Program Files (x86) \ Microsoft Visual Studio \ 2017 \ Enterprise \Common7\IDE\Remote Debugger\x86\msvsmon.exe

    Program Files (x86) \ Microsoft Visual Studio \ 2017 \ Enterprise \Common7\IDE\Remote Debugger\x64\msvsmon.exe

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

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

Tip

informace o instalaci příkazového řádku a příkazového řádku najdete na stránce s nápovědu pro msvsmon.exe zadáním msvsmon.exe /? do příkazového řádku na počítači s nainstalovaným Visual Studioem (nebo přejděte na nápovědu > použití ve vzdáleném ladicím programu).

Nastavení vzdáleného ladicího programu

  1. Ve vzdáleném počítači Najděte 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 na aplikaci vzdáleného ladicího programu a vyberte Spustit jako správce. Jinak ho stačí spustit normálně.

    Pokud plánujete připojení k procesu, který je spuštěný jako správce nebo je spuštěný pod jiným uživatelským účtem (například IIS), klikněte pravým tlačítkem na aplikaci vzdáleného ladicího programu a vyberte Spustit jako správce. Další informace najdete 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í dialogové okno Konfigurace vzdáleného ladění .

    Konfigurace vzdáleného ladicího programu

  3. pokud není nainstalováno rozhraní API služby Windows Web Services, ke kterému dochází pouze v Windows serveru 2008 R2, vyberte tlačítko instalovat .

  4. Vyberte alespoň jeden typ sítě, na kterém chcete používat nástroje Remote Tools. 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 vyberte druhou nebo třetí položku.

  5. Vyberte Konfigurovat vzdálené ladění a nakonfigurujte bránu firewall a spusťte vzdálený ladicí program.

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

    Okno vzdáleného ladicího programu

    Vzdálený ladicí program nyní čeká na připojení. Použijte název serveru a číslo portu, které se zobrazí, chcete-li nastavit konfiguraci vzdáleného připojení v Visual Studio.

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

<Remote debugger installation directory>\msvsmon.exe

Konfigurace vzdáleného ladicího programu

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í ostatním uživatelům pro připojení ke vzdálenému ladicímu programu, vyberte nástroje > oprávnění. K udělení nebo odebrání oprávnění je potřeba mít oprávnění správce.

    Důležité

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

    Alternativně můžete spustit vzdálený ladicí program z příkazového řádku s parametrem /Allow <username> : msvsmon/Allow <username@computer>.

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

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

    Upozornění

    Můžete také spustit nástroje Remote Tools v režimu bez ověřování, ale tento režim se rozhodně nedoporučuje. Při spuštění v tomto režimu není žádné zabezpečení sítě. Režim bez ověřování vyberte pouze v případě, že jste si jistí, že síť není ohrožena škodlivým nebo nepřátelským provozem.

Volitelné Konfigurace vzdáleného ladicího programu jako služby

pro ladění v ASP.NET a další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í program jako službu, postupujte podle těchto kroků.

  1. Najděte Průvodce konfigurací vzdáleného ladicího programu (rdbgwiz.exe). (Jedná se o samostatnou aplikaci ze vzdáleného ladicího programu.) Je k dispozici pouze při instalaci nástrojů Remote Tools. Není nainstalován s Visual Studio.

  2. Začněte s Průvodcem konfigurací. Jakmile se zobrazí první stránka, klikněte na tlačítko Další.

  3. zaškrtněte políčko spustit vzdálený ladicí program Visual Studio 2015 jako službu .

  4. Přidejte název uživatelského účtu a hesla.

    K tomuto účtu možná budete muset přidat uživatelské právo Přihlásit se jako služba (na úvodní stránce nebo v okně zadejte příkaz secpol na příkazovém řádku). Po zobrazení okna poklikejte na přiřazení uživatelských práv a pak v pravém podokně vyhledejte možnost Přihlásit se jako služba . Poklikejte na ni. Přidejte uživatelský účet do okna vlastnosti a klikněte na tlačítko OK). Klikněte na Next (Další).

  5. Vyberte typ sítě, se kterou mají nástroje Remote Tools 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 Next (Další).

  6. pokud je možné službu spustit, uvidíte, že jste úspěšně dokončili průvodce konfigurací Visual Studio Remote Debugger. pokud službu spustit nemůžete, zobrazí se neúspěšné dokončení průvodce konfigurací Visual Studio Remote Debugger. Stránka také obsahuje několik tipů, které vám pomohou postupovat při spuštění služby.

  7. Klikněte na Finish (Dokončit).

    V tomto okamžiku je vzdálený ladicí program spuštěn jako služba. to můžete ověřit tak, že v ovládacích panelech > služby a vyhledáte vzdálený ladicí program Visual Studio 2015.

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

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

měli byste být schopni ladit kód pomocí symbolů, které vygenerujete na Visual Studio počítači. Výkon vzdáleného ladicího programu je mnohem lepší při použití místních symbolů. Pokud je nutné použít vzdálené symboly, je nutné oznámit sledování vzdáleného ladění, aby vyhledalo symboly na vzdáleném počítači.

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

Další informace naleznete v nápovědě pro vzdálené ladění (stiskněte klávesu F1 v okně vzdáleného ladicího programu, nebo klikněte na tlačítko Nápověda > používání). v Visual Studio 2012 a 2013 můžete najít další informace o změnách vzdáleného načítání symbolů technologie .net .

Viz také