Das .NET Core-Hostingbundle

  • Artikel

Das .NET Core-Hostingbundle ist ein Installer für die .NET Core Runtime und das ASP.NET Core-Modul. Mit dem Bundle können ASP.NET Core-Apps mit IIS ausgeführt werden.

Installieren des .NET Core Hosting-Pakets

Wichtig

Wenn das Hosting-Paket vor IIS installiert wird, muss die Paketinstallation repariert werden. Führen Sie nach der Installation von IIS erneut den Installer des Hosting-Pakets aus.

Wenn das Hosting-Paket nach der Installation der 64-Bit-Version (x64) von .NET Core installiert wird, kann es den Anschein haben, dass SDKs fehlen (Es wurden keine .NET Core SDKs erkannt). Informationen zum Beheben des Problems finden Sie unter Problembehandlung und Debuggen von ASP.NET Core-Projekten.

Breaking Changes und Sicherheitsempfehlungen werden im Ankündigungsrepository gemeldet. Ankündigungen können durch Auswahl eines Bezeichnungsfilters auf eine bestimmte Version beschränkt werden.

Direkter Download

Laden Sie das Installationsprogramm über folgenden Link herunter:

Visual C++ Redistributable-Anforderung

Installieren Sie für ältere Windows-Versionen, z. B. für Windows Server 2012 R2, Visual Studio C++ 2015, 2017, 2019 Redistributable. Andernfalls tritt im Ereignisprotokoll von Windows die folgende verwirrende Fehlermeldung auf: The data is the error..

Aktuelle x64-Version von Visual Studio C++ RedistributableAktuelle x86-Version von Visual Studio C++ Redistributable

Frühere Versionen des Installers

So erhalten Sie eine frühere Version des Installers:

  1. Navigieren Sie zur .NET Core-Downloadseite.
  2. Wählen Sie die gewünschte .NET Core-Version aus.
  3. Suchen Sie in der Spalte Run apps - Runtime (Apps ausführen – Runtime) die Zeile mit der gewünschten .NET Core-RuntimeRuntime-Version.
  4. Laden Sie den Installer über den Link das Hosting Bundle (Hosting-Paket) herunter.

Warnung

Einige Installer enthalten Releaseversionen, die das Ende ihres Lebenszyklus erreicht haben und nicht mehr von Microsoft unterstützt werden. Weitere Informationen finden Sie in den Unterstützungsrichtlinien.

Das ASP.NET Core-Modul ist aufwärts- und abwärtskompatibel mit unterstützten Releases von .NET.

Tastatur

  1. Die folgenden Parameter sind verfügbar, wenn Sie das Installationsprogramm über eine Administratorbefehlsshell ausführen.

    • OPT_NO_ANCM=1: Überspringen Sie die Installation des ASP.NET Core-Moduls.
    • OPT_NO_RUNTIME=1: Überspringen Sie die Installation der .NET Core-Runtime. Wird verwendet, wenn der Server nur eigenständige Bereitstellungen (Self-contained Deployments, SCD) hostet.
    • OPT_NO_SHAREDFX=1: Überspringen Sie die Installation des freigegebenen ASP.NET-Frameworks (ASP.NET-Runtime). Wird verwendet, wenn der Server nur eigenständige Bereitstellungen (Self-contained Deployments, SCD) hostet.
    • OPT_NO_X86=1: Überspringen Sie die Installation von x86-Runtimes. Verwenden Sie diesen Parameter, wenn Sie wissen, dass Sie keine 32-Bit-Apps hosten. Sollte die Möglichkeit bestehen, dass Sie sowohl 32-Bit- als auch 64-Bit-Apps hosten könnten, verwenden Sie diesen Parameter nicht, und installieren Sie beide Runtimes.
    • OPT_NO_SHARED_CONFIG_CHECK=1: Deaktivieren Sie die Überprüfung auf Verwendung einer gemeinsamen IIS-Konfiguration, wenn sich die gemeinsam genutzte Konfiguration (applicationHost.config) auf demselben Computer wie die IIS-Installation befindet. Nur für Installationsprogramme für Hostingbundles für ASP.NET Core 2.2 oder höher verfügbar. Weitere Informationen finden Sie unter Erweiterte Konfiguration.

Hinweis

Informationen zur Verwendung einer IIS-Freigabekonfiguration finden Sie unter ASP.NET Core-Modul mit IIS-Freigabekonfiguration.

Hinweis

Wenn Sie das Installationsprogramm für Hostingbundles mit festgelegten Optionen ausführen, wird der Wert für jede Option in der Registrierung gespeichert. Nachfolgende Installationen aus der gleichen Versionsreihe (Hauptversion.Nebenversion) verwenden die gleichen Optionen – es sei denn, über die Befehlszeile wird explizit ein anderer Optionssatz übergeben. Wenn bei der ersten Installation des Hostingbundles keine Optionen übergeben wurden, wird für jede Option der Standardwert 0 in die Registrierung geschrieben. Der Wert 0 impliziert, dass die Option ausgeschaltet ist und bedeutet, dass der Benutzer die angegebene Komponente nicht deaktiviert.

IIS neu starten

Nach Installation des Hostingpakets ist möglicherweise ein manueller IIS-Neustart erforderlich. Das dotnet-CLI-Tool (Befehl) ist unter dem Pfad zur Ausführung der IIS-Workerprozesse möglicherweise nicht vorhanden.

Um IIS manuell neu zu starten, beenden Sie Windows-Prozessaktivierungsdienst (Windows Process Activation Service, WAS), und starten Sie den WWW-Publishingdienst (W3SVC) sowie alle dazugehörigen Dienste neu. Führen Sie die folgenden Befehle in einer Befehlsshell mit erhöhten Rechten aus:

net stop was /y
net start w3svc

Version des Moduls und Installerprotokolle des Hostingpakets

So ermitteln Sie die Version des installierten ASP.NET Core-Moduls:

  1. Navigieren Sie auf dem Hostsystem zu %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
  2. Suchen Sie die Datei aspnetcorev2.dll.
  3. Klicken Sie mit der rechten Maustaste auf die Datei, und wählen Sie im Dropdownmenü die Option Eigenschaften aus.
  4. Wählen Sie die Registerkarte Details aus. Die Dateiversion und die Produktversion stellen die installierte Version des Moduls dar.

Die Installationsprotokolle des Hostingbundles für das Modul finden Sie unter C:\Users\%UserName%\AppData\Local\Temp. Die Datei hat den Namen dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, wobei der Platzhalter {TIMESTAMP} der Zeitstempel der Datei ist.