Поделиться через


Удаленная отладка ASP.NET на удаленном компьютере IIS

Чтобы выполнить отладку приложения ASP.NET, развернутого в IIS, установите и запустите удаленные средства на компьютере, где развернуто приложение, а затем подключитесь к работающему приложению из Visual Studio.

компоненты удаленного отладчика

В этом руководстве объясняется, как настроить и настроить приложение Visual Studio ASP.NET MVC 4.8, развернуть его в IIS и подключить удаленный отладчик из Visual Studio.

Замечание

Чтобы выполнить удаленную отладку ASP.NET Core, см. раздел " Удаленная отладка" ASP.NET Core на компьютере IIS. Сведения о службе приложений Azure см. в статье Удаленная отладка ASP.NET Core в Azure или для Visual Studio Enterprise используйте Снимок Отладчика (требуется .NET 4.6.1).

Предпосылки

Visual Studio 2019 или более поздней версии требуется для выполнения действий, описанных в этой статье.

Эти процедуры были проверены на этих конфигурациях сервера:

  • Windows Server 2022 и IIS 10
  • Windows Server 2012 R2 и IIS 8 (для Windows Server 2008 R2 шаги сервера отличаются)

Требования к сети

Удаленный отладчик поддерживается в Windows Server, начиная с Windows Server 2008 с пакетом обновления 2 (SP2). Полный список требований см. в разделе Требования.

Замечание

Отладка между двумя компьютерами, подключенными через прокси-сервер, не поддерживается. Отладка через подключение с высокой задержкой или низкой пропускной способностью, например, через коммутируемый доступ в Интернет или Интернет-соединение между странами/регионами, не рекомендуется и может приводить к сбоям или быть неприемлемо медленной.

Приложение, уже работающее в IIS?

В этой статье описаны действия по настройке базовой конфигурации IIS на сервере Windows Server и развертывании приложения из Visual Studio. Шаги предназначены для того, чтобы убедиться, что на сервере установлены необходимые компоненты, что приложение может работать корректно и что вы готовы к удалённой отладке.

  • Если ваше приложение работает в IIS и вы просто хотите загрузить удаленный отладчик и начать отладку, перейдите к разделу Скачивание и установка удаленных средств на Windows Server.

  • Если вам нужна помощь в настройке, развертывании и правильной работе приложения в IIS, чтобы вы могли провести отладку, выполните все шаги, описанные в этой статье.

Создание приложения ASP.NET 4.8 на компьютере Visual Studio

  1. Создайте приложение ASP.NET MVC.

    В Visual Studio выберите "Файл">окно "Пуск", чтобы открыть окно запуска, а затем выберите "Создать проект". В поле поиска введите платформу asp.net и выберите ASP.NET веб-приложение (.NET Framework). В появившемся диалоговом окне назовите проект MyASPApp, выберите ASP.NET Framework 4.8 и нажмите кнопку "Создать".

    Выберите MVC и нажмите кнопку "Создать".

  2. Откройте файл HomeController.cs в папке Controllers и задайте точку останова в инструкции return View; в методе Privacy.

    В старых шаблонах откройте файл Privacy.cshtml.cs и установите точку останова в методе OnGet.

Установка и настройка IIS на Windows Server

В этих шагах показана только базовая конфигурация IIS. Дополнительные сведения или установку на компьютер с Windows Desktop см. в разделе публикации на IIS или IIS 8.0 с помощью ASP.NET 3.5 и ASP.NET 4.5.

Для операционных систем Windows Server используйте мастер добавления ролей и компонентов с помощью ссылки "Управление" или ссылку панели мониторинга в диспетчер сервера. На этапе Роли сервера установите флажок Веб-сервер (IIS).

снимок экрана: роль IIS веб-сервера, выбранная на шаге выбора ролей сервера.

(Windows Server 2022) В появившемся диалоговом окне выберите Добавить компоненты, чтобы добавить консоль управления IIS.

