Depuración remota

Puede depurar una aplicación de Visual Studio que se ha implementado en otro equipo. Para hacerlo, se usa el depurador remoto de Visual Studio.

Para obtener instrucciones detalladas sobre la depuración remota, vea estos temas.

Si solo quiere descargar e instalar el depurador remoto y no necesita instrucciones adicionales para su escenario, siga los pasos descritos en este artículo.

Descarga e instalación de las herramientas remotas

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

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 de 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.

Requisitos

Sistemas operativos compatibles

El equipo remoto debe ejecutar uno de los siguientes sistemas operativos:

• Windows 11

• Windows 10 (no teléfono)

• Windows 8 o 8.1 (no teléfono)

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 o Windows Server 2012 R2

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

Configuraciones de hardware admitidas

• Procesador de 1,6 GHz o más rápido

• 1 GB de RAM (1,5 GB si se ejecuta en una máquina virtual)

• 1 GB de espacio disponible en disco duro

• Disco duro de 5400 RPM

• Tarjeta de vídeo compatible con DirectX 9 que se ejecuta a 1024 x 768 o una resolución de pantalla superior

Configuración de red

El equipo remoto y el equipo Visual Studio deben estar conectados a través de una red, un grupo de trabajo o un grupo hogar, o bien conectados directamente a través de un cable Ethernet. 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 inaceptablemente lenta.

(Opcional) Para ejecutar el depurador remoto desde una compartición de archivos

Puede encontrar el depurador remoto (msvsmon.exe) en un equipo con Visual Studio Community, Professional o Enterprise ya instalado. En algunos escenarios, la manera más sencilla de configurar la depuración remota es ejecutar el depurador remoto (msvsmon.exe) desde un recurso compartido de archivos. Para ver las limitaciones de uso, consulte la página de ayuda del depurador remoto (Ayuda Uso en el depurador remoto).

1. Busque msvsmon.exe en el directorio que coincida con la versión de Visual Studio:

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. Comparta la carpeta Remote Debugger en el equipo Visual Studio.

3. En el equipo remoto, ejecute msvsmon.exe desde la carpeta compartida. Siga las instrucciones de configuración de .

Configurar el depurador remoto

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 Depurador Remoto, y seleccione Ejecutar como administrador. De lo contrario, simplemente empiece normalmente.

   Si tiene previsto realizar una asociación a un proceso que se ejecuta como administrador o se ejecuta en una cuenta de usuario diferente (como IIS), haga clic con el botón derecho en la aplicación Remote Debugger 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 Configuración de Depuración Remota.

   En la mayoría de los escenarios, seleccione Configurar depuración remota.

   Captura de pantalla de la configuración del depurador remoto.Configuración del depurador remoto de configuración del depurador remoto

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

   Captura de pantalla de la configuración del depurador remoto.Configuración del depurador remoto de configuración del depurador remoto

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.

   Captura de pantalla de la ventana del depurador remotoVentana Depurador remoto

   Captura de pantalla de la ventana del depurador remotoVentana Depurador remoto

   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 ArchivoSalir. Puede reiniciarlo desde el menú Inicio o desde la línea de comandos:

<Remote debugger installation directory>\msvsmon.exe

Configurar el depurador remoto

Puede cambiar algunos aspectos de la configuración del depurador remoto después de iniciarlo por primera vez.

• Si necesita agregar permisos para que otros usuarios se conecten al depurador remoto, elija Herramientas Permisos. Debe tener privilegios de administrador para conceder o denegar permisos.

  Importante

  Puede ejecutar el depurador remoto en una cuenta de usuario que difiere de la cuenta de usuario que usa en el equipo Visual Studio, pero debe agregar la cuenta de usuario diferente a los permisos del depurador remoto.

  Como alternativa, puede iniciar el depurador remoto desde la línea de comandos con el parámetro /allow nombredeusuario: msvsmon /allow nombredeusuario@ordenador.

• Si necesita cambiar el modo de autenticación o el número de puerto, o especificar un valor de tiempo de espera para las herramientas remotas: elija Herramientas Opciones.

  Para obtener una lista de los números de puerto que se usan de forma predeterminada, consulte Asignaciones de puertos del depurador remoto.

  Advertencia

  Puede optar por ejecutar las herramientas remotas en modo Sin autenticación, pero no se recomienda este modo. No hay ninguna seguridad de red cuando se ejecuta en este modo. Elija el modo Sin autenticación solo si está seguro de que la red no está en riesgo de tráfico malintencionado o hostil.

Configuración de Visual Studio para la depuración remota

Para obtener instrucciones detalladas para conectarse a la aplicación desde Visual Studio, use los vínculos relacionados con su escenario específico al principio de este artículo.

Algunos escenarios requieren el uso de Adjuntar al Proceso para conectarse a una aplicación remota que ya se ha iniciado. Sin embargo, para aplicaciones de .NET Core, .NET 5+, .NET Framework y C++, puede iniciar la aplicación remota desde Visual Studio configurando las propiedades del proyecto e iniciando el depurador. Para obtener más información, vea Depurar de forma remota un proyecto de C# o Visual Basic o Depurar de forma remota un proyecto de C++.

También puede depurar de forma remota un archivo ejecutable que no forme parte de un Visual Studio project, aunque las características de depuración admitidas dependen de la configuración, como la disponibilidad de símbolos. Para obtener más información, consulte Debug una aplicación que no forma parte de una solución de Visual Studio.

(Opcional) Configuración del depurador remoto como servicio

Para la depuración en ASP.NET y otros entornos de servidor, debe ejecutar el depurador remoto como Administrador o, en caso de querer que esté siempre en ejecución, ejecute el depurador remoto como un servicio.

Si desea configurar el depurador remoto como servicio, siga estos pasos.

1. Busque el Asistente para configuración del depurador remoto (rdbgwiz.exe). (Se trata de una aplicación independiente del depurador remoto). Solo está disponible cuando se instalan las herramientas remotas. No se instala con Visual Studio.

2. Empiece a ejecutar el Asistente para configuración. Cuando aparezca la primera página, haga clic en Siguiente.

3. Active la casilla Run the Visual Studio Remote Debugger as a service.

4. Agregue el nombre de la cuenta de usuario y la contraseña.

   Es posible que necesite agregar el derecho de usuario Iniciar sesión como servicio a esta cuenta. Para ello, busque Directiva de seguridad local (secpol.msc) en la ventana o la página Iniciar, o bien escriba secpol en un símbolo del sistema. Cuando aparezca la ventana, haga doble clic en Asignación de derechos de usuarioy, a continuación, busque Iniciar sesión como un servicio en el panel derecho. Haga doble clic en él. Agregue la cuenta de usuario a la ventana Propiedades y haga clic en Aceptar. Haga clic en Siguiente.

5. Seleccione el tipo de red con el que desea que las herramientas remotas se comuniquen. Debe seleccionarse al menos un tipo de red. 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 un grupo en el hogar, debe elegir el segundo o tercer elemento. Haga clic en Siguiente.

6. Si se puede iniciar el servicio, verá Ha completado correctamente el Asistente de configuración del depurador remoto de Visual Studio. Si no se puede iniciar el servicio, verá No se pudo completar el Asistente para la Configuración del Depurador Remoto de Visual Studio. La página también proporciona algunas sugerencias para seguir para que se inicie el servicio.

7. Haga clic en Finalizar.

   En este momento, el depurador remoto se ejecuta como servicio. Para comprobarlo, vaya a Control Panel > Services y busque Visual Studio Depurador remoto.

   Puede detener e iniciar el servicio del depurador remoto desde el Panel de control > Servicios.

Configuración de la depuración con símbolos remotos

Debería poder depurar su código con los símbolos que genere en el equipo con Visual Studio. El rendimiento del depurador remoto es mucho mejor cuando se usan símbolos locales. Si tiene que usar símbolos remotos, deberá indicar al monitor de depuración remota que busque símbolos en el equipo remoto.

Puede usar el siguiente modificador de línea de comandos msvsmon para usar símbolos remotos para código administrado:

Para más información, vea la ayuda de depuración remota (presione F1 en la ventana del depurador remoto, o haga clic en Ayuda Uso).

Contenido relacionado

• Primer vistazo al depurador
• Configurar el Firewall de Windows para la depuración remota
• Asignaciones de puertos del depurador remoto
• Depuración remota de ASP.NET Core en un equipo remoto con IIS
• Errores de la depuración remota y sus soluciones