Zdalne debugowanie ASP.NET na zdalnym serwerze IIS

Aby debugować aplikację ASP.NET, która została wdrożona w usługach IIS, zainstaluj i uruchom narzędzia zdalne na komputerze, na którym wdrożono aplikację, a następnie dołącz ją do uruchomionej aplikacji z programu Visual Studio.

W tym przewodniku wyjaśniono, jak utworzyć i skonfigurować aplikację Visual Studio ASP.NET MVC 4.8, wdrożyć ją w Internet Information Services i podłączyć zdalny debuger w programie Visual Studio.

Uwaga / Notatka

Aby zdalnie debugować ASP.NET Core, zobacz Zdalne debugowanie ASP.NET Core na komputerze z IIS. W przypadku usługi Azure App Service zobacz zdalne debugowanie ASP.NET Core na platformie Azure lub, w przypadku Visual Studio Enterprise, użyj Snapshot Debugger (wymagany jest .NET 4.6.1).

Wymagania wstępne

Do wykonania kroków przedstawionych w tym artykule jest wymagany program Visual Studio 2019 lub nowsza wersja.

Te procedury zostały przetestowane w tych konfiguracjach serwera:

• Windows Server 2022 i IIS 10
• Windows Server 2012 R2 i IIS 8 (w przypadku systemu Windows Server 2008 R2 kroki serwera są różne)

Wymagania dotyczące sieci

Zdalny debuger jest obsługiwany w systemie Windows Server, począwszy od systemu Windows Server 2008 z dodatkiem Service Pack 2. Aby uzyskać pełną listę wymagań, zobacz wymagania .

Uwaga / Notatka

Debugowanie między dwoma komputerami połączonymi za pośrednictwem serwera proxy nie jest obsługiwane. Debugowanie przy wysokim opóźnieniu lub przy połączeniu o niskiej przepustowości, takim jak połączenie telefoniczne z Internetem, lub przez Internet między różnymi krajami/regionami, nie jest zalecane i może zakończyć się niepowodzeniem lub być niedopuszczalnie wolnym.

Aplikacja już uruchomiona w usługach IIS?

Ten artykuł zawiera kroki konfigurowania podstawowej konfiguracji usług IIS na serwerze z systemem Windows i wdrażania aplikacji z poziomu programu Visual Studio. Te kroki są zawarte, aby upewnić się, że serwer ma zainstalowane wymagane składniki, że aplikacja może działać poprawnie i że wszystko jest gotowe do zdalnego debugowania.

• Jeśli aplikacja jest uruchomiona w usługach IIS i chcesz pobrać debuger zdalny i rozpocząć debugowanie, przejdź do Pobierz i Zainstaluj narzędzia zdalne w systemie Windows Server.

• Jeśli potrzebujesz pomocy w zapewnieniu, że aplikacja została skonfigurowana, wdrożona i uruchomiona poprawnie w usługach IIS, aby umożliwić debugowanie, wykonaj wszystkie kroki opisane w tym artykule.

Tworzenie aplikacji ASP.NET 4.8 na komputerze programu Visual Studio

1. Utwórz nową aplikację ASP.NET MVC.

   W programie Visual Studio wybierz pozycję Plik>okno uruchamiania, aby otworzyć okno startowe, a następnie wybierz pozycję Utwórz nowy projekt. W polu wyszukiwania wpisz asp.net framework, a następnie wybierz pozycję ASP.NET Web Application (.NET Framework). W wyświetlonym oknie dialogowym nadaj projektowi nazwę MyASPApp, wybierz pozycję ASP.NET Framework 4.8, a następnie wybierz pozycję Utwórz.

   Wybierz pozycję MVC i wybierz pozycję Utwórz.

2. Otwórz plik HomeController.cs w folderze Controllers i ustaw punkt przerwania w instrukcji return View; w metodzie Privacy.

   W starszych szablonach otwórz plik Privacy.cshtml.cs i ustaw punkt przerwania w metodzie OnGet.

Instalowanie i konfigurowanie usług IIS w systemie Windows Server

Te kroki pokazują tylko podstawową konfigurację usług IIS. Aby uzyskać bardziej szczegółowe informacje lub zainstalować na komputerze z systemem Windows Desktop, zobacz publishing to IIS or IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5.

W przypadku systemów operacyjnych Windows Server użyj kreatora Dodaj role i funkcje za pośrednictwem linku Zarządzanie lub linku Pulpit nawigacyjny w Menedżerze serwera . W kroku Role serwera zaznacz pole wyboru Web Server (IIS).