На шаге служб ролей выберите нужные службы ролей IIS или примите предоставленные службы ролей по умолчанию. Если вы хотите включить развертывание с помощью параметров публикации и веб-развертывания, убедитесь, что выбраны следующие функции:

  • скрипты и средства управления IIS
  • Служба управления
  • Консоль управления IIS

снимок экрана: выбранные скрипты и средства управления IIS.

Выполните действия по подтверждению для установки роли и служб веб-сервера. Перезапуск сервера или IIS не требуется после установки роли веб-сервера (IIS).

Обновление параметров безопасности браузера в Windows Server

Если вы используете старую версию Windows Server, может потребоваться добавить некоторые домены в качестве доверенных сайтов, чтобы вы могли скачать некоторые компоненты веб-сервера. Добавьте доверенные сайты, перейдя в Параметры интернета > Параметры безопасности, > Доверенные сайты > Сайты. Добавьте следующие домены.

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

При скачивании программного обеспечения вы можете получить запросы на предоставление разрешения на загрузку различных скриптов и ресурсов веб-сайта. Некоторые из этих ресурсов не требуются, но для упрощения процесса выберите Добавить, когда будет предложено.

Установка ASP.NET 4.8 в Windows Server

Если требуется более подробная информация об установке ASP.NET в IIS, см. статью IIS 8.0 с помощью ASP.NET 3.5 и ASP.NET 4.5.

Замечание

Установщик веб-платформы был снят с эксплуатации 1 июля 2022 года. Дополнительные сведения см. в разделе Установщик веб-платформы — прекращение поддержки и вывод из эксплуатации канала продукта или приложения. Вы можете напрямую установить ASP.NET 4.8 из IIS.

  1. В левой области диспетчера серверов выберите IIS. Щелкните правой кнопкой мыши сервер и выберите пункт "Добавить роли и компоненты".

  2. В мастере перейдите к разделу "Компоненты " и установите ASP.NET 4.8.

    Снимок экрана окна добавления ролей и компонентов для IIS: выбрано ASP.NET 4.8.

    Замечание

    Если вы используете Windows Server 2008 R2, установите ASP.NET 4 вместо этого с помощью следующей команды:

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

  3. Перезапустите систему (или выполните net stop was /y, а затем выполните net start w3svc из командной строки, чтобы применить изменения в системном PATH).

Выбор варианта развертывания

Если вам нужна помощь по развертыванию приложения в IIS, рассмотрите следующие варианты:

  • Развертывание начните с создания файла параметров публикации в IIS и импорта этих параметров в Visual Studio. В некоторых сценариях это быстрый способ развертывания приложения. При создании файла параметров публикации разрешения автоматически настраиваются в IIS.

  • Развертывание путем публикации в локальной папке и копирования выходных данных с помощью предпочтительного метода в подготовленную папку приложения в IIS.

(Необязательно) Развертывание с помощью файла параметров публикации

Этот параметр можно использовать для создания файла параметров публикации и импорта его в Visual Studio.

Замечание

Если вы хотите вручную настроить веб-развертывание вместо импорта параметров публикации, необходимо убедиться, что папка приложения на сервере настроена с правильными значениями и разрешениями (см. раздел Настройка ASP.NET веб-сайта).

Установка и настройка веб-развертывания на Windows Server

Веб-развертывание предоставляет дополнительные функции конфигурации, позволяющие создавать файл параметров публикации из пользовательского интерфейса.

Замечание

