Compartir vía

Conjunto de hospedaje de .NET Core

  • Artículo

Nota:

Esta no es la versión más reciente de este artículo. Para la versión actual, consulte la versión .NET 8 de este artículo.

Advertencia

Esta versión de ASP.NET Core ya no se admite. Para obtener más información, consulte la Directiva de soporte técnico de .NET y .NET Core. Para la versión actual, consulte la versión .NET 8 de este artículo.

Importante

Esta información hace referencia a un producto en versión preliminar, el cual puede sufrir importantes modificaciones antes de que se publique la versión comercial. Microsoft no proporciona ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.

Para la versión actual, consulte la versión .NET 8 de este artículo.

El conjunto de hospedaje de .NET Core es un instalador para el entorno de ejecución de .NET Core y el módulo de ASP.NET Core. El conjunto permite que las aplicaciones de ASP.NET Core se ejecuten con IIS.

Instalación del conjunto de hospedaje de .NET Core

Importante

Si el conjunto de hospedaje se instala antes que IIS, se debe reparar la instalación de dicho conjunto. Vuelva a ejecutar el instalador del conjunto de hospedaje después de instalar IIS.

Si el conjunto de hospedaje se instala después de hacer lo propio con la versión de 64 bits (x64) de .NET Core, es posible que los SDK no estén disponibles (No se ha detectado ningún SDK de .NET Core). Para resolver el problema, consulte Solución de problemas y depuración de proyectos de ASP.NET Core.

Los cambios importantes y los avisos de seguridad se notifican en el repositorio de anuncios. Los anuncios se pueden limitar a una versión específica seleccionando un filtro de etiqueta.

Descarga directa

Descargue al instalador mediante el siguiente enlace:

Requisito de Visual C++ Redistributable

En versiones anteriores de Windows, por ejemplo, Windows Server 2012 R2, instale Visual Studio C++ 2015, 2017, 2019 Redistributable. De lo contrario, un mensaje de error confuso en el registro de eventos de Windows informa de que The data is the error.

VS C++ Redistributable actual para x64VS C++ Redistributable actual para x86

Versiones anteriores del instalador

Para obtener una versión anterior del instalador:

  1. Vaya a la página Descarga de .NET Core.
  2. Seleccione la versión de .NET Core que quiera.
  3. En la columna Run apps - Runtime (Ejecutar aplicaciones - Runtime), busque la fila de la versión del runtime de .NET Core que quiera instalar.
  4. Descargue el instalador mediante el vínculo del conjunto de hospedaje.

Advertencia

Algunos instaladores contienen versiones que han alcanzado el final del ciclo de vida (EOL) y ya no son compatibles con Microsoft. Para obtener más información, consulte la política de soporte técnico.

El módulo ASP.NET Core es compatible con versiones anteriores y posteriores de las versiones con soporte técnico de .NET.

Opciones

  1. Los parámetros siguientes están disponibles cuando se ejecuta el instalador desde un shell de comandos de administrador:

    • OPT_NO_ANCM=1: omite la instalación del módulo de ASP.NET Core.
    • OPT_NO_RUNTIME=1: omite la instalación del entorno de ejecución de .NET Core. Se usa si el servidor solo hospeda implementaciones autocontenidas (SCD).
    • OPT_NO_SHAREDFX=1: omite la instalación del marco compartido de ASP.NET (entorno de ejecución de ASP.NET). Se usa si el servidor solo hospeda implementaciones autocontenidas (SCD).
    • OPT_NO_X86=1: omite la instalación de entornos de ejecución x86. Utilice este parámetro cuando sepa que no va a hospedar aplicaciones de 32 bits. Si hay alguna posibilidad de que vaya a hospedar aplicaciones de 32 bits y 64 bits en el futuro, no use este parámetro e instale ambos entornos de ejecución.
    • OPT_NO_SHARED_CONFIG_CHECK=1: deshabilita la comprobación para usar una configuración compartida de IIS cuando la configuración compartida (applicationHost.config) está en la misma máquina que la instalación de IIS. Solo disponible para ASP.NET Core 2.2 o instaladores del conjunto de hospedaje posteriores. Para más información, consulte Configuración avanzada.

Nota

Para obtener información sobre la configuración compartida de IIS, vea ASP.NET Core Module with IIS Shared Configuration (Módulo de ASP.NET Core con configuración compartida de IIS).

Nota

Al ejecutar el instalador del conjunto de hospedaje con las opciones establecidas, el valor de cada opción se guarda en el registro. Las posteriores instalaciones desde la misma banda de versiones Major.Minor usan las mismas opciones, a menos que se pase explícitamente otro conjunto de opciones desde la línea de comandos. Si la primera instalación del conjunto de hospedaje no tiene ninguna opción pasada, cada opción obtiene un valor predeterminado de 0 escrito en el registro. Un valor de 0 implica que la opción está desactivada, lo que significa que el usuario no está optando por no participar en el componente especificado.

Reiniciar IIS

Una vez instalado el conjunto de hospedaje, es posible que se requiera un reinicio manual de IIS. Por ejemplo, puede que las herramientas de la CLI de dotnet (comando) no existan en la ruta de acceso para ejecutar procesos de trabajo de IIS.

Para reiniciar IIS manualmente, detenga el Servicio de activación de procesos de Windows (WAS) y reinicie el servicio de publicación World Wide Web (W3SVC) y todos los servicios dependientes. Ejecute los siguientes comandos en un shell de comandos con privilegios elevados:

net stop was /y
net start w3svc

Versión del módulo y registros del instalador de la agrupación de hospedaje

Para determinar la versión instalada del módulo ASP.NET Core, siga estos pasos:

  1. En el sistema de hospedaje, vaya a %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
  2. Busque el archivo aspnetcorev2.dll.
  3. Haga clic con el botón derecho en el archivo y seleccione Propiedades en el menú contextual.
  4. Seleccione la pestaña Detalles. La versión del archivo y la versión del producto representan la versión instalada del módulo.

Los registros del instalador del conjunto de hospedaje para el módulo se encuentran en C:\Users\%UserName%\AppData\Local\Temp. El archivo se denomina dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, donde el marcador de posición {TIMESTAMP} es la marca de tiempo del archivo.