(Windows Server 2022) W wyświetlonym oknie dialogowym wybierz pozycję Dodaj funkcje, aby dodać konsolę zarządzania usługami IIS.

Na kroku Usługi ról wybierz usługi ról IIS, których potrzebujesz, lub zaakceptuj udostępniane domyślne usługi ról. Jeśli chcesz włączyć wdrożenie przy użyciu ustawień publikowania i narzędzia Web Deploy, upewnij się, że wybrano następujące funkcje:

• skrypty i narzędzia zarządzania usługami IIS
• Usługa zarządzania
• Konsola zarządzania IIS

Wykonaj kroki potwierdzenia, aby zainstalować rolę i usługi serwera internetowego. Ponowne uruchomienie serwera/usług IIS nie jest wymagane po zainstalowaniu roli serwera sieci Web (IIS).

Aktualizowanie ustawień zabezpieczeń przeglądarki w systemie Windows Server

Jeśli używasz starszej wersji systemu Windows Server, może być konieczne dodanie niektórych domen jako zaufanych witryn, aby umożliwić pobranie niektórych składników serwera internetowego. Dodaj zaufane witryny, przechodząc do Opcje internetowe > Zabezpieczenia > Zaufane witryny > Witryny. Dodaj następujące domeny.

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

Po pobraniu oprogramowania możesz otrzymywać żądania udzielenia uprawnień do ładowania różnych skryptów i zasobów witryny internetowej. Niektóre z tych zasobów nie są wymagane, ale aby uprościć proces, wybierz Dodaj, gdy pojawi się stosowna prośba.

Instalowanie ASP.NET 4.8 w systemie Windows Server

Jeśli chcesz uzyskać bardziej szczegółowe informacje dotyczące instalowania ASP.NET w usługach IIS, zobacz IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5.

Uwaga / Notatka

Instalator platformy internetowej osiągnął koniec życia w dniu 7/1/22. Aby uzyskać więcej informacji, zobacz Instalator platformy internetowej — zakończenie wsparcia technicznego i wycofanie kanału dystrybucji produktu lub aplikacji. Program ASP.NET 4.8 można zainstalować bezpośrednio z poziomu usług IIS.

1. W lewym okienku Menedżera serwera wybierz pozycję IIS. Kliknij prawym przyciskiem myszy serwer i wybierz pozycję Dodaj role i funkcje.

2. W kreatorze przejdź do sekcji Funkcje i zainstaluj ASP.NET 4.8.

   

   Uwaga / Notatka

   Jeśli używasz systemu Windows Server 2008 R2, zainstaluj ASP.NET 4 zamiast tego, używając następującego polecenia:

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

3. Uruchom ponownie system (lub wprowadź net stop was /y, a następnie net start w3svc z wiersza polecenia, aby zastosować zmianę w ścieżce systemowej PATH).

Wybieranie opcji wdrożenia

Jeśli potrzebujesz pomocy dotyczącej wdrażania aplikacji w usługach IIS, rozważ następujące opcje:

• Wdróż, tworząc plik ustawień publikowania w usługach IIS i importując ustawienia w programie Visual Studio. W niektórych scenariuszach jest to szybki sposób wdrażania aplikacji. Podczas tworzenia pliku ustawień publikowania uprawnienia są automatycznie konfigurowane w usługach IIS.

• Wdróż poprzez opublikowanie w folderze lokalnym i skopiowanie wyników preferowaną metodą do przygotowanego folderu aplikacji na IIS.

(Opcjonalnie) Wdrażanie przy użyciu pliku ustawień publikowania

Tej opcji można użyć do utworzenia pliku ustawień publikowania i zaimportowania go do programu Visual Studio.

Uwaga / Notatka

Jeśli chcesz ręcznie skonfigurować narzędzie Web Deploy zamiast importować ustawienia publikowania, upewnij się, że folder aplikacji na serwerze jest skonfigurowany z odpowiednimi wartościami i uprawnieniami (zobacz Konfigurowanie witryny sieci Web ASP.NET).

Instalowanie i konfigurowanie narzędzia Web Deploy w systemie Windows Server

Narzędzie Web Deploy udostępnia dodatkowe funkcje konfiguracji, które umożliwiają tworzenie pliku ustawień publikowania z poziomu interfejsu użytkownika.

Uwaga / Notatka

Instalator platformy internetowej osiągnął koniec życia w dniu 7/1/22. Aby uzyskać więcej informacji, zobacz Instalator platformy internetowej — zakończenie wsparcia technicznego i wycofanie kanału dystrybucji produktu lub aplikacji. Możesz bezpośrednio zainstalować narzędzie Web Deploy 4.0, aby utworzyć plik ustawień publikowania.

