Le pack d’hébergement .NET Core

  • Article

Le pack d’hébergement .NET Core est un programme d’installation pour le runtime .NET Core et le module ASP.NET Core. Le pack permet aux applications ASP.NET Core de s’exécuter avec IIS.

Installer le bundle d’hébergement .NET Core

Important

Si le bundle d’hébergement est installé avant IIS, l’installation du bundle doit être réparée. Après avoir installé IIS, réexécutez le programme d’installation du bundle d’hébergement.

Si le bundle d’hébergement est installé après l’installation de la version 64 bits (x 64) de .NET Core, les SDK peuvent apparaître manquants (Aucun SDK .NET Core n’a été détecté). Pour résoudre le problème, consultez Résoudre les problèmes et effectuer le débogage des projets ASP.NET Core.

Les changements cassants et les avis de sécurité sont signalés dans le référentiel Annonces. Les annonces peuvent être limitées à une version spécifique en sélectionnant un filtre Étiquette.

Téléchargement direct

Téléchargez le programme d’installation à l’aide des liens suivants :

Exigences de Visual C++ Redistributable

Sur les versions antérieures de Windows, par exemple Windows Server 2012 R2, installez Visual Studio C++ 2015, 2017, 2019 Redistributable. Sinon, un message d’erreur confus dans le journal des événements Windows signale que The data is the error.

VS C++ redistributable x64 actuelVS C++ redistributable x86 actuel

Versions antérieures du programme d’installation

Pour obtenir une version antérieure du programme d’installation :

  1. Accédez à la page Télécharger .NET Core.
  2. Sélectionnez la version souhaitée de .NET Core.
  3. Dans la colonne Run apps - Runtime, recherchez la ligne de la version du runtime .NET Core souhaitée.
  4. Téléchargez le programme d’installation à l’aide du lien Bundle de téléchargement.

Avertissement

Certains programmes d’installation contiennent des versions qui sont arrivées à leur fin de vie (EOL) et qui ne sont plus prises en charge par Microsoft. Pour plus d’informations, consultez la politique de support.

Le module ASP.NET Core assure la compatibilité descendante et ascendante avec les versions avec support technique de .NET.

Options

  1. Les paramètres suivants sont disponibles lorsque vous exécutez le programme d’installation à partir d’un shell de commande administrateur :

    • OPT_NO_ANCM=1 : Permet d’ignorer l’installation du module ASP.NET Core.
    • OPT_NO_RUNTIME=1 : Permet d’ignorer l’installation du runtime .NET Core. Utilisé quand le serveur héberge uniquement des déploiements autonomes (SCD).
    • OPT_NO_SHAREDFX=1 : Permet d’ignorer l’installation du framework partagé ASP.NET (runtime ASP.NET). Utilisé quand le serveur héberge uniquement des déploiements autonomes (SCD).
    • OPT_NO_X86=1 : Permet d’ignorer l’installation des runtimes x86. Utilisez ce paramètre lorsque vous savez que vous n’hébergerez pas d’applications 32 bits. Si vous n’excluez pas d’avoir à héberger des applications 32 bits et 64 bits dans le futur, n'utilisez pas ce paramètre et installez les deux runtimes.
    • OPT_NO_SHARED_CONFIG_CHECK=1 : Permet de désactiver la vérification de l’utilisation d’une configuration partagée d’IIS quand la configuration partagée (applicationHost.config) se trouve sur la même machine que l’installation d’IIS. Disponible uniquement pour les programmes d’installation du pack d’hébergement ASP.NET Core 2.2 ou version ultérieure. Pour plus d’informations, consultez Configuration avancée.

Remarque

Pour plus d’informations sur la configuration partagée IIS, consultez Module ASP.NET Core avec configuration partagée des services Internet (IIS).

Remarque

Lors de l’exécution du programme d’installation du pack d’hébergement avec des options définies, la valeur de chaque option est inscrite dans le Registre. Les installations suivantes de la même bande de version Majeure.Mineure utilisent les mêmes options, sauf si un autre ensemble d’options est explicitement transmis à partir de la ligne de commande. Si aucune option n’a été transmise à la première installation du pack d’hébergement, chaque option reçoit une valeur par défaut de 0 écrite dans le Registre. La valeur de 0 implique que l’option est désactivée, ce qui signifie que l’utilisateur ne se désinscrit pas du composant donné.

Redémarrez IIS

Une fois le pack d’hébergement installé, un redémarrage manuel d’IIS peut être nécessaire. Par exemple, l’outil CLI dotnet (commande) n’existe peut-être pas sur le chemin d’accès pour exécuter des processus de travail IIS.

Pour redémarrer manuellement IIS, arrêtez le service d’activation des processus Windows (WAS), puis redémarrez le service W3SVC (World Wide Web Publishing Service) et tous les services dépendants. Exécutez les commandes suivantes dans un interpréteur de commandes avec élévation de privilèges :

net stop was /y
net start w3svc

Version du module et journaux du programme d’installation du bundle d’hébergement

Pour déterminer la version du module ASP.NET Core installé :

  1. Sur le système d’hébergement, accédez à %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
  2. Localisez le fichier aspnetcorev2.dll.
  3. Cliquez avec le bouton droit sur le fichier, puis sélectionnez Propriétés dans le menu contextuel.
  4. Sélectionnez l'onglet Détails. Le version du fichier et la version du produit représentent la version installée du module.

Les journaux du programme d’installation du bundle d’hébergement du module se trouvent dans C:\Users\%UserName%\AppData\Local\Temp. Le fichier est nommé dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, où l’espace réservé {TIMESTAMP} est le timestamp du fichier.