Установщик веб-платформы был снят с эксплуатации 1 июля 2022 года. Дополнительные сведения см. в разделе Установщик веб-платформы — прекращение поддержки и вывод из эксплуатации канала продукта или приложения. Вы можете напрямую установить Web Deploy 4.0, чтобы создать файл параметров публикации.

  1. Если вы еще не установили скрипты управления IIS и средства, установите их сейчас.

    Перейдите к Выберите роли сервера>веб-сервер (IIS)>средства управления, а затем выберите роль скриптов управления IIS и средств, нажмите кнопку Далее, а затем установите роль.

    установка скриптов и средств управления IIS

    Скрипты и инструменты необходимы для обеспечения возможности создания файла параметров публикации.

    Убедитесь, что вы также установили службу управления и консоль управления IIS (возможно, они уже установлены).

  2. На Windows Server скачайте Web Deploy 4.0.

  3. Запустите программу установки Web Deploy и убедитесь, что вы выбрали полную установку, а не типичную установку.

    После полной установки вы получите компоненты, необходимые для создания файла параметров публикации. (Если вы выберете Custom вместо этого, вы можете просмотреть список компонентов, как показано на следующем рисунке.)

    Снимок экрана, показывающий компоненты Web Deploy 4.0

  4. (Необязательно) Убедитесь, что Web-развертывание выполняется правильно, открыв "Панель управления" "Система и безопасность" > "Административные инструменты" > "Службы" >, а затем убедитесь, что:

    • Служба агента веб-развертывания запущена (название службы отличается в более ранних версиях).

    • Служба веб-управления запущена.

    Если одна из служб агентского сервиса не запущена, перезапустите службу агента веб-развертывания .

    Если служба агента веб-развертывания полностью отсутствует, перейдите в Панель управления > Программы > Удаление программы, найдите Microsoft Web Deploy <версии>. Выберите Изменить установку и убедитесь, что вы выбрали Будет установлен на локальный жесткий диск для компонентов Web Deploy. Выполните действия по установке изменений.

Создание файла параметров публикации в IIS на Windows Server

  1. Закройте и снова откройте консоль управления IIS, чтобы отобразить обновленные параметры конфигурации в пользовательском интерфейсе.

  2. В IIS щелкните правой кнопкой мыши Default Web Site, выберите Deploy>Configure Web Deploy Publishing.

    Настройка конфигурации веб-развертывания

    Если вы не видите меню "Развертывание", ознакомьтесь с предыдущим разделом, чтобы убедиться, что Web Deploy запущен.

  3. В диалоговом окне Настройки веб-публикации и развертывания проверьте параметры.

  4. Щелкните Настройка.

    На панели Результаты показано, что права доступа предоставлены указанному пользователю, а файл с расширением .publishsettings создан в месте, указанном в диалоговом окне.

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

    В зависимости от конфигурации Windows Server и IIS в XML-файле отображаются разные значения. Ниже приведены некоторые сведения о значениях, которые вы видите:

    • Файл msdeploy.axd, на который ссылается атрибут publishUrl, является динамически созданным файлом обработчика HTTP для веб-развертывания. (В целях тестирования http://myhostname:8172 тоже обычно работает.)

    • Для порта publishUrl задан порт 8172, используемый по умолчанию для веб-развертывания.

    • Для порта destinationAppUrl задан порт 80, который используется по умолчанию для IIS.

    • Если в последующих шагах не удается подключиться к удаленному узлу из Visual Studio с помощью имени узла, проверьте IP-адрес сервера вместо имени узла.

      Замечание

      Если вы публикуете в IIS, работающем на виртуальной машине в Azure, необходимо открыть входящий порт для Web Deploy и IIS в группе безопасности сети. Подробные сведения см. в разделе Открытие портов для виртуальной машины.

  5. Скопируйте этот файл на компьютер, на котором выполняется Visual Studio.

Импорт параметров публикации в Visual Studio и развертывание

  1. На компьютере, где открыт проект ASP.NET в Visual Studio, щелкните проект правой кнопкой мыши в Обозревателе решений и выберите Опубликовать.

    Если вы ранее настроили профили публикации, появится панель публикации . Щелкните Создать или Создать новый профиль.

  2. Выберите параметр импорта профиля.

    В диалоговом окне Публикация щелкните Импорт профиля.

    Выбрать публикацию

  3. Перейдите к расположению файла параметров публикации, созданного в предыдущем разделе.

  4. В диалоговом окне импорта файла параметров публикации перейдите и выберите профиль, созданный в предыдущем разделе, и щелкните Открыть.

    Нажмите кнопку Готово, чтобы сохранить профиль публикации, а затем щелкните Опубликовать.

    Visual Studio начинает процесс развертывания, а окно вывода отображает ход выполнения и результаты.

    Если возникают какие-либо ошибки развертывания, щелкните Дополнительные действия>Редактировать, чтобы настроить параметры. Измените параметры и щелкните Подтвердить, чтобы проверить новые параметры. Если имя узла не найдено, попробуйте использовать IP-адрес вместо имени узла в полях сервера и целевого URL-адреса.

    Изменение параметров в инструменте публикации

После успешного развертывания приложения он должен запускаться автоматически. Если приложение не запускается после развертывания, запустите приложение в IIS, чтобы убедиться, что оно работает правильно.

Когда вы будете готовы, переключитесь в конфигурацию отладки.

Это важно

Если вы решили отладить конфигурацию выпуска, при публикации отключите отладку в файле web.config.

  1. Выберите Дополнительные параметры>Изменить, чтобы изменить профиль, а затем выберите Параметры.
  2. Выберите конфигурацию отладки, затем выберите Удалить дополнительные файлы в пункте назначения в разделе параметры публикации файлов.
  3. Выберите Сохранить и повторно опубликуйте приложение.
  1. Выберите Изменить, чтобы изменить профиль, а затем выберите Настройки.
  2. Выберите конфигурацию отладки, затем выберите Удалить дополнительные файлы в пункте назначения в разделе параметры публикации файлов.
  3. Выберите Сохранить и повторно опубликуйте приложение.

Предупреждение

Использование учетных данных имени пользователя и пароля (обычная проверка подлинности) не является самым безопасным способом проверки подлинности. По возможности используйте альтернативные методы. Например, попробуйте опубликовать пакет из Visual Studio, а затем использовать WebDeploy.exe из командной строки для развертывания пакета. С помощью этого метода можно использовать диспетчер IIS для настройки авторизованных пользователей Windows, которые могут публиковаться на веб-сервере, и запускать WebDeploy.exe под учетной записью этого пользователя Windows. См. раздел Установке и Настройке Web Deploy на IIS 8.0 или более поздней версии. Если вы используете учетные данные паролей, обязательно используйте надежный пароль и защитите пароль от утечки или общего доступа.

(Необязательно) Развертывание путем публикации в локальной папке

Этот параметр можно использовать для развертывания приложения, если вы хотите скопировать приложение в IIS с помощью PowerShell, RoboCopy или вручную скопировать файлы.

Настройка веб-сайта ASP.NET на компьютере Windows Server

  1. Откройте проводник Windows и создайте новую папку C:\Publish, где позже развернете проект ASP.NET.

  2. Если он еще не открыт, откройте Диспетчер IIS. (В левой области диспетчера серверов выберите IIS. Щелкните сервер правой кнопкой мыши и выберите диспетчер служб IIS.)

  3. В разделе Подключения в левой области перейдите к Сайтам.

  4. Выберите веб-сайт по умолчанию, выберите базовые параметрыи задайте физический путь на C:\Publish.

  5. Щелкните правой кнопкой мыши узел веб-сайта по умолчанию и выберите Добавить приложение.

  6. Задайте для поля псевдонима значение MyASPApp, примите пул приложений по умолчанию (DefaultAppPool), и задайте физический путь как C:\Publish.

  7. В разделе Подключениявыберите пулы приложений. Откройте DefaultAppPool и задайте для поля пула приложений значение ASP.NET версии 4.0 (ASP.NET 4.5 не является параметром для пула приложений).

  8. Выбрав сайт в диспетчере IIS, выберите изменить разрешенияи убедитесь, что IUSR, IIS_IUSRS или пользователь, настроенный для пула приложений, является авторизованным пользователем с правами на чтение & выполнение.

    Если вы не видите одного из этих пользователей с доступом, выполните действия по добавлению IUSR в качестве пользователя с правами на чтение & Execute.

Это важно

Сведения о безопасности, связанные со встроенными учетными записями, см. в статье Общие сведения о Built-In учетных записях пользователей и групп в IIS 7.

Публикация и развертывание приложения путем публикации в локальной папке из Visual Studio

Вы также можете опубликовать и развернуть приложение с помощью файловой системы или других средств.

Для ASP.NET 4.8 убедитесь, что файл web.config содержит правильную версию .NET.

  • Если вы используете ASP.NET версии 4.8, убедитесь, что это значение версии указано в файле 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>
        ```
    
    
  • Если установить ASP.NET 4 вместо 4.8, то значение версии должно быть указано как 4.0 в файле web.config.

Выполните следующие действия, чтобы опубликовать и развернуть приложение:

  1. В обозревателе решений щелкните правой кнопкой мыши узел проекта и выберите Опубликовать (для веб-форм — Опубликовать веб-приложение).

    Если вы ранее настроили профили публикации, появится панель публикации . Щелкните Создать профиль.

  2. В диалоговом окне Публикация выберите Папка, щелкните Обзори создайте новую папку C:\Publish.

    снимок экрана: диалоговое окно выбора целевого объекта публикации в Visual Studio с папкой

    Нажмите кнопку Завершить, чтобы сохранить профиль публикации.

    снимок экрана: диалоговое окно выбора целевого объекта публикации в Visual Studio с папкой

    Нажмите кнопку Завершить, чтобы сохранить профиль публикации.

  3. Переключитесь в конфигурацию отладки.

    Выберите Изменить, чтобы изменить профиль, а затем выберите Настройки. Выберите конфигурацию Debug, затем выберите Удалить дополнительные файлы в месте назначения в разделе Параметры публикации файлов.

    снимок экрана вкладки

    Замечание

    Если вы используете релизную сборку, то при публикации отладка в файле web.config будет отключена.

  4. Нажмите кнопку Опубликовать.

    Приложение публикует отладочную конфигурацию проекта в локальную папку. Ход выполнения отображается в окне вывода.

  5. Скопируйте каталог проекта ASP.NET с компьютера Visual Studio в локальный каталог, настроенный для приложения ASP.NET (в этом примере C:\Publish) на компьютере Windows Server. В этом руководстве предполагается, что вы копируете вручную, но вы можете использовать другие инструменты, такие как PowerShell, Xcopy или Robocopy.

    Осторожность

    Если необходимо внести изменения в код или перестроить, необходимо повторно опубликовать и повторить этот шаг. Исполняемый файл, скопированный на удаленный компьютер, должен в точности соответствовать вашему локальному источнику и символам. Если вы этого не сделаете, вы получите предупреждение cannot find or open the PDB file в Visual Studio при попытке отладки процесса.

  6. В Windows Server убедитесь, что приложение можно запустить правильно, открыв приложение в браузере.

    Если приложение не работает правильно, может возникнуть несоответствие между версией ASP.NET, установленной на сервере и на компьютере Visual Studio, или у вас может возникнуть проблема с конфигурацией IIS или веб-сайта. Выполните повторную проверку предыдущих шагов.

Скачивание и установка средств удаленного доступа на Windows Server

Скачайте версию удаленных средств, которые соответствуют версии Visual Studio.

На удаленном устройстве или сервере, на котором требуется выполнить отладку, а не на компьютере Visual Studio, скачайте и установите правильную версию удаленных средств из ссылок в следующей таблице.

  • Скачайте последнее обновление средств удаленного доступа для вашей версии Visual Studio. Более ранние версии удаленных средств несовместимы с более поздними версиями Visual Studio. (Например, если вы используете Visual Studio 2019, скачайте последнее обновление средств удаленного доступа для Visual Studio 2019. В этом сценарии не скачивайте средства удаленного доступа для Visual Studio 2022.)
  • Скачайте удаленные средства с той же архитектурой, что и компьютер, на котором вы устанавливаете их. Например, если вы хотите отлаживать приложения x86 на удаленном компьютере под управлением операционной системы x64, установите средства удаленного управления x64. Чтобы выполнить отладку приложений x86, ARM или x64 в операционной системе ARM64, установите удаленные средства ARM64.
Версия Ссылка Примечания.
Визуальная студия 2022 удаленные инструменты Совместима со всеми версиями Visual Studio 2022. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В более старых версиях Windows Server см. Разблокируйте скачивание файла, чтобы получить помощь с загрузкой средств удаленного доступа.
Visual Studio 2019 удаленные инструменты Средства удаленного доступа для Visual Studio 2019 доступны в My.VisualStudio.com. Если будет предложено, присоединитесь к бесплатной программе Visual Studio Dev Essentials или выполните вход с помощью идентификатора подписки Visual Studio. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В более старых версиях Windows Server см. Разблокируйте скачивание файла, чтобы получить помощь с загрузкой средств удаленного доступа.
Visual Studio 2017 удаленные инструменты Средства удаленного доступа для Visual Studio 2017 доступны в My.VisualStudio.com. Если будет предложено, присоединитесь к бесплатной программе Visual Studio Dev Essentials или выполните вход с помощью идентификатора подписки Visual Studio. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов.
Visual Studio 2015 удаленные инструменты Средства удаленного доступа для Visual Studio 2015 доступны в My.VisualStudio.com. Если будет предложено, присоединитесь к бесплатной программе Visual Studio Dev Essentials или выполните вход с помощью идентификатора подписки Visual Studio. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов.
Visual Studio 2013 удаленные инструменты Страница загрузки в документации по Visual Studio 2013
Visual Studio 2012 удаленные инструменты Страница загрузки в документации по Visual Studio 2012
Версия Ссылка Примечания.
Visual Studio 2019 удаленные инструменты Совместима со всеми версиями Visual Studio 2019. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов. Для самой последней версии удаленных инструментов откройте документ для Visual Studio 2022.
Visual Studio 2017 удаленные инструменты Совместима со всеми версиями Visual Studio 2017. Скачайте версию, соответствующую операционной системе устройства (x86, x64 (AMD64) или ARM64. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов.
Visual Studio 2015 удаленные инструменты Средства удаленного доступа для Visual Studio 2015 доступны в My.VisualStudio.com. Если будет предложено, присоединитесь к бесплатной программе Visual Studio Dev Essentials или выполните вход с помощью идентификатора подписки Visual Studio. В Windows Server см. как разблокировать загрузку файла, чтобы помочь с загрузкой удаленных инструментов.
Visual Studio 2013 удаленные инструменты Страница загрузки в документации по Visual Studio 2013
Visual Studio 2012 удаленные инструменты Страница загрузки в документации по Visual Studio 2012

Вы можете запустить удаленный отладчик, скопировав msvsmon.exe на удаленный компьютер, а не установив удаленные средства. Однако мастер настройки удаленного отладчика (rdbgwiz.exe) доступен только при установке удаленных средств. Если вы хотите запустить удаленный отладчик в качестве службы, может потребоваться использовать мастер настройки. Дополнительные сведения см. в разделе (необязательно) Настройка удаленного отладчика в качестве службы.

Замечание

  • Для отладки приложений Windows 10 или более поздних версий на устройствах ARM используйте ARM64, которая доступна с последней версией удаленных средств.
  • Чтобы выполнить отладку приложений Windows 10 на устройствах Windows RT, используйте ARM, который доступен только в пакете скачивания удаленных средств разработки Visual Studio 2015.
  • Чтобы выполнить отладку приложений x64 в операционной системе ARM64, запустите x64 msvsmon.exe, установленный вместе с удаленными средствами ARM64.

Настройка удаленного отладчика на Windows Server

  1. На удалённом компьютере найдите и запустите Удалённый отладчик из меню «Пуск».

    Если у вас нет административных разрешений на удаленном компьютере, щелкните правой кнопкой мыши приложение удаленного отладчика и выберите запустить от имени администратора. В противном случае просто запустите его нормально.

    Если вы планируете подключиться к процессу, запущенному с правами администратора или под другой учетной записью пользователя (например, IIS), щелкните правой кнопкой мыши на приложении Удаленный отладчик и выберите Запуск от имени администратора. Дополнительные сведения см. в статье Запуск удаленного отладчика в качестве администратора.

  2. При первом запуске удаленного отладчика (или перед его настройкой) появится мастер конфигурации удаленной отладки .

    В большинстве сценариев выбирайте Далее, пока не дойдёте до страницы Настройка брандмауэра Windows мастера.

    Снимок экрана конфигурации удаленного отладчика.

    Снимок экрана конфигурации удаленного отладчика.

    Если API веб-служб Windows не установлен, что бывает только на Windows Server 2008 R2, нажмите кнопку Установить.

  3. Выберите хотя бы один тип сети, в который вы хотите использовать удаленные средства. Если компьютеры подключены через домен, необходимо выбрать первый элемент. Если компьютеры подключены через рабочую или домашнюю группу, выберите второй или третий элемент соответствующим образом.

    Затем нажмите кнопку Готово, чтобы запустить удаленный отладчик.

    Затем выберите Настроить удаленную отладку, чтобы запустить удаленный отладчик.

  4. После завершения настройки откроется окно удаленного отладчика.

    снимок экрана: окно удаленного отладчика

    снимок экрана: окно удаленного отладчика

    Теперь удаленный отладчик ожидает подключения. Используйте имя сервера и номер порта, показанные для задания конфигурации удаленного подключения в Visual Studio.

Чтобы остановить удаленный отладчик, выберите Файл>Выход. Его можно перезапустить из меню "Пуск" или из командной строки:

<Remote debugger installation directory>\msvsmon.exe

Замечание

Если необходимо добавить разрешения для дополнительных пользователей, изменить режим проверки подлинности или номер порта для удаленного отладчика, см. Настройка удаленного отладчика.

Сведения о запуске удаленного отладчика в качестве службы см. в статье Запуск удаленного отладчика в качестве службы.

Присоединение к приложению ASP.NET с компьютера Visual Studio

Начиная с Visual Studio 2022 версии 17.10 Preview 2 диалоговое окно "Присоединение к процессу" изменилось. Если вам нужны инструкции, соответствующие более старым диалоговым окнам, перейдите в представление Visual Studio 2019 (селектор версий в верхней левой части статьи).

  1. На компьютере Visual Studio откройте решение, которое вы пытаетесь отлаживать (MyASPApp, если вы выполняете все действия, описанные в этой статье.

  2. В Visual Studio выберите Отладка > Присоединиться к процессу (Ctrl + Alt + P).

    Подсказка

    В Visual Studio 2017 и более поздних версиях можно повторно подключиться к тому же процессу, к которому вы ранее подключались, с помощью Отладка > Повторно подключиться к процессу... (Shift + Alt + P).

  3. Установите тип подключения на удаленный (Windows).

    Появится параметр целевого объекта подключения.

    Установите целевой объект подключения на имя удаленного компьютера <> и нажмите клавишу Enter .

    Убедитесь, что Visual Studio добавляет необходимый порт к имени компьютера, которое отображается в формате: <имя удаленного компьютера>:порт

    В Visual Studio 2022 вы увидите <имя удаленного компьютера>:4026

    Требуется порт. Если номер порта не отображается, добавьте его вручную.

  1. На компьютере Visual Studio откройте решение, которое вы пытаетесь отлаживать (MyASPApp, если вы выполняете все действия, описанные в этой статье.

  2. В Visual Studio выберите Отладка > Присоединиться к процессу (Ctrl + Alt + P).

    Подсказка

    В Visual Studio 2017 и более поздних версиях можно повторно подключиться к тому же процессу, к которому вы ранее подключались, с помощью Отладка > Повторно подключиться к процессу... (Shift + Alt + P).

  3. Задайте для поля квалификатора <имя удаленного компьютера> и нажмите Enter.

    Убедитесь, что Visual Studio добавляет необходимый порт к имени компьютера, которое отображается в формате: <имя удаленного компьютера>:порт

    В Visual Studio 2019 вы должны увидеть <имя удаленного компьютера>:4024

    Требуется порт. Если номер порта не отображается, добавьте его вручную.

  1. Выбрать обновить.

    Вы должны увидеть появление некоторых процессов в окне Доступные процессы.

    Если вы не видите никаких процессов, попробуйте использовать IP-адрес вместо имени удаленного компьютера (требуется порт). Чтобы получить IPv4-адрес, можно использовать ipconfig в командной строке.

    Если вы хотите использовать кнопку Найти, возможно, потребуется открыть исходящий порт UDP 3702 на сервере.

  2. Отметьте Показать процессы от всех пользователей.

  3. Введите первую букву имени процесса, чтобы быстро найти w3wp.exeдля ASP.NET 4.5 .

    Если у вас несколько процессов, показывающих w3wp.exe, проверьте столбец имени пользователя. В некоторых сценариях столбец "Имя пользователя" отображает имя пула приложений, например IIS APPPOOL\DefaultAppPool. Если вы видите пул приложений, простой способ определить правильный процесс заключается в создании нового именованного пула приложений для экземпляра приложения, который требуется отлаживать, а затем легко найти его в столбце "Имя пользователя".

    снимок экрана диалогового окна

    снимок экрана диалогового окна

  4. Выберите Прикрепить.

  5. Откройте веб-сайт удаленного компьютера. В браузере перейдите к http://<имени удаленного компьютера>.

    Вы увидите веб-страницу ASP.NET.

  6. В работающем приложении ASP.NET выберите ссылку на страницу конфиденциальности .

    Точка останова должна быть достигнута в Visual Studio.

    Если вы не можете подключиться или достичь точки останова, см. статью Устранение неполадок удаленной отладки.

Устранение неполадок в развертывании IIS

  • Если вы не можете подключиться к узлу с помощью имени узла, попробуйте использовать IP-адрес.
  • Убедитесь, что необходимые порты открыты на удаленном сервере.
  • Убедитесь, что версия ASP.NET, используемая в приложении, совпадает с версией, установленной на сервере. Для приложения можно просмотреть и задать версию на странице свойств . Чтобы установить приложение на другую версию, ее необходимо установить.
  • Если приложение попыталось открыть, но появится предупреждение о сертификате, выберите доверять сайту. Если предупреждение уже закрыто, вы можете изменить профиль публикации, файл *.pubxml в проекте и добавить следующий элемент (только для тестирования): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
  • После развертывания запустите приложение в IIS, чтобы проверить правильное развертывание приложения.
  • Проверьте окно вывода в Visual Studio для сведений о состоянии и проверьте сообщения об ошибках.

Открытие необходимых портов в Windows Server

В большинстве настроек необходимые порты открываются установкой ASP.NET и удаленным отладчиком. Однако может потребоваться проверить, открыты ли порты.

Замечание

На виртуальной машине Azure необходимо открыть порты через группу безопасности сети.

Обязательные порты:

  • 80. Требуется для IIS.
  • 4024. Требуется для удаленной отладки из Visual Studio 2019 (дополнительные сведения см. в разделе назначения портов удаленного отладчика).

  • UDP 3702: (необязательно) порт обнаружения позволяет нажать кнопку "Найти " при подключении к удаленному отладчику в Visual Studio.

Кроме того, эти порты уже должны быть открыты установкой ASP.NET:

  • 8172: (необязательно) Требуется для веб-развертывания для развертывания приложения из Visual Studio.

Открытие порта

  1. Чтобы открыть порт на Windows Server, откройте меню "Пуск", найдите брандмауэр Защитника Windows или брандмауэр Windows с функцией расширенной безопасности.

    Для Брандмауэра Защитника Windowsвыберите дополнительные параметры.

  2. Затем выберите Правила для входящих подключений > Новый правило > Порт. Нажмите Далее и в разделе Определенные локальные порты введите номер порта, выберите Далее, затем Разрешить соединение, снова выберите Далее и добавьте имя (IIS, Web Deploy или msvsmon) для правила входящего трафика.

    Дополнительные сведения о настройке брандмауэра Windows см. в статье Настройка брандмауэра Windows для удаленной отладки.

  3. Создайте дополнительные правила для других необходимых портов.