Depuración remota de ASP.NET en un equipo IIS remoto

Para depurar una aplicación de ASP.NET que se ha implementado en IIS, instale y ejecute las herramientas remotas en el equipo donde implementó la aplicación y, a continuación, adjunte a la aplicación en ejecución desde Visual Studio.

En esta guía se explica cómo configurar y configurar una aplicación de Visual Studio ASP.NET MVC 4.8, implementarla en IIS y adjuntar el depurador remoto desde Visual Studio.

Nota

Para depurar de forma remota ASP.NET Core en su lugar, consulte Depuración remota de ASP.NET Core en un equipo de IIS. Para obtener Azure App Service, consulte Depuración remota ASP.NET Core en Azure o, para Visual Studio Enterprise, use Snapshot Debugger (se requiere .NET 4.6.1).

Prerrequisitos

Se requiere Visual Studio 2019 o una versión posterior para seguir los pasos que se muestran en este artículo.

Estos procedimientos se han probado en estas configuraciones de servidor:

• Windows Server 2022 e IIS 10
• Windows Server 2012 R2 e IIS 8 (para Windows Server 2008 R2, los pasos del servidor son diferentes)

Requisitos de red

El depurador remoto se admite en Windows Server a partir de Windows Server 2008 Service Pack 2. Para obtener una lista completa de los requisitos, consulte Requirements.

Nota

La depuración entre dos equipos conectados a través de un proxy no se admite. La depuración a través de una conexión de latencia alta o de ancho de banda bajo, como Internet mediante acceso telefónico o Internet a través de países o regiones, no se recomienda y puede producir un error o ser demasiado lenta.

¿La aplicación ya se está ejecutando en IIS?

En este artículo se incluyen pasos para configurar una configuración básica de IIS en Windows Server e implementar la aplicación desde Visual Studio. Estos pasos se incluyen para asegurarse de que el servidor tiene instalados los componentes necesarios, que la aplicación se puede ejecutar correctamente y que está listo para la depuración remota.

• Si la aplicación se ejecuta en IIS y solo quiere descargar el depurador remoto e iniciar la depuración, vaya a Descargar e instalar las herramientas remotas en Windows Server.

• Si quiere ayuda para asegurarse de que la aplicación esté configurada, implementada y ejecutándose correctamente en IIS para que pueda depurar, siga todos los pasos de este artículo.

Creación de la aplicación ASP.NET 4.8 en el equipo de Visual Studio

1. Cree una nueva aplicación de ASP.NET de MVC.

   En Visual Studio, elija Archivo>Ventana de inicio para abrir la ventana de inicio y, a continuación, elija Crear un nuevo proyecto. En el cuadro de búsqueda, escriba asp.net frameworky elija ASP.NET Aplicación web (.NET Framework). En el cuadro de diálogo que aparece, asigne al proyecto el nombre MyASPApp, elija ASP.NET Framework 4.8y, a continuación, elija Crear.

   Seleccione MVC y elija Crear.

2. Abra el archivo HomeController.cs en la carpeta Controllers y establezca un punto de interrupción en la instrucción return View; en el método Privacy.

   En plantillas anteriores, abra el archivo Privacy.cshtml.cs y establezca un punto de interrupción en el método OnGet.

Instalación y configuración de IIS en Windows Server

Estos pasos muestran solo una configuración básica de IIS. Para obtener información más detallada o para instalar en un PC de escritorio con Windows, consulte Publicación en IIS o IIS 8.0 usando ASP.NET 3.5 y ASP.NET 4.5.

En los sistemas operativos Windows Server, use el asistente Agregar roles y características a través del vínculo Administrar o el vínculo Panel en el Administrador del servidor. En el paso Roles de servidor, active la casilla de Servidor web (IIS).

(Windows Server 2022) En el cuadro de diálogo que aparece, elija Agregar características para agregar la consola de administración de IIS.

En el paso Servicios de rol, seleccione los servicios de rol de IIS que desee o acepte los servicios de rol predeterminados proporcionados. Si desea habilitar la implementación mediante la configuración de publicación y Web Deploy, asegúrese de que se seleccionan las siguientes características:

• Scripts y herramientas de administración de IIS
• Servicio de Gestión
• Consola de administración de IIS

