Le pack d’hébergement .NET Core
Remarque
Ceci n’est pas la dernière version de cet article. Pour la version actuelle, consultez la version .NET 9 de cet article.
Avertissement
Cette version d’ASP.NET Core n’est plus prise en charge. Pour plus d’informations, consultez la stratégie de support .NET et .NET Core. Pour la version actuelle, consultez la version .NET 9 de cet article.
Important
Ces informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.
Pour la version actuelle, consultez la version .NET 9 de cet 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 :
- Version actuelle : Programme d’installation du pack d’hébergement .NET Core (téléchargement direct)
- Versions antérieures et préversions
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 :
- Accédez à la page Télécharger .NET Core.
- Sélectionnez la version souhaitée de .NET Core.
- Dans la colonne Run apps - Runtime, recherchez la ligne de la version du runtime .NET Core souhaitée.
- 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
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é :
- Sur le système d’hébergement, accédez à
%PROGRAMFILES%\IIS\Asp.Net Core Module\V2. - Localisez le fichier
aspnetcorev2.dll. - Cliquez avec le bouton droit sur le fichier, puis sélectionnez Propriétés dans le menu contextuel.
- 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.
