Delen via

De .NET-hostingbundel

Note

Dit is niet de nieuwste versie van dit artikel. Zie de .NET 9-versie van dit artikelvoor de huidige release.

Warning

Deze versie van ASP.NET Core wordt niet meer ondersteund. Zie de .NET- en .NET Core-ondersteuningsbeleidvoor meer informatie. Zie de .NET 9-versie van dit artikelvoor de huidige release.

Important

Deze informatie heeft betrekking op een pre-releaseproduct dat aanzienlijk kan worden gewijzigd voordat het commercieel wordt uitgebracht. Microsoft geeft geen garanties, uitdrukkelijk of impliciet, met betrekking tot de informatie die hier wordt verstrekt.

Zie de .NET 9-versie van dit artikelvoor de huidige release.

De .NET Hosting-bundel is een installatieprogramma voor .NET Runtime en de ASP.NET Core-module. Met de bundel kunnen ASP.NET Core-apps worden uitgevoerd met IIS.

De .NET Hosting Bundle installeren

Important

Als de hostingbundel vóór IIS is geïnstalleerd, moet de bundelinstallatie worden hersteld. Voer het installatieprogramma voor hostingbundel opnieuw uit nadat u IIS hebt geïnstalleerd.

Als de hostingbundel is geïnstalleerd nadat de 64-bits (x64)-versie van .NET is geïnstalleerd, lijken SDK's mogelijk te ontbreken (er zijn geen .NET SDK's gedetecteerd). Zie Problemen oplossen en fouten opsporen ASP.NET Core-projecten om het probleem op te lossen.

Belangrijke wijzigingen en beveiligingsadviezen worden gerapporteerd in de opslagplaats Aankondigingen. Aankondigingen kunnen worden beperkt tot een specifieke versie door een labelfilter te selecteren.

Direct download

Download het installatieprogramma met behulp van de volgende koppelingen:

Herdistribueerbare vereiste voor Visual C++

Installeer in oudere versies van Windows, bijvoorbeeld Windows Server 2012 R2, Visual Studio C++ 2015, 2017, 2019 Redistributable. Anders wordt een verwarrend foutbericht in het Windows-gebeurtenislogboek gerapporteerd dat The data is the error.

Huidige x64 VS C++ herdistribueerbaarHuidige x86 VS C++ herdistribueerbaar

Eerdere versies van het installatieprogramma

Een eerdere versie van het installatieprogramma verkrijgen:

  1. Navigeer naar de pagina .NET downloaden .
  2. Selecteer de gewenste .NET-versie.
  3. Zoek in de kolom Uitvoeren-apps - Runtime de rij van de gewenste .NET Runtime-versie.
  4. Download het installatieprogramma met behulp van de koppeling Hostingbundel .

Warning

Sommige installatieprogramma's bevatten releaseversies die hun einde van de levensduur (EOL) hebben bereikt en die niet meer worden ondersteund door Microsoft. Zie het ondersteuningsbeleid voor meer informatie.

De ASP.NET Core Module is compatibel met toekomstige en eerdere versies van ondersteunde releases van .NET.

Options

  1. De volgende parameters zijn beschikbaar bij het uitvoeren van het installatieprogramma vanuit een beheerdersopdrachtshell:

    • OPT_NO_ANCM=1: Sla de installatie van de ASP.NET Core-module over.
    • OPT_NO_RUNTIME=1: Sla de installatie van de .NET-runtime over. Wordt gebruikt wanneer de server alleen zelfstandige implementaties (SCD) host.
    • OPT_NO_SHAREDFX=1: Sla het installeren van het ASP.NET Shared Framework (ASP.NET runtime) over. Wordt gebruikt wanneer de server alleen zelfstandige implementaties (SCD) host.
    • OPT_NO_X86=1: Sla het installeren van x86-runtimes over. Gebruik deze parameter als u weet dat u geen 32-bits apps host. Als er een kans is dat u in de toekomst zowel 32-bits als 64-bits apps host, gebruikt u deze parameter niet en installeert u beide runtimes.
    • OPT_NO_SHARED_CONFIG_CHECK=1: Schakel de controle uit voor het gebruik van een gedeelde IIS-configuratie wanneer de gedeelde configuratie (applicationHost.config) zich op dezelfde computer bevindt als de IIS-installatie. Alleen beschikbaar voor ASP.NET Core 2.2 of hoger Hosting Bundler installers. Zie Geavanceerde configuratie voor meer informatie.

Note

Zie ASP.NET Core Module met gedeelde IIS-configuratie voor meer informatie over gedeelde IIS-configuratie.

Note

Wanneer u het installatieprogramma hostingbundel uitvoert met opties die zijn ingesteld, wordt de waarde voor elke optie opgeslagen in het register. Volgende installaties van dezelfde Major.Minor-versiereeks gebruiken dezelfde opties, tenzij expliciet een andere set opties via de opdrachtregel wordt doorgegeven. Als de eerste installatie van de hostingbundel geen opties heeft doorgegeven, krijgt elke optie een standaardwaarde van 0 in het register geschreven. Een waarde van 0 impliceert dat de optie is uitgeschakeld, wat betekent dat de gebruiker zich niet afmeldt voor het opgegeven onderdeel.

Restart IIS

Nadat de hostingbundel is geïnstalleerd, kan een handmatige IIS-herstart vereist zijn. De CLI-hulpprogramma's (opdracht) bestaan bijvoorbeeld dotnet niet op het PAD voor het uitvoeren van IIS-werkprocessen.

Als u IIS handmatig opnieuw wilt starten, stopt u de Windows Process Activation Service (WAS) en start u de World Wide Web Publishing Service (W3SVC) en eventuele afhankelijke services opnieuw op. Voer de volgende opdrachten uit in een opdrachtshell met verhoogde bevoegdheid:

net stop was /y
net start w3svc

Installatielogboeken van moduleversie en hostingbundel

De versie van de geïnstalleerde ASP.NET Core-module bepalen:

  1. Navigeer in het hostingsysteem naar %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
  2. Zoek het aspnetcorev2.dll bestand.
  3. Klik met de rechtermuisknop op het bestand en selecteer Eigenschappen in het contextmenu.
  4. Selecteer het tabblad Details . De bestandsversie en productversie vertegenwoordigen de geïnstalleerde versie van de module.

De installatielogboeken van hostingbundels voor de module vindt u op C:\Users\%UserName%\AppData\Local\Temp. Het bestand heeft de naam dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, waarbij de tijdelijke aanduiding {TIMESTAMP} de tijdstempel van het bestand is.