Siga los pasos de confirmación para instalar el rol de servidor web y los servicios. No es necesario reiniciar un servidor o IIS después de instalar el rol servidor web (IIS).

Actualizar la configuración de seguridad del explorador en Windows Server

Si usa una versión anterior de Windows Server, es posible que tenga que agregar algunos dominios como sitios de confianza para permitirle descargar algunos de los componentes del servidor web. Para agregar los sitios de confianza, vaya a Opciones de Internet > Seguridad > Sitios de confianza > Sitios. Agregue los siguientes dominios.

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

Al descargar el software, es posible que obtenga solicitudes para conceder permiso para cargar varios scripts y recursos de sitio web. Algunos de estos recursos no son necesarios, pero para simplificar el proceso, seleccione Agregar cuando se le solicite.

Instalar ASP.NET 4.8 en Windows Server

Si desea obtener información más detallada para instalar ASP.NET en IIS, consulte IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5.

Nota

El instalador de la plataforma web alcanzó el fin de su ciclo de vida el 7/1/22. Para más información, vea Instalador de plataforma web: fin del soporte técnico y puesta en ejecución de la fuente de productos o aplicaciones. Puede instalar directamente ASP.NET 4.8 desde IIS.

1. En el panel izquierdo del Administrador del servidor, seleccione IIS . Haga clic con el botón derecho en el servidor y seleccione Agregar roles y características.

2. En el asistente, avance a la sección Características e instale ASP.NET 4.8.

   

   Nota

   Si usa Windows Server 2008 R2, instale ASP.NET 4 en su lugar con este comando:

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

3. Reinicie el sistema (o ejecute net stop was /y seguido de net start w3svc desde un símbolo del sistema para obtener un cambio en la ruta de acceso del sistema).

Elección de una opción de implementación

Si necesita ayuda para implementar la aplicación en IIS, tenga en cuenta estas opciones:

• Implemente mediante la creación de un archivo de configuración de publicación en IIS e importación de la configuración en Visual Studio. En algunos escenarios, esta es una manera rápida de implementar la aplicación. Al crear el archivo de configuración de publicación, los permisos se configuran automáticamente en IIS.

• Implemente publicando en una carpeta local y copiando la salida por un método preferido en una carpeta de aplicación preparada en IIS.

(Opcional) Implementación mediante un archivo de configuración de publicación

Puede usar esta opción para crear un archivo de configuración de publicación e importarlo en Visual Studio.

Nota

Si desea configurar Web Deploy manualmente en lugar de importar la configuración de publicación, deberá asegurarse de que una carpeta de aplicación en el servidor esté configurada con los valores y permisos correctos (consulte Configurar ASP.NET sitio web).

Instalación y configuración de Web Deploy en Windows Server

Web Deploy proporciona características de configuración adicionales que permiten la creación del archivo de configuración de publicación desde la interfaz de usuario.

Nota

El Instalador de plataforma web alcanzó el final del ciclo de vida el 1/7/22. Para más información, vea Instalador de plataforma web: fin del soporte técnico y puesta en ejecución de la fuente de productos o aplicaciones. Puede instalar directamente Web Deploy 4.0 para crear el archivo de configuración de publicación.

1. Si aún no ha instalado Herramientas y scripts de administración de IIS, hágalo ahora.

   Vaya a Seleccionar roles de servidor>Servidor web (IIS)>Herramientas de administración y después seleccione el rol Herramientas y scripts de administración de ISS, haga clic en Siguiente y después instale el rol.

   

   Los scripts y las herramientas son necesarios para habilitar la generación del archivo de configuración de publicación.

   Asegúrese de instalar también el servicio de administración de y la consola de administración de IIS (es posible que ya estén instalados).

2. En Windows Server, descargue Web Deploy 4.0.

3. Ejecute el programa de instalación de Web Deploy y asegúrese de seleccionar el tipo de instalación Completa en lugar de una instalación típica.

   Con una instalación completa, obtendrá los componentes que necesita para generar un archivo de configuración de publicación. (Si elige Custom en su lugar, puede ver la lista de componentes, como se muestra en la ilustración siguiente).

   captura de pantalla de