1. Jeśli nie zainstalowałeś jeszcze skryptów zarządzania IIS i narzędzi, zainstaluj je teraz.

   Przejdź do Wybierz role serwera>serwera sieci Web (IIS)>Narzędzia do zarządzania, a następnie wybierz rolę Skrypty i narzędzia zarządzania usługami IIS, kliknij Dalej, a następnie zainstaluj rolę.

   

   Skrypty i narzędzia są wymagane do włączenia generowania pliku ustawień publikowania.

   Upewnij się również, że zainstalowano usługę zarządzania oraz konsolę zarządzania IIS (mogą one być już zainstalowane).

2. W systemie Windows Server pobierz narzędzie Web Deploy 4.0.

3. Uruchom program instalacyjny Web Deploy i upewnij się, że wybierasz opcję Pełna instalacja zamiast typowej instalacji.

   Po zakończeniu instalacji uzyskasz składniki potrzebne do wygenerowania pliku ustawień publikowania. (Jeśli zamiast tego wybierzesz opcję Niestandardowy, możesz wyświetlić listę komponentów, jak pokazano na poniższej ilustracji).

   Zrzut ekranu

4. (Opcjonalnie) Sprawdź, czy narzędzie Web Deploy działa prawidłowo, otwierając pozycję System sterowania > i Usługi zabezpieczeń > systemu Windows Tools>, a następnie upewnij się, że:

   • jest uruchomiona usługa agenta wdrażania sieci Web (nazwa usługi różni się w starszych wersjach).

   • Usługa zarządzania Internetem jest uruchomiona.

   Jeśli jedna z usług agenta nie jest uruchomiona, uruchom ponownie usługę Web Deployment Agent Service.

   Jeśli usługa agenta wdrażania sieci Web nie jest w ogóle obecna, przejdź do Panel sterowania > Programy > Odinstaluj program, znajdź Microsoft Web Deploy <w wersji>. Wybierz opcję Zmień instalację i upewnij się, że składniki Web Deploy zostaną zainstalowane na lokalnym dysku twardym. Wykonaj kroki instalacji zmiany.

Tworzenie pliku ustawień publikowania w usługach IIS w systemie Windows Server

1. Zamknij i otwórz ponownie konsolę zarządzania usługami IIS, aby wyświetlić zaktualizowane opcje konfiguracji w interfejsie użytkownika.

2. W IIS kliknij prawym przyciskiem myszy domyślną witrynę sieci Web, wybierz opcję Wdróż>Konfiguruj publikowanie w Web Deploy.

   

   Jeśli nie widzisz menu Wdróż, zobacz poprzednią sekcję, aby sprawdzić, czy narzędzie Web Deploy jest uruchomione.

3. W oknie dialogowym Konfigurowanie publikowania Web Deploy przejrzyj ustawienia.

4. Kliknij przycisk Ustawienia.

   W panelu Wyniki dane wyjściowe pokazują, że prawa dostępu są przyznawane określonemu użytkownikowi i że plik z .publishsettings rozszerzeniem pliku został wygenerowany w lokalizacji wyświetlanej w oknie dialogowym.

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

   W zależności od konfiguracji systemu Windows Server i usług IIS w pliku XML są widoczne różne wartości. Poniżej przedstawiono kilka szczegółów dotyczących widocznych wartości:

   • Plik msdeploy.axd, do których odwołuje się atrybut publishUrl, jest dynamicznie generowanym plikiem programu obsługi HTTP dla narzędzia Web Deploy. (W celach testowych http://myhostname:8172 również zazwyczaj działa.)

   • Port publishUrl jest ustawiony na port 8172, który jest domyślnym portem web deploy.

   • Port destinationAppUrl jest ustawiony na port 80, który jest domyślny dla usług IIS.

   • Jeśli w kolejnych krokach nie możesz nawiązać połączenia z hostem zdalnym z programu Visual Studio przy użyciu nazwy hosta, przetestuj adres IP serwera zamiast nazwy hosta.

     Uwaga / Notatka

     Jeśli publikujesz w usługach IIS uruchomionych na maszynie wirtualnej platformy Azure, musisz otworzyć port przychodzący dla programu Web Deploy i usług IIS w sieciowej grupie zabezpieczeń. Aby uzyskać szczegółowe informacje, zapoznaj się z Otwieranie portów na maszynie wirtualnej.

5. Skopiuj ten plik na komputer, na którym jest uruchomiony program Visual Studio.

Importowanie ustawień publikowania w programie Visual Studio i wdrażanie

1. Na komputerze, na którym jest otwarty projekt ASP.NET w programie Visual Studio, kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań i wybierz Opublikuj.

   Jeśli wcześniej skonfigurowano wszystkie profile publikowania, zostanie wyświetlone okienko Publikowanie . Kliknij Nowy lub Utwórz nowy profil.

2. Wybierz opcję importowania profilu.

   W oknie dialogowym Publikowanie kliknij pozycję Importuj profil.

   

3. Przejdź do lokalizacji pliku ustawień publikowania utworzonego w poprzedniej sekcji.

4. W oknie dialogowym importowania plików ustawień publikowania przejdź do profilu, który utworzyłeś w poprzedniej sekcji, a następnie go wybierz i kliknij przycisk Otwórz.

   Kliknij przycisk Zakończ, aby zapisać profil publikowania, a następnie kliknij przycisk Opublikuj.

   Program Visual Studio rozpoczyna proces wdrażania, a okno Dane wyjściowe zawiera postęp i wyniki.

   Jeśli wystąpią jakiekolwiek błędy wdrażania, kliknij pozycję Więcej akcji>Edytuj , aby edytować ustawienia. Zmodyfikuj ustawienia i kliknij pozycję Zweryfikuj, aby przetestować nowe ustawienia. Jeśli nazwa hosta nie zostanie znaleziona, spróbuj użyć adresu IP zamiast nazwy hosta w polach Serwer i Docelowy adres URL .

   

Po pomyślnym wdrożeniu aplikacji powinna zostać uruchomiona automatycznie. Jeśli aplikacja nie zostanie uruchomiona po wdrożeniu, uruchom aplikację w usługach IIS, aby sprawdzić, czy działa poprawnie.

Gdy wszystko będzie gotowe, przejdź do konfiguracji debugowania.

Ważne

Jeśli zdecydujesz się debugować konfigurację wydania, podczas publikowania wyłączysz debugowanie w pliku web.config.

1. Wybierz pozycję Więcej opcji>Edytuj, aby edytować profil, a następnie wybierz pozycję Ustawienia.
2. Wybierz konfigurację Debug, a następnie wybierz pozycję Usuń dodatkowe pliki w lokalizacji docelowej w opcjach publikowania plików .
3. Wybierz pozycję Zapisz, a następnie ponownie opublikuj aplikację.

Ostrzeżenie

Użycie poświadczeń nazwy użytkownika i hasła (uwierzytelnianie podstawowe) nie jest najbezpieczniejszą metodą uwierzytelniania. Jeśli to możliwe, użyj metod alternatywnych. Rozważ na przykład publikowanie w pakiecie z programu Visual Studio, a następnie użyj WebDeploy.exe z wiersza polecenia, aby wdrożyć pakiet. Za pomocą tej metody można użyć Menedżera usług IIS, aby skonfigurować autoryzowanych użytkowników systemu Windows, którzy mogą publikować na serwerze sieci Web, i uruchomić WebDeploy.exe w ramach tego konta użytkownika systemu Windows. Zobacz Instalowanie i konfigurowanie narzędzia Web Deploy na serwerze IIS 8.0 lub nowszym. Jeśli używasz poświadczeń hasła, pamiętaj, aby użyć silnego hasła i zabezpieczyć hasło przed wyciekiem lub udostępnieniem.

(Opcjonalnie) Wdrażanie przez publikowanie w folderze lokalnym

Możesz użyć tej opcji, aby wdrożyć aplikację, jeśli chcesz skopiować aplikację do usług IIS przy użyciu programu PowerShell, narzędzia RoboCopy lub ręcznie skopiować pliki.

Konfigurowanie witryny sieci Web ASP.NET na komputerze z systemem Windows Server

1. Otwórz Eksploratora Windows i utwórz nowy folder C:\Publish, w którym później wdrożysz projekt ASP.NET.

2. Jeśli jeszcze nie jest otwarty, otwórz menedżera Internet Information Services (IIS). (W lewym okienku Menedżera serwera wybierz IIS. Kliknij prawym przyciskiem myszy serwer i wybierz pozycję Internet Information Services (IIS) Manager.)

3. W sekcji Connections w okienku po lewej stronie przejdź do Sites.

4. Wybierz Domyślną witrynę sieci Web, wybierz Podstawowe ustawieniai ustaw ścieżkę fizyczną na C:\Publish.

5. Kliknij prawym przyciskiem myszy węzeł domyślnej witryny sieci Web i wybierz pozycję Dodaj aplikację.

6. Ustaw pole aliasu na MyASPApp, zaakceptuj domyślną pulę aplikacji (DefaultAppPool) i ustaw ścieżkę fizyczną na C:\Publish.

7. W obszarze Connectionswybierz pozycję Application Pools. Otwórz pulę DefaultAppPool i ustaw pole Pula aplikacji na wartość ASP.NET w wersji 4.0 (ASP.NET 4.5 nie jest opcją dla puli aplikacji).

8. Po wybraniu witryny w Menedżerze usług IIS wybierz pozycję Edytuj uprawnieniai upewnij się, że IUSR, IIS_IUSRS lub użytkownik skonfigurowany dla puli aplikacji jest autoryzowanym użytkownikiem z uprawnieniami Odczyt & Wykonywanie.

   Jeśli nie widzisz jednego z tych użytkowników z dostępem, wykonaj kroki dodawania IUSR jako użytkownika z uprawnieniami Odczyt & Wykonywanie.

Ważne

Aby uzyskać informacje o zabezpieczeniach związanych z wbudowanymi kontami, zobacz sekcję Understanding Built-In User and Group Accounts in IIS 7.

Publikowanie i wdrażanie aplikacji przez publikowanie w folderze lokalnym z poziomu programu Visual Studio

Aplikację można również opublikować i wdrożyć przy użyciu systemu plików lub innych narzędzi.

W przypadku ASP.NET 4.8 upewnij się, że plik web.config zawiera prawidłową wersję platformy .NET.

• Jeśli wartością docelową jest ASP.NET 4.8, upewnij się, że ta wartość wersji znajduje się na liście w pliku 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>
      ```
  
  

• Jeśli zainstalujesz ASP.NET 4 zamiast 4.8, wartość wersji powinna być określona jako 4.0 w pliku web.config.

Wykonaj następujące kroki, aby opublikować i wdrożyć aplikację:

1. W eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Publikuj (w przypadku formularzy internetowych Publikuj aplikację internetową).

   Jeśli wcześniej skonfigurowano jakiekolwiek profile publikowania, zostanie wyświetlone okienko Publikuj. Kliknij pozycję Nowy profil.

2. W oknie dialogowym Publikowanie wybierz opcję Folder, kliknij Przeglądaji utwórz nowy folder, C:\Publish.

   

   Kliknij zakończ, aby zapisać profil publikowania.

3. Przejdź do konfiguracji debugowania.

   Wybierz pozycję Edytuj, aby edytować profil, a następnie wybierz pozycję Ustawienia. Wybierz konfigurację Debug, a następnie wybierz pozycję Usuń dodatkowe pliki w lokalizacji docelowej w opcjach Publikowania pliku.

   

   Uwaga / Notatka

   Jeśli używasz kompilacji wydania, podczas publikowania wyłączysz debugowanie w pliku web.config.

4. Kliknij przycisk Publikuj.

   Aplikacja publikuje konfigurację Debug projektu do folderu lokalnego. Postęp jest wyświetlany w oknie wyjściowym.

5. Skopiuj katalog projektu ASP.NET z komputera programu Visual Studio do katalogu lokalnego skonfigurowanego dla aplikacji ASP.NET (w tym przykładzie C:\Publish) na komputerze z systemem Windows Server. W tym samouczku założono, że kopiujesz ręcznie, ale możesz użyć innych narzędzi, takich jak PowerShell, Xcopy lub Robocopy.

   Ostrzeżenie

   Jeśli musisz wprowadzić zmiany w kodzie lub ponownie skompilować, musisz ponownie opublikować i powtórzyć ten krok. Plik wykonywalny skopiowany na maszynę zdalną musi dokładnie odpowiadać lokalnemu źródle i symbolom. Jeśli tego nie zrobisz, podczas próby debugowania procesu otrzymasz ostrzeżenie cannot find or open the PDB file w programie Visual Studio.

6. W systemie Windows Server sprawdź, czy aplikację można uruchomić poprawnie, otwierając aplikację w przeglądarce.

   Jeśli aplikacja nie działa poprawnie, może wystąpić niezgodność między wersją ASP.NET zainstalowaną na serwerze a maszyną programu Visual Studio lub może wystąpić problem z konfiguracją usług IIS lub witryny sieci Web. Sprawdź ponownie wcześniejsze kroki.

Pobieranie i instalowanie narzędzi zdalnych w systemie Windows Server

Pobierz wersję narzędzi zdalnych, które są zgodne z wersją programu Visual Studio.

Na urządzeniu zdalnym lub serwerze, na którym chcesz debugować, a nie na maszynie programu Visual Studio, pobierz i zainstaluj poprawną wersję narzędzi zdalnych z linków w poniższej tabeli.

• Pobierz najnowszą aktualizację narzędzi zdalnych dla używanej wersji programu Visual Studio. Narzędzia zdalne dla programu Visual Studio 2022 i 2026 mogą być używane z jedną z wersji programu Visual Studio. Jednak wersje narzędzi zdalnych starszych niż Visual Studio 2022 nie są zgodne z nowszymi wersjami programu Visual Studio. (Jeśli na przykład używasz programu Visual Studio 2019, pobierz najnowszą aktualizację narzędzi zdalnych dla programu Visual Studio 2019. W tym scenariuszu nie pobieraj narzędzi zdalnych dla programu Visual Studio 2022).

• Pobierz narzędzia zdalne z tą samą architekturą co maszyna, na której je instalujesz. Jeśli na przykład chcesz debugować aplikacje x86 na komputerze zdalnym z systemem operacyjnym x64, zainstaluj narzędzia zdalne x64. Aby debugować aplikacje x86, ARM lub x64 w systemie operacyjnym ARM64, zainstaluj narzędzia zdalne ARM64.

wersja	Odnośnik	Notatki
Visual Studio 2022	narzędzia zdalne	Zgodność ze wszystkimi wersjami programu Visual Studio 2022. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 (AMD64) lub ARM64. W starszych wersjach systemu Windows Server, zobacz Odblokuj pobieranie plików, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2019	narzędzia zdalne	Narzędzia zdalne dla programu Visual Studio 2019 są dostępne w My.VisualStudio.com. Jeśli zostanie wyświetlony monit, dołącz do bezpłatnego programu Visual Studio Dev Essentials lub zaloguj się przy użyciu identyfikatora subskrypcji programu Visual Studio. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 (AMD64) lub ARM64. W starszych wersjach systemu Windows Server, zobacz Odblokuj pobieranie plików, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2017	narzędzia zdalne	Narzędzia zdalne dla programu Visual Studio 2017 są dostępne w My.VisualStudio.com. Jeśli zostanie wyświetlony monit, dołącz do bezpłatnego programu Visual Studio Dev Essentials lub zaloguj się przy użyciu identyfikatora subskrypcji programu Visual Studio. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 (AMD64) lub ARM64. W systemie Windows Server, zobacz Odblokuj pobieranie pliku, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2015	narzędzia zdalne	Narzędzia zdalne dla programu Visual Studio 2015 są dostępne w My.VisualStudio.com. Jeśli zostanie wyświetlony monit, dołącz do bezpłatnego programu Visual Studio Dev Essentials lub zaloguj się przy użyciu identyfikatora subskrypcji programu Visual Studio. W systemie Windows Server, zobacz Odblokuj pobieranie pliku, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2013	narzędzia zdalne	Strona pobierania w dokumentacji programu Visual Studio 2013
Visual Studio 2012	narzędzia zdalne	Strona pobierania w dokumentacji programu Visual Studio 2012

Debuger zdalny można uruchomić, kopiując msvsmon.exe na komputer zdalny, zamiast instalować narzędzia zdalne. Jednak kreator konfiguracji debugera zdalnego (rdbgwiz.exe) jest dostępny wyłącznie przy instalacji narzędzi zdalnych. Może być konieczne użycie kreatora do konfiguracji, jeśli chcesz uruchomić zdalny debuger jako usługę. Aby uzyskać więcej informacji, zobacz (opcjonalnie) Konfigurowanie zdalnego debugera jako usługi.

Uwaga / Notatka

• Aby debugować aplikacje systemu Windows 10 lub nowsze na urządzeniach ARM, użyj usługi ARM64, która jest dostępna z najnowszą wersją narzędzi zdalnych.
• Aby debugować aplikacje systemu Windows 10 na urządzeniach z systemem Windows RT, użyj usługi ARM, która jest dostępna tylko w pobraniu narzędzi zdalnych programu Visual Studio 2015.
• Aby debugować aplikacje x64 w systemie operacyjnym ARM64, uruchom komponent x64 msvsmon.exe, który jest zainstalowany przy użyciu narzędzi zdalnych ARM64.

Konfigurowanie zdalnego debugera w systemie Windows Server

1. Na komputerze zdalnym znajdź i uruchom Remote Debugger z menu Start.

   Jeśli nie masz uprawnień administracyjnych na komputerze zdalnym, kliknij prawym przyciskiem myszy aplikację Remote Debugger i wybierz pozycję Uruchom jako administrator. W przeciwnym razie po prostu uruchom go normalnie.

   Jeśli planujesz dołączyć do procesu, który jest uruchomiony jako administrator lub działa w ramach innego konta użytkownika (takiego jak usługi IIS), kliknij prawym przyciskiem myszy aplikację Remote Debugger i wybierz Uruchom jako administrator. Żeby uzyskać więcej informacji, zobacz Uruchom zdalny debuger jako administrator.

2. Przy pierwszym uruchomieniu debugera zdalnego (lub przed jego skonfigurowaniem) zostanie wyświetlony Kreator Konfiguracji Debugowania Zdalnego .

   W większości scenariuszy wybierz opcję Dalej, aż dojdziesz do strony kreatora Skonfiguruj zaporę systemu Windows.

   

3. Wybierz co najmniej jeden typ sieci, w którym chcesz używać narzędzi zdalnych. Jeśli komputery są połączone za pośrednictwem domeny, musisz wybrać pierwszy element. Jeśli komputery są połączone za pośrednictwem grupy roboczej lub grupy domowej, wybierz odpowiedni drugi lub trzeci element.

   Następnie wybierz Zakończ, aby uruchomić zdalny debuger.

4. Po zakończeniu konfiguracji zostanie wyświetlone okno Remote Debugger.

   

   Zdalny debuger czeka teraz na połączenie. Użyj nazwy serwera i podanego numeru portu, aby ustawić konfigurację połączenia zdalnego w programie Visual Studio.

Aby zatrzymać zdalny debuger, wybierz Plik>Zakończ. Można go ponownie uruchomić z menu Start lub z poziomu wiersza polecenia:

<Remote debugger installation directory>\msvsmon.exe

Uwaga / Notatka

Jeśli musisz dodać uprawnienia dla dodatkowych użytkowników, zmienić tryb uwierzytelniania lub numer portu debugera zdalnego, zobacz Konfigurowanie zdalnego debugera.

Aby uzyskać informacje na temat uruchamiania zdalnego debugera jako usługi, zobacz Uruchamianie zdalnego debugera jako usługi.

Dołączanie do aplikacji ASP.NET z komputera programu Visual Studio

Począwszy od programu Visual Studio 2022 w wersji 17.10 (wersja zapoznawcza 2), okno dialogowe Dołączanie do procesu zostało zmienione. Jeśli potrzebujesz instrukcji pasujących do starszego okna dialogowego, przejdź do widoku programu Visual Studio 2019 (selektor wersji w lewym górnym rogu w artykule).

1. Na komputerze programu Visual Studio otwórz rozwiązanie, które próbujesz debugować (MyASPApp, jeśli wykonasz wszystkie kroki opisane w tym artykule).

2. W programie Visual Studio wybierz Debug > Dołącz do procesu (Ctrl + Alt + P).

   Wskazówka

   W programie Visual Studio 2017 i nowszych wersjach można ponownie przyłączyć się do tego samego procesu, do którego wcześniej przyłączono się, przy użyciu Debug > Ponownie dołącz do procesu... (Shift + Alt + P).

3. Ustaw typ połączenia na zdalny (Windows).

   Pojawi się opcja celu połączenia .

   Ustaw docelową połączenia<nazwę komputera zdalnego> i naciśnij Enter.

   Sprawdź, czy program Visual Studio dodaje wymagany port do nazwy komputera, która jest wyświetlana w formacie: <nazwa komputera zdalnego>:port

   W programie Visual Studio 2022 powinna zostać wyświetlona <nazwa komputera zdalnego>:4026

   Port jest wymagany. Jeśli nie widzisz numeru portu, dodaj go ręcznie.

4. Wybierz Odśwież.

   Powinny pojawić się niektóre procesy w oknie Dostępne Procesy.

   Jeśli nie widzisz żadnych procesów, spróbuj użyć adresu IP zamiast nazwy komputera zdalnego (wymagany jest port). Aby uzyskać adres IPv4, możesz użyć ipconfig w wierszu polecenia.

   Jeśli chcesz użyć przycisku Znajdź, może być konieczne otworzyć wychodzący port UDP 3702 na serwerze.

5. Sprawdź Pokaż procesy wszystkich użytkowników.

6. Wpisz pierwszą literę nazwy procesu, aby szybko znaleźć w3wp.exe dla ASP.NET 4.5.

   Jeśli masz wiele procesów pokazujących w3wp.exe, sprawdź kolumnę Nazwa użytkownika. W niektórych scenariuszach kolumna User Name (Nazwa użytkownika) zawiera nazwę puli aplikacji, taką jak IIS APPPOOL\DefaultAppPool. Jeśli widzisz pulę aplikacji, łatwym sposobem identyfikacji prawidłowego procesu jest utworzenie nowej puli aplikacji o nazwie dla wystąpienia aplikacji, które chcesz debugować, a następnie można go łatwo znaleźć w kolumnie Nazwa użytkownika.

   

7. Wybierz Dołącz.

8. Otwórz witrynę internetową komputera zdalnego. W przeglądarce przejdź do http://<nazwa komputera zdalnego>.

   Powinna zostać wyświetlona strona internetowa ASP.NET.

9. W uruchomionej aplikacji ASP.NET wybierz link do strony Prywatność.

   Punkt przerwania powinien zostać osiągnięty w programie Visual Studio.

   Jeśli nie możesz dołączyć ani osiągnąć punktu przerwania, zobacz Rozwiązywanie problemów z debugowaniem zdalnym.

Rozwiązywanie problemów z wdrażaniem usług IIS

• Jeśli nie możesz nawiązać połączenia z hostem przy użyciu nazwy hosta, spróbuj zamiast tego użyć adresu IP.
• Upewnij się, że wymagane porty są otwarte na serwerze zdalnym.
• Sprawdź, czy wersja ASP.NET używana w aplikacji jest taka sama jak wersja zainstalowana na serwerze. Dla aplikacji możesz wyświetlić i ustawić wersję na stronie właściwości . Aby ustawić aplikację na inną wersję, należy ją zainstalować.
• Jeśli aplikacja próbowała się otworzyć, ale zobaczysz ostrzeżenie o certyfikacie, wybierz opcję polegającą na zaufaniu do witryny. Jeśli ostrzeżenie zostało już zamknięte, możesz edytować profil publikowania, plik *.pubxml, w projekcie i dodać następujący element (tylko do testowania): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Po wdrożeniu uruchom aplikację w usługach IIS, aby sprawdzić, czy została wdrożona prawidłowo.
• Sprawdź okno Dane wyjściowe w programie Visual Studio, aby uzyskać informacje o stanie, i sprawdź komunikaty o błędach.

Otwieranie wymaganych portów w systemie Windows Server

W większości konfiguracji wymagane porty są otwierane przez instalację ASP.NET i debugera zdalnego. Może jednak być konieczne sprawdzenie, czy porty są otwarte.

Uwaga / Notatka

Na maszynie wirtualnej platformy Azure należy otworzyć porty za pośrednictwem sieciowej grupy zabezpieczeń.

Wymagane porty:

• 80: Wymagane dla usług IIS.

• 4026: Wymagane do zdalnego debugowania z programu Visual Studio 2022 (zobacz Przypisania portów zdalnego debugera, aby uzyskać więcej informacji).

• 4024: Wymagane do zdalnego debugowania z poziomu programu Visual Studio 2019 (zobacz Przypisania portów zdalnego debugera, aby uzyskać więcej informacji).

• Port odnajdywania UDP 3702: (opcjonalnie) umożliwia użycie przycisku Znajdź podczas łączenia się ze zdalnym debuggerem w programie Visual Studio.

Ponadto te porty powinny być już otwarte przez instalację ASP.NET:

• 8172: (Opcjonalnie) Wymagane do wdrożenia aplikacji z poziomu programu Visual Studio przez narzędzie Web Deploy.

Otwieranie portu

1. Aby otworzyć port w systemie Windows Server, otwórz menu Start , wyszukaj Zaporę Windows Defender lub zaporę systemu Windows z zabezpieczeniami zaawansowanymi.

   W przypadku zapory Windows Defenderwybierz ustawienia zaawansowane.

2. Następnie wybierz opcję Reguły ruchu przychodzącego > Nowa reguła > Port. Wybierz pozycję Dalej i w obszarze Określone porty lokalne wprowadź numer portu, wybierz przycisk Dalej, a następnie pozycję Zezwalaj na połączenie, wybierz przycisk Dalej i dodaj nazwę (IIS, Web Deploy lub msvsmon) dla reguły ruchu przychodzącego.

   Jeśli chcesz uzyskać więcej informacji na temat konfigurowania Zapory systemu Windows, zobacz Konfigurowanie zapory systemu Windows na potrzeby zdalnego debugowania.

3. Utwórz więcej reguł dla innych wymaganych portów.