ASP.NET bei IIS registrieren
Auf einen Blick
| Gilt für | IIS 10 auf Windows Server 2016/2019/2022/2025 und Windows 10/11; ASP.NET 4.8.x und ASP.NET Core (.NET 8/10) |
|---|---|
| Bereich | Server-Software |
| Dauer | ca. 10 Minuten |
| Rechte | Administrator |
| Stand | Oktober 2026 |
ASP.NET bei IIS registrieren – früher mit aspnet_regiis -ir erledigt – funktioniert auf aktuellen Windows-Versionen anders: Klassisches ASP.NET 4.x wird als Windows-Feature von IIS aktiviert, moderne ASP.NET-Core-Anwendungen benötigen das ASP.NET Core Hosting Bundle. Dieser Artikel zeigt beide Wege und hilft, wenn IIS Ihre .NET-Anwendung nicht ausführt.
Problem
- IIS ist installiert, liefert für eine ASP.NET-Anwendung aber Fehler wie HTTP 500.19, 500.21 „Handler PageHandlerFactory-Integrated hat ein ungültiges Modul“ oder 404.3.
- Bei ASP.NET Core erscheint HTTP 500.30/500.31 oder 502.5 – ANCM Out-Of-Process Startup Failure.
aspnet_regiis -irmeldet: „Diese Option wird von dieser Version des Betriebssystems nicht unterstützt“.
Ursache
Seit Windows 8 / Server 2012 ist ASP.NET 4.x fester Bestandteil von Windows und wird nicht mehr per aspnet_regiis bei IIS registriert, sondern als IIS-Feature aktiviert. ASP.NET Core ist dagegen gar nicht Teil von Windows: IIS braucht dafür das ASP.NET Core Module (ANCM) aus dem Hosting Bundle. Fehlt das eine oder andere, kann IIS die Anwendung nicht starten.
Lösung
Variante 1: ASP.NET 4.x (.NET Framework) aktivieren
Windows Server 2016–2025 (PowerShell als Administrator):
Install-WindowsFeature Web-Server, Web-Asp-Net45, Web-Net-Ext45, Web-ISAPI-Ext, Web-ISAPI-Filter -IncludeManagementTools
Windows 10/11:
Enable-WindowsOptionalFeature -Online -All -FeatureName IIS-WebServerRole, IIS-ASPNET45, IIS-NetFxExtensibility45, IIS-ISAPIExtensions, IIS-ISAPIFilter, IIS-ManagementConsole
Grafisch: Server-Manager → Rollen und Features hinzufügen → Webserver (IIS) → Anwendungsentwicklung → ASP.NET 4.8 bzw. am Client Windows-Features → Internetinformationsdienste → WWW-Dienste → Anwendungsentwicklungsfeatures → ASP.NET 4.8.
Danach im IIS-Manager prüfen, dass der Anwendungspool auf .NET CLR-Version v4.0 und den Modus Integriert steht.
Variante 2: ASP.NET Core (.NET 8/10) unter IIS hosten
- IIS installieren (Variante 1 ohne die ASP.NET-45-Features genügt).
- Das ASP.NET Core Hosting Bundle in der Version der Anwendung herunterladen (z. B. .NET 10) und installieren. Es enthält die .NET-Runtime und das ASP.NET Core Module.
- IIS neu starten:
net stop was /y
net start w3svc
- Für die Anwendung einen eigenen Anwendungspool mit .NET CLR-Version: Kein verwalteter Code anlegen.
- Die veröffentlichte Anwendung (
dotnet publish -c Release) inklusiveweb.configin das Website-Verzeichnis kopieren.
Installierte Module prüfen
Get-WindowsFeature Web-Asp-Net45 # Server: ASP.NET 4.x aktiv?
& "$env:windir\system32\inetsrv\appcmd.exe" list modules | Select-String AspNetCore
dotnet --list-runtimes # installierte .NET-Runtimes
Hinweise
- Versionen: Hosting Bundle und Anwendung müssen zur gleichen Hauptversion passen. .NET 8 und .NET 9 erhalten nur noch bis 10. November 2026 Updates – planen Sie die Umstellung auf .NET 10 (LTS bis November 2028).
- aspnet_regiis wird heute nur noch für Sonderaufgaben gebraucht, z. B. zum Verschlüsseln von Abschnitten der
web.config(aspnet_regiis -pef). - Fehlerdetails: Bei ASP.NET Core in der
web.configvorübergehendstdoutLogEnabled="true"setzen; die Logs landen im Ordner.\logs. - Sicherheit: IIS-Server nicht direkt ins Internet stellen, sondern hinter einen Reverse Proxy bzw. eine Web Application Firewall.
- Bei Betrieb und Härtung von IIS- und Windows-Servern unterstützt Sie die Microsoft-und-Windows-Beratung von m.a.x. it.
Siehe auch
Links und Quellen
Über m.a.x. it Die m.a.x. Informationstechnologie AG ist seit über 30 Jahren IT-Partner mittelständischer und großer Unternehmen in München und bietet maßgeschneiderte Lösungen und Services in den Bereichen Cloud, Cybersecurity, Netzwerk, Windows, Linux und Softwareentwicklung. Sie haben eine Frage zu diesem Artikel oder brauchen Unterstützung?