4. (Opcional) Compruebe que Web Deploy se está ejecutando correctamente abriendo Panel de control > Sistema y seguridad > Herramientas administrativas > Servicesy, a continuación, asegúrese de que:

   • Servicio de Agente de Implementación Web se está ejecutando (el nombre del servicio es diferente en versiones anteriores).

   • Servicio de administración web se está ejecutando.

   Si uno de los servicios del agente no se está ejecutando, reinicie el servicio Agente de implementación web.

   Si el servicio Agente de implementación web no está presente en absoluto, vaya a Panel de Control > Programas > Desinstalar un programa y busque Microsoft Web Deploy <versión>. Elija Cambiar la instalación y asegúrese de que elige Will be installed to the local hard drive (Se instalará en la unidad de disco duro local) para los componentes de Web Deploy. Complete los pasos de instalación de cambios.

Crear el archivo de configuración de publicación en IIS en Windows Server

1. Cierre y vuelva a abrir la consola de administración de IIS para mostrar las opciones de configuración actualizadas en la interfaz de usuario.

2. En IIS, haga clic en el Sitio web predeterminado, elija Implementar>Configurar publicación de implementación en Web Deploy.

   

   Si no ve el menú Implementar, consulte la sección anterior para comprobar que Web Deploy se está ejecutando.

3. En el cuadro de diálogo Configurar implementación de publicación en Web Deploy, examine la configuración.

4. Haga clic en Configuración.

   En el panel Resultados, el resultado muestra que los derechos de acceso se conceden al usuario especificado y que se ha generado un archivo con una extensión .publishsettings en la ubicación que se muestra en el cuadro de diálogo.

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

   En función de la configuración de Windows Server e IIS, verá valores diferentes en el archivo XML. Estos son algunos detalles sobre los valores que ve:

   • El archivo msdeploy.axd al que se hace referencia en el atributo publishUrl es un archivo de controlador HTTP generado dinámicamente para Web Deploy. (Con fines de prueba, http://myhostname:8172 generalmente también funciona).

   • El puerto publishUrl se establece en el puerto 8172, que es el valor predeterminado de Web Deploy.

   • El puerto destinationAppUrl se establece en el puerto 80, que es el valor predeterminado para IIS.

   • Si, en pasos posteriores, no puede conectarse al host remoto desde Visual Studio mediante el nombre de host, pruebe la dirección IP del servidor en lugar del nombre de host.

     Nota

     Si va a publicar en IIS que se ejecuta en una máquina virtual de Azure, debe abrir un puerto de entrada para Web Deploy e IIS en el grupo Seguridad de red. Para obtener información detallada, consulte Abrir puertos en una máquina virtual.

5. Copie este archivo en el equipo donde se ejecuta Visual Studio.

Importación de la configuración de publicación en Visual Studio e implementación

1. En el equipo donde tiene abierto el proyecto de ASP.NET en Visual Studio, haga clic con el botón derecho en el proyecto en el Explorador de soluciones y elija Publicar.

   Si ha configurado previamente algún perfil de publicación, aparece el panel Publicar. Haga clic en Nuevo o en Crear nuevo perfil.

2. Seleccione la opción para importar un perfil.

   En el cuadro de diálogo Importar, haga clic en Importar perfil.

   

3. Vaya a la ubicación del archivo de configuración de publicación que creó en la sección anterior.

4. En el cuadro de diálogo Importar archivo de configuración de publicación, vaya al perfil que creó en la sección anterior, selecciónelo y haga clic en Abrir.

   Haga clic en Finalizar para guardar el perfil de publicación y, a continuación, haga clic en Publicar.

   Visual Studio inicia el proceso de implementación y la ventana Salida muestra el progreso y los resultados.

   Si recibe algún error de implementación, haga clic en Más acciones>Editar para editar la configuración. Modifique la configuración y haga clic en Validar para probar la nueva configuración. Si no se encuentra el nombre de host, intente la dirección IP en lugar del nombre de host en los campos Servidor y Dirección URL de destino.

   

Una vez que la aplicación se implemente correctamente, debería iniciarse automáticamente. Si la aplicación no se inicia después de la implementación, inicie la aplicación en IIS para comprobar que se ejecuta correctamente.

Cuando tenga todo listo, cambie a una configuración de depuración.

Importante

Si elige depurar una configuración de versión, deshabilite la depuración en el archivo web.config al realizar la publicación.

1. Seleccione Más opciones>Editar para editar el perfil y, a continuación, seleccione Configuración.
2. Seleccione una configuración de depuración y, a continuación, Quitar archivos adicionales en el destino en las opciones de publicación de archivos.
3. Seleccione Guardar y vuelva a publicar la aplicación.

Advertencia

El uso de credenciales de nombre de usuario y contraseña (autenticación básica) no es el método de autenticación más seguro. Siempre que sea posible, use métodos alternativos. Por ejemplo, considere la posibilidad de publicar en un paquete desde Visual Studio y, a continuación, use WebDeploy.exe desde una línea de comandos para implementar el paquete. Con ese método, puede usar el Administrador de IIS para configurar usuarios autorizados de Windows que pueden publicar en el servidor web y ejecutar WebDeploy.exe en esa cuenta de usuario de Windows. Consulte instalación y configuración de Web Deploy en IIS 8.0 o posterior. Si usa credenciales de contraseña, asegúrese de usar una contraseña segura y de proteger la contraseña de que se filtre o comparta.

(Opcional) Implementación mediante la publicación en una carpeta local

Puede usar esta opción para implementar la aplicación si desea copiar la aplicación en IIS mediante PowerShell, RoboCopy o desea copiar manualmente los archivos.

Configurar el sitio web de ASP.NET en el equipo con Windows Server

1. Abra el Explorador de Windows y cree una nueva carpeta, C:\Publish, donde posteriormente implementará el proyecto de ASP.NET.

2. Si todavía no está abierto, abra el nodo Administrador de Internet Information Services (IIS). (En el panel izquierdo del Administrador del servidor, seleccione IIS. Haga clic con el botón derecho en el servidor y seleccione Administrador de Internet Information Services (IIS)).

3. En el panel de la izquierda, bajo Conexiones, vaya a Sitios.

4. Seleccione el sitio web predeterminado , elija Configuración básica, y establezca la ruta de acceso física como C:\Publish.

5. Haga clic con el botón derecho en el nodo Sitio Web Predeterminado y seleccione Agregar aplicación.

6. Establezca el campo Alias en MyASPApp, acepte el grupo de aplicaciones predeterminado (DefaultAppPool) y establezca la Ruta de acceso física en C:\Publish.

7. En Conexiones, seleccione Grupos de aplicaciones. Abra DefaultAppPool y establezca el campo Grupo de aplicaciones en ASP.NET v4.0 (ASP.NET 4.5 no es una opción para el grupo de aplicaciones).

8. Con el sitio seleccionado en el Administrador de IIS, elija Editar permisos y asegúrese de que IUSR, IIS_IUSRS o el usuario configurado para el acceso a la aplicación web sea un usuario autorizado con permisos de lectura y ejecución.

   Si no ve uno de estos usuarios con acceso, siga los pasos para agregar IUSR como usuario con derechos Leer y ejecutar.

Importante

Para obtener información de seguridad relacionada con las cuentas integradas, vea Understanding Built-In User and Group Accounts in IIS 7.

Publicación e implementación de la aplicación mediante la publicación en una carpeta local desde Visual Studio

También puede publicar e implementar la aplicación mediante el sistema de archivos u otras herramientas.

Para ASP.NET 4.8, asegúrese de que el archivo web.config muestra la versión correcta de .NET.

• Si tiene como destino ASP.NET 4.8, asegúrese de que este valor de versión aparece en el archivo 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>
      ```
  
  

• Si instala ASP.NET 4 en lugar de 4.8, el valor de versión debe especificarse como 4.0 en el archivo web.config.

Siga estos pasos para publicar e implementar la aplicación:

1. En el explorador de soluciones de . Haga clic con el botón derecho en el nodo del proyecto y seleccione Publicar (para Formularios web, Publicar aplicación web).

   Si ha configurado previamente algún perfil de publicación, aparece el panel Publicar. Haga clic en Nuevo perfil.

2. En el cuadro de diálogo Publicar, seleccione Carpeta, haga clic en Examinary cree una nueva carpeta, C:\Publish.

   

   Haga clic en Finalizar para guardar el perfil de publicación.

3. Cambie a una configuración de depuración.

   Elija Editar para editar el perfil y, a continuación, seleccione Configuración. Elija una configuración de depuración y, después, en Quitar archivos adicionales en destino en las Opciones de publicación de archivos.

   

   Nota

   Si usa una compilación de versión, deshabilite la depuración en el archivo web.config al realizar la publicación.

4. Haga clic en Publicar.

   La aplicación publica una configuración de Depurar del proyecto en la carpeta local. El progreso se muestra en la ventana Salida.

5. Copie el directorio del proyecto de ASP.NET del equipo de Visual Studio en el directorio local configurado para la aplicación ASP.NET (en este ejemplo, C:\Publish) en el equipo con Windows Server. En este tutorial, se supone que va a copiar manualmente, pero puede usar otras herramientas como PowerShell, Xcopy o Robocopy.

   Cautela

   Si necesita realizar cambios en el código o volver a generarlo, debe volver a publicar y repetir este paso. El archivo ejecutable que copió en el equipo remoto debe coincidir exactamente con el origen local y los símbolos. Si no lo hace, recibirá una advertencia de cannot find or open the PDB file en Visual Studio al intentar depurar el proceso.

6. En Windows Server, compruebe que puede ejecutar la aplicación correctamente abriendo la aplicación en el explorador.

   Si la aplicación no se ejecuta correctamente, puede haber una discrepancia entre la versión de ASP.NET instalada en el servidor y el equipo de Visual Studio, o es posible que tenga un problema con la configuración del sitio web o IIS. Vuelva a comprobar los pasos anteriores.

Descargar e instalar las herramientas remotas en Windows Server

Descargue la versión de las herramientas remotas que coincidan con la versión de Visual Studio.

En el dispositivo o servidor remoto en el que desea depurar, en lugar de en el equipo de Visual Studio, descargue e instale la versión correcta de las herramientas remotas desde los vínculos de la tabla siguiente.

• Descargue la actualización más reciente de las herramientas remotas para la versión de Visual Studio. Las versiones anteriores de las herramientas remotas no son compatibles con versiones posteriores de Visual Studio. (Por ejemplo, si usa Visual Studio 2019, descargue la actualización más reciente de las herramientas remotas para Visual Studio 2019. En este escenario, no descargue las herramientas remotas para Visual Studio 2022).
• Descargue las herramientas remotas con la misma arquitectura que la máquina en la que los va a instalar. Por ejemplo, si desea depurar aplicaciones x86 en un equipo remoto que ejecuta un sistema operativo x64, instale las herramientas remotas x64. Para depurar aplicaciones x86, ARM o x64 en un sistema operativo ARM64, instale las herramientas remotas arm64.

Versión	Link	Notas
Visual Studio 2022	Herramientas remotas	Compatible con todas las versiones de Visual Studio 2022. Descargue la versión que coincida con el sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. En versiones anteriores de Windows Server, consulte Desbloquear la descarga de archivos para obtener ayuda con la descarga de las herramientas remotas.
Visual Studio 2019	Herramientas remotas	Las herramientas remotas para Visual Studio 2019 están disponibles en My.VisualStudio.com. Si se le solicita, únase al programa gratis Visual Studio Dev Essentials o inicie sesión con el identificador de suscripción de Visual Studio. Descargue la versión que coincida con el sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. En versiones anteriores de Windows Server, consulte Desbloquear la descarga de archivos para obtener ayuda con la descarga de las herramientas remotas.
Visual Studio 2017	Herramientas remotas	Las herramientas remotas para Visual Studio 2017 están disponibles en My.VisualStudio.com. Si se le solicita, únase al programa gratis Visual Studio Dev Essentials o inicie sesión con el identificador de suscripción de Visual Studio. Descargue la versión que coincida con el sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. En Windows Server, consulte Desbloquear la descarga de archivos para obtener ayuda para descargar las herramientas remotas.
Visual Studio 2015	Herramientas remotas	Las herramientas remotas para Visual Studio 2015 están disponibles en My.VisualStudio.com. Si se le solicita, únase al programa gratis Visual Studio Dev Essentials o inicie sesión con el identificador de suscripción de Visual Studio. En Windows Server, consulte Desbloquear la descarga de archivos para obtener ayuda con la descarga de las herramientas remotas.
Visual Studio 2013	Herramientas remotas	Página de descarga en la documentación de Visual Studio 2013
Visual Studio 2012	Herramientas remotas	Página de descarga en la documentación de Visual Studio 2012

Puede ejecutar el depurador remoto mediante la copia de msvsmon.exe en el equipo remoto, en lugar de instalar las herramientas remotas. Sin embargo, el Asistente para configuración del depurador remoto (rdbgwiz.exe) solo está disponible cuando se instalan las herramientas remotas. Es posible que tenga que usar el Asistente para configuración si desea ejecutar el depurador remoto como un servicio. Para más información, vea (Opcional) Configuración del depurador remoto como servicio.

Nota

• Para depurar aplicaciones de Windows 10 o posteriores en dispositivos ARM, use ARM64, que está disponible con la versión más reciente de las herramientas remotas.
• Para depurar aplicaciones de Windows 10 en dispositivos Windows RT, use ARM, que solo está disponible en la descarga de herramientas remotas de Visual Studio 2015.
• Para depurar aplicaciones x64 en un sistema operativo ARM64, ejecute el archivo x64 msvsmon.exe instalado con las herramientas remotas ARM64.

Establecimiento del depurador remoto en Windows Server

1. En el equipo remoto, busque e inicie Remote Debugger en el menú Inicio.

   Si no tiene permisos administrativos en el equipo remoto, haga clic con el botón derecho en la aplicación Remote Debugger y seleccione Ejecutar como administrador. De lo contrario, simplemente empiece normalmente.

   Si planea adjuntarse a un proceso que se ejecuta como administrador o en otra cuenta de usuario (como IIS), haga clic con el botón derecho en la aplicación Depurador Remoto y seleccione Ejecutar como administrador. Para obtener más información, vea Ejecución del depurador remoto como administrador.

2. La primera vez que inicie el depurador remoto (o antes de configurarlo), aparecerá el asistente de configuración de depuración remota. Asistente de Configuración de Depuración Remota.

   En la mayoría de los escenarios, elija Siguiente hasta que llegue a la página Configurar firewall de Windows del asistente.

   

3. Seleccione al menos un tipo de red en el que quiera usar las herramientas remotas. Si los equipos están conectados a través de un dominio, debe elegir el primer elemento. Si los equipos están conectados a través de un grupo de trabajo o grupo principal, elija el segundo o tercer elemento según corresponda.

   A continuación, seleccione Finalizar para iniciar el depurador remoto.

4. Cuando se completa la configuración, aparecerá la ventana Remote Debugger.

   

   El depurador remoto ahora está esperando una conexión. Use el nombre del servidor y el número de puerto que se muestran para establecer la configuración de conexión remota en Visual Studio.

Para detener el depurador remoto, seleccione Archivo>Salir. Puede reiniciarlo desde el menú Inicio o desde la línea de comandos:

<Remote debugger installation directory>\msvsmon.exe

Nota

Si necesita agregar permisos para usuarios adicionales, cambie el modo de autenticación o el número de puerto del depurador remoto, consulte Configurar el depurador remoto.

Para obtener información sobre cómo ejecutar el depurador remoto como servicio, consulte Ejecutar el depurador remoto como servicio.

Adjuntar elementos a la aplicación ASP.NET desde el equipo de Visual Studio

A partir de la versión 17.10 preview 2 de Visual Studio 2022, el cuadro de diálogo Asociar al proceso ha cambiado. Si necesita instrucciones que coincidan con el cuadro de diálogo anterior, cambie a la vista de Visual Studio 2019 (selector de versión superior izquierda del artículo).

1. En el equipo de Visual Studio, abra la solución que intenta depurar (MyASPApp si está siguiendo todos los pasos de este artículo).

2. En Visual Studio, seleccione Depurar > Asociar al proceso (Ctrl + Alt + P).

   Sugerencia

   En Visual Studio 2017 y versiones posteriores, puede volver a asociarla al mismo proceso que antes mediante Depurar > Reasociar al proceso... (Mayús + Alt + P).

3. Establezca el Tipo de Conexión en Remoto (Windows).

   Aparece la opción Destino de conexión.

   Establezca el Destino de conexión en <nombre de equipo remoto> y presione Entrar.

   Compruebe que Visual Studio agrega el puerto necesario al nombre del equipo, que aparece en el formato: <nombre del equipo remoto>:puerto

   En Visual Studio 2022, debería ver <nombre del equipo remoto >:4026

   El puerto es necesario. Si no ve el número de puerto, agréguelo manualmente.

4. Seleccione Actualizar.

   Debería ver que algunos procesos aparecen en la ventana Procesos disponibles.

   Si no ve ningún proceso, intente usar la dirección IP en lugar del nombre del equipo remoto (el puerto es necesario). Puede usar ipconfig en una línea de comandos para obtener la dirección IPv4.

   Si desea usar el botón Buscar, es posible que tenga que abrir el puerto UDP de salida 3702 en el servidor.

5. Active Mostrar los procesos de todos los usuarios.

6. Escriba la primera letra de un nombre de proceso para buscar rápidamente w3wp.exe para ASP.NET 4.5.

   Si tiene varios procesos que muestran w3wp.exe, compruebe la columna Nombre de usuario. En algunos escenarios, la columna Nombre de usuario muestra el nombre del grupo de aplicaciones, como IIS APPPOOL\DefaultAppPool. Si ve el grupo de aplicaciones, una manera sencilla de identificar el proceso correcto es crear un nuevo grupo de aplicaciones denominado para la instancia de aplicación que desea depurar y, a continuación, puede encontrarlo fácilmente en la columna Nombre de usuario.

   

7. Seleccione Asociar.

8. Abra el sitio web del equipo remoto. En un explorador, vaya a http://<nombre del equipo remoto>.

   Deberías ver la página web de ASP.NET.

9. En la aplicación de ASP.NET en ejecución, seleccione el vínculo a la página de Privacidad .

   El punto de interrupción debe alcanzarse en Visual Studio.

   Si no puede adjuntar ni alcanzar el punto de interrupción, consulte Solución de problemas de la depuración remota.

Solución de problemas de implementación de IIS

• Si no puede conectarse al host mediante el nombre de host, pruebe la dirección IP en su lugar.
• Asegúrese de que los puertos necesarios están abiertos en el servidor remoto.
• Compruebe que la versión de ASP.NET usada en la aplicación es la misma que la versión que instaló en el servidor. Para la aplicación, puede consultar y establecer la versión en la página Propiedades. Para establecer la aplicación en otra versión, debe instalarse esa versión.
• Si la aplicación intentó abrirse, pero aparece una advertencia de certificado, elija confiar en el sitio. Si ya cerró la advertencia, puede editar el perfil de publicación, un archivo *.pubxml, en su proyecto y agregar el siguiente elemento (solo para pruebas): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Después de implementarla, inicie la aplicación en IIS para probar que se implementó correctamente.
• Compruebe la ventana Salida de Visual Studio para obtener información de estado y compruebe los mensajes de error.

Apertura de puertos necesarios en Windows Server

En la mayoría de las configuraciones, los puertos necesarios se abren mediante la instalación de ASP.NET y el depurador remoto. Sin embargo, es posible que tenga que comprobar que los puertos están abiertos.

Nota

En una máquina virtual de Azure, debe abrir puertos a través del grupo de seguridad de red .

Puertos necesarios:

• 80: Necesario para IIS.

• 4026: obligatorio para la depuración remota desde Visual Studio 2022 (vea Asignaciones de puertos del depurador remoto para obtener más información).

• 4024: obligatorio para la depuración remota desde Visual Studio 2019 (vea Asignaciones de puertos del depurador remoto para obtener más información).

• UDP 3702: (opcional) el puerto de detección habilita el botón Buscar al adjuntarse al depurador remoto en Visual Studio.

Además, estos puertos ya deben estar abiertos por la instalación de ASP.NET:

• 8172: (Opcional) Necesario para web Deploy para implementar la aplicación desde Visual Studio.

Abrir un puerto

1. Para abrir un puerto en Windows Server, abra el menú Inicio , busque Firewall de Windows Defender o Firewall de Windows con seguridad avanzada.

   Para Firewall de Windows Defender, elija Configuración avanzada.

2. Después, elija Reglas de entrada > Nueva regla > Puerto. Elija Siguiente y, en Puertos locales específicos, introduzca el número de puerto, seleccione Siguiente, luego Permitir la Conexión, seleccione Siguiente y agregue el nombre (IIS, Web Deploy, o msvsmon) para la regla de entrada.

   Si quiere más información sobre cómo configurar el Firewall de Windows, vea Configuración del Firewall de Windows para la depuración remota.

3. Cree más reglas para los otros puertos necesarios.