Installieren von .NET auf Windows

• Auf Windows installieren
• Installieren unter macOS
• Installieren unter Linux

In diesem Artikel erfahren Sie, welche Versionen von .NET für Windows unterstützt werden, wie Sie .NET installieren und was der Unterschied zwischen dem SDK und der Laufzeit ist.

Im Gegensatz zu .NET Framework ist .NET nicht an Ihre Version von Windows gebunden. Sie können nur eine einzelne Version von .NET Framework auf Windows installiert haben. .NET ist jedoch eigenständig und kann überall auf Ihrem Computer installiert werden. Einige Apps können ihre eigene Kopie von .NET enthalten.

Standardmäßig wird .NET im Verzeichnis Program Files\dotnet auf Ihrem Computer installiert, es sei denn, die Installationsmethode wählt ein anderes Verzeichnis aus.

Von Bedeutung

Wenn Sie .NET systemweit installieren, installieren Sie diese mit Administratorrechten.

.NET besteht aus der Laufzeit und dem SDK. Die Laufzeit führt .NET-Apps aus, und das SDK wird verwendet, um Apps zu erstellen.

Auswählen der richtigen Runtime

Es gibt drei verschiedene Laufzeiten für Windows, mit denen unterschiedliche Arten von Apps ausgeführt werden können. Das SDK enthält alle drei Runtimes, und ein Installationsprogramm für eine Runtime kann eine zusätzliche Runtime enthalten. In der folgenden Tabelle wird beschrieben, welche Laufzeit in einem bestimmten .NET Installer enthalten ist:

Installer	Enthält .NET Runtime	Umfasst .NET Desktop-Runtime	Enthält ASP.NET Core Runtime
.NET Runtime	Ja	Nein	Nein
.NET Desktop Runtime	Ja	Ja	Nein
ASP.NET Core Runtime	Nein	Nein	Ja
.NET SDK	Ja	Ja	Ja

Um sicherzustellen, dass Sie alle .NET Apps auf Windows ausführen können, installieren Sie sowohl die ASP.NET Core Runtime als auch die .NET Desktop-Runtime. Die ASP.NET Core Runtime führt webbasierte Apps aus, und die .NET Desktop-Runtime führt Desktop-Apps aus, z. B. eine Windows Presentation Foundation (WPF) oder Windows Forms App.

Auswählen, wie .NET installiert werden soll

Es gibt verschiedene Möglichkeiten, .NET zu installieren, und einige Produkte verwalten möglicherweise ihre eigene Version von .NET. Wenn Sie .NET über Software installieren, die eine eigene Version von .NET verwaltet, ist sie möglicherweise nicht systemweit aktiviert. Stellen Sie sicher, dass Sie die Auswirkungen der Installation von .NET über andere Software verstehen.

Wenn Sie nicht sicher sind, welche Methode Sie nach der Überprüfung der Listen in den folgenden Abschnitten auswählen sollten, möchten Sie wahrscheinlich den .NET Installer verwenden.

Entwickler

• Visual Studio

  Verwenden Sie Visual Studio, um .NET zu installieren, wenn Sie .NET Apps mit Visual Studio entwickeln möchten. Visual Studio verwaltet ihre eigene Kopie von .NET. Diese Methode installiert die Vorlagen SDK, Runtime und Visual Studio.

• Visual Studio Code - C# Dev Kit

  Installieren Sie die Erweiterung C# Dev Kit für Visual Studio Code, um .NET Apps zu entwickeln. Die Erweiterung kann ein bereits installiertes SDK verwenden oder ein SDK für Sie installieren.

Benutzer und Entwickler

• .NET Installer

  Installieren Sie .NET mit einem Windows Installer-Paket, bei dem es sich um eine ausführbare Datei handelt, die Sie ausführen. Diese Methode kann das SDK und die Runtime installieren. Installationen werden systemweit durchgeführt.

• Windows Paket-Manager (WinGet)

  Verwenden Sie WinGet, um .NET zu installieren, wenn Sie .NET über die Befehlszeile verwalten möchten. Diese Methode kann das SDK und die Runtime installieren. Installationen werden systemweit durchgeführt.

• PowerShell

  Ein PowerShell-Skript, das die Installation des SDK oder der Runtime automatisieren kann. Sie können auswählen, welche Version von .NET installiert werden soll.

Unterstützte Versionen

Die folgende Tabelle enthält eine Liste der derzeit unterstützten .NET Versionen und der Versionen von Windows, auf der sie unterstützt werden. Diese Versionen werden weiterhin unterstützt, bis die Version von .NET das Ende des Supports erreicht oder die Version von Windows das Ende der Lebensdauer erreicht.

Tipp

Diese Tabelle gilt für modernes .NET und nicht für das .NET Framework. Informationen zum Installieren von .NET Framework finden Sie im .NET Framework-Installationshandbuch.

Windows 10 Versionen End-of-Service-Daten sind nach Edition segmentiert. In der folgenden Tabelle werden nur die Editionen Home, Pro, Pro Education und Pro for Workstations berücksichtigt. Weitere Informationen finden Sie im Windows Lebenszyklus-Factsheet.

Betriebssystem	.NET 10 (Architekturen)	.NET 9 (Architekturen)	.NET 8 (Architekturen)
Windows 11 (24H2, 23H2, 22H2 Ent/Edu)	✔️ x64, Arm64	✔️ x64, Arm64	✔️ x64, Arm64
Windows 10 (22H2)	✔️ x64, Arm64	✔️ x64, Arm64	✔️ x64, Arm64
Windows Server 2025 Windows Server 2022 Windows Server 2019 Windows Server, Version 1903 oder höher Windows Server 2016 Windows Server 2012 R2 Windows Server 2012	✔️ x64, x86	✔️ x64, x86	✔️ x64, x86
Windows Server Core 2012 (und R2)	✔️ x64, x86	✔️ x64, x86	✔️ x64, x86
Nano Server (2025, 2022, 2019)	✔️ x64	✔️ x64	✔️ x64
Windows 8.1	❌	❌	❌
Windows 7 SP1 ESU	❌	❌	❌

Tipp

Die mindestens erforderliche Version ist mit einem -Zeichen markiert.

Windows 7 / 8.1 / Server 2012

Es gibt keine Version von .NET, die unter Windows 7 und Windows 8.1 unterstützt wird. Die letzten unterstützten Versionen waren .NET 6 und der Support endete am 12. November 2024.

Windows Server 2012 wird weiterhin von jeder Version von .NET unterstützt, die noch unterstützt wird.

Alle drei dieser Versionen von Windows erfordern weitere Abhängigkeiten, die installiert werden müssen:

Betriebssystem	Voraussetzungen
Windows 7 SP1 ESU	– Microsoft Visual C++ 2015-2019 Redistributable 64-Bit/32-Bit – KB3063858 64-Bit-32-Bit - Microsoft-Stammzertifizierungsstelle 2011 (nur .NET Core 2.1-Offlineinstallationsprogramm)
Windows 8.1	Microsoft Visual C++ 2015-2019 Redistributable 64-bit 32-bit
Windows Server 2012	Microsoft Visual C++ 2015-2019 Redistributable 64-Bit32-Bit
Windows Server 2012 R2	Microsoft Visual C++ 2015-2019 Redistributable 64-Bit / 32-Bit

Die vorherigen Anforderungen gelten auch, wenn ein Fehler im Zusammenhang mit einer der folgenden DLLs auftritt:

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

Armbasierte Windows-PCs

.NET wird auf Arm-basierten Windows-PCs unterstützt. In den folgenden Abschnitten werden die Punkte beschrieben, die Sie bei der Installation von .NET berücksichtigen sollten.

Pfadunterschiede

Auf einem armbasierten Windows-PC werden alle Arm64-Versionen von .NET im normalen Ordner C:\Program Files\dotnet\ installiert. Die x64 Version des .NET SDK wird jedoch im Ordner C:\Program Files\dotnet\x64\ installiert.

Pfadvariablen

Umgebungsvariablen, die .NET zum Systempfad hinzufügen, z. B. der Variablen PATH, müssen möglicherweise geändert werden, wenn Sowohl die x64- als auch die Arm64-Versionen des .NET SDK installiert sind. Darüber hinaus basieren einige Tools auf der umgebungsvariablen DOTNET_ROOT, die ebenfalls aktualisiert werden muss, um auf den entsprechenden .NET SDK-Installationsordner zu verweisen.

Installieren mit Visual Studio

Visual Studio installiert eine eigene Kopie von .NET, separat von anderen .NET-Installationen. Unterschiedliche Versionen von Visual Studio unterstützen unterschiedliche Versionen von .NET. Die neueste Version von Visual Studio unterstützt immer die neueste Version von .NET.

Download Visual Studio Installer

Visual Studio Installer installiert und konfiguriert Visual Studio. Einige Visual Studio Workloads umfassen .NET, z. B. ASP.NET und Webentwicklung und .NET Entwicklung von Multiplattform-App-UI. Bestimmte Versionen von .NET können über die Registerkarte Individual Components installiert werden.

In der Visual Studio Dokumentation finden Sie Anweisungen dazu, wie Sie:

• Install Visual Studio.
• Configure Visual Studio Workloads.

Ein Screenshot der den Visual Studio Installer mit der hervorgehobenen .NET Desktop-Workload in einem roten Rahmen zeigt.

.NET Versionen und Visual Studio

Wenn Sie Visual Studio zum Entwickeln von .NET Apps verwenden, beschreibt die folgende Tabelle die mindest erforderliche Version von Visual Studio basierend auf der Zielversion .NET SDK.

.NET SDK-Version	Visual Studio Version
10	Visual Studio 2026, Version 18.0 oder höher.
9	Visual Studio 2022, Version 17.12 oder höher.
8	Visual Studio 2022, Version 17.8 oder höher.
7	Visual Studio 2022, Version 17.4 oder höher.
6	Visual Studio 2022, Version 17.0 oder höher.
5	Visual Studio 2019, Version 16.8 oder höher.
3.1	Visual Studio 2019, Version 16.4 oder höher.
3.0	Visual Studio 2019, Version 16.3 oder höher.
2.2	Visual Studio 2017, Version 15.9 oder höher.
2.1	Visual Studio 2017, Version 15.7 oder höher.

Wenn Sie bereits Visual Studio installiert haben, können Sie Ihre Version mit den folgenden Schritten überprüfen.

1. Öffnen Sie Visual Studio.
2. Wählen Sie Help>About Microsoft Visual Studio aus.
3. Lesen Sie die Versionsnummer im Dialogfeld Info.

Weitere Informationen finden Sie unter .NET SDK, MSBuild und Visual Studio Versionsverwaltung.

Installieren mit Visual Studio Code

Visual Studio Code ist ein leistungsstarker und einfacher Quellcode-Editor, der auf Dem Desktop ausgeführt wird. Visual Studio Code kann das bereits auf Ihrem System installierte SDK verwenden.

Von Bedeutung

Wenn Sie .NET systemweit installieren, installieren Sie diese mit Administratorrechten.

Diese WinGet-Konfigurationsdatei installiert das neueste .NET SDK, Visual Studio Code und das C#DevKit. Wenn sie bereits installiert sind, überspringt WinGet diesen Schritt.

1. Laden Sie die Datei herunter, und doppelklicken Sie, um sie auszuführen.
2. Lesen Sie den Lizenzvertrag, geben Sie yein, und wählen Sie Geben Sie ein, wenn Sie zur Annahme aufgefordert werden.
3. Wenn Sie in Ihrer Taskleiste eine blinkende Eingabeaufforderung für die Benutzerkontensteuerung (User Account Control, UAC) erhalten, können Sie die Installation fortsetzen.

Darüber hinaus installiert die erweiterung C# Dev Kit .NET für Sie, wenn sie noch nicht installiert ist.

Anweisungen zum Installieren von .NET über Visual Studio Code finden Sie unter Getting Started with C# in VS Code.

.NET Installationsprogramm

Die Download-Seite für .NET stellt Windows Installer-Programme bereit.

Von Bedeutung

Wenn Sie .NET systemweit installieren, installieren Sie diese mit Administratorrechten.

1. Öffnen Sie einen Webbrowser, und navigieren Sie zu https://.

2. Wählen Sie die Version von .NET aus, die Sie herunterladen möchten, z. B. 10.0.

3. Suchen Sie das SDK- oder Laufzeitfeld, das die Links zum Herunterladen von .NET enthält.

4. Suchen Sie in der Spalte Installers die Zeile Windows und wählen Sie den Link für Ihre CPU-Architektur aus. Wenn Sie nicht sicher sind, wählen Sie x64 aus, da dies am häufigsten verwendet wird.

   Der Browser sollte das Installationsprogramm automatisch herunterladen.

   Tipp

   Die folgende Abbildung zeigt das SDK, aber Sie können auch die Runtime herunterladen.

   

5. Öffnen Sie Windows Explorer, und navigieren Sie zu der Stelle, an der die Datei heruntergeladen wurde, höchstwahrscheinlich Ihren Downloads Ordner.

6. Doppelklicken Sie auf die Datei, um .NET zu installieren.

   Das Dialogfeld Windows Installer wird geöffnet.

   

7. Wählen Sie Install aus, und folgen Sie den Anweisungen zum Installieren .NET.

Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.

Befehlszeilenoptionen

Verwenden Sie den Parameter , um eine Liste der Optionen anzuzeigen.

Wenn Sie .NET automatisch installieren möchten, z. B. in einer Produktionsumgebung oder zur Unterstützung der kontinuierlichen Integration, verwenden Sie die folgenden Optionen:

• /install
  Installiert .NET.

• /quiet
  Verhindert die Anzeige der Benutzeroberfläche und von Eingabeaufforderungen.

• /norestart
  Unterdrückt alle Neustartversuche.

dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart

Wenn Sie bereits .NET installiert haben, verwenden Sie den .NET Installer, um die Installation zu verwalten. Verwenden Sie anstelle von eine der folgenden Optionen:

• /uninstall
  Entfernen Sie diese Version von .NET.

• /repair
  Überprüfen Sie, ob die Schlüsseldateien oder -komponenten der Installation beschädigt sind, und stellen Sie sie ggf. wieder her.

Tipp

Der Installer gibt bei Erfolg den Exitcode 0 zurück. Wenn ein Neustart erforderlich ist, wird der Exitcode 3010 zurückgegeben. Bei anderen Werten handelt es sich wahrscheinlich um Fehlercodes.

Microsoft Update

Die ausführbaren .NET-Installer sind unabhängige Produkte, die mithilfe von Microsoft Update (MU) unter Windows gewartet werden können. MU unterscheidet sich von Windows Update (WU), die zum Dienst von Betriebssystemkomponenten wie .NET Framework verwendet wird.

Sowohl Sicherheits- als auch nicht sicherheitsrelevante Fixes für unterstützte Versionen von .NET werden über MU über mehrere Vertriebskanäle bereitgestellt. Automatische Updates (AU) sind für Endbenutzer und Verbraucher relevant, während Window Server Update Services (WSUS) und Windows Update Catalog für IT-Administratoren relevant sind.

Die ausführbaren Dateien des .NET-Installationsprogramms unterstützen parallele Side-by-Side (SxS)-Installationen für Haupt- und Nebenversionen für verschiedene Architekturen und Komponenten, wie z. B. die Laufzeit und das SDK. Sie können z. B. sowohl die Laufzeit 6.0.15 (x64) als auch 6.0.17 (x86) installieren. Wenn MU triggert, wird es das neueste Installationsprogramm für beide Installationen anbieten.

Blockieren von Updates

Während die meisten Benutzer lieber auf dem neuesten Stand gehalten werden möchten, ist es möglich, .NET Updates mithilfe der Registrierungsschlüssel in der folgenden Tabelle zu blockieren.

.NET Version	Registrierungsschlüssel	Name	Typ	Wert
Alle	HKLM\SOFTWARE\Microsoft\.NET	BlockMU	REG_DWORD	0x00000001
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	BlockMU	REG_DWORD	0x00000001
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	BlockMU	REG_DWORD	0x00000001
.NET 7	HKLM\SOFTWARE\Microsoft\.NET\7.0	BlockMU	REG_DWORD	0x00000001
.NET 6	HKLM\SOFTWARE\Microsoft\.NET\6.0	BlockMU	REG_DWORD	0x00000001
.NET 5	HKLM\SOFTWARE\Microsoft\.NET\5.0	BlockMU	REG_DWORD	0x00000001
.NET Core 3.1	HKLM\SOFTWARE\Microsoft\.NET\3.1	BlockMU	REG_DWORD	0x00000001
.NET Core 2.1	HKLM\SOFTWARE\Microsoft\.NET\2.1	BlockMU	REG_DWORD	0x00000001

Automatische Updates für Das Serverbetriebssystem

Updates für Serverbetriebssysteme werden von WSUS und Dem Microsoft Update-Katalog unterstützt, jedoch nicht von AU. Serverbetriebssysteme können sich für den Empfang von Updates über AU mit den folgenden Registrierungsschlüsseln anmelden.

.NET Version	Registrierungsschlüssel	Name	Typ	Wert
Alle	HKLM\SOFTWARE\Microsoft\.NET	AllowAUOnServerOS (Erlaubt Automatische Updates auf Serverbetriebssystemen)	REG_DWORD	0x00000001
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	AllowAUOnServerOS (Erlaubt Automatische Updates auf Serverbetriebssystemen)	REG_DWORD	0x00000001
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	AllowAUOnServerOS (Erlaubt Automatische Updates auf Serverbetriebssystemen)	REG_DWORD	0x00000001
.NET 7	HKLM\SOFTWARE\Microsoft\.NET\7.0	AllowAUOnServerOS (Erlaubt Automatische Updates auf Serverbetriebssystemen)	REG_DWORD	0x00000001
.NET 6	HKLM\SOFTWARE\Microsoft\.NET\6.0	AllowAUOnServerOS (Erlaubt Automatische Updates auf Serverbetriebssystemen)	REG_DWORD	0x00000001
.NET 5	HKLM\SOFTWARE\Microsoft\.NET\5.0	AllowAUOnServerOS (Erlaubt Automatische Updates auf Serverbetriebssystemen)	REG_DWORD	0x00000001
.NET Core 3.1	HKLM\SOFTWARE\Microsoft\.NET\3.1	AllowAUOnServerOS (Erlaubt Automatische Updates auf Serverbetriebssystemen)	REG_DWORD	0x00000001

WSUS- und Updateklassifizierungen

WSUS kann so konfiguriert werden, dass bestimmte Updates basierend auf ihrer Klassifizierung bereitgestellt werden. Updates für .NET werden entweder als security oder critical klassifiziert. Wenn das neueste Update als kritisch klassifiziert wird, wird möglicherweise ein älteres security Update angeboten, wenn eine ältere Version von .NET installiert wird, die durch das neueste Sicherheitsupdate ersetzt wird. Dies gilt auch für die Verwendung der Offline-CAB (Wsusscan2.cab) zum Scannen eines Computers.

Hinweis

In einigen Fällen meldet WSUS möglicherweise ein fehlendes Update für eine Version, die älter als die installierte .NET Version ist. Angenommen, ein Benutzer installiert .NET 6.0.36, die neueste Version von .NET 6. Diese Version wird als kritisches (nicht sicherheitsrelevantes) Update klassifiziert. Anschließend installiert eine Anwendung eine ältere Version, 6.0.33. (Es ist nicht ungewöhnlich, dass Anwendungen bestimmte Versionen von .NET als Voraussetzung einschließen.) Wenn ein Administrator WSUS so konfiguriert hat, dass nur Sicherheitsupdates bereitgestellt werden, meldet die nächste Überprüfung 6.0.35 als fehlendes Update. Computer, die für den Empfang von Sicherheitsupdates über AU oder WSUS konfiguriert sind, werden 6.0.35 angeboten, auch wenn 6.0.36 installiert ist. Der Grund dafür ist, dass 6.0.35 6.0.33 ersetzt und das neueste Sicherheitsupdate ist.

Wählen Sie aus, wann frühere Versionen entfernt werden

Die ausführbaren Installationsprogramme installieren immer neue Inhalte, bevor Sie die vorherige Installation entfernen. Anwendungen, die ausgeführt werden, können unterbrochen oder abstürzen, wenn ältere Laufzeiten entfernt werden. Um die Auswirkungen der Aktualisierung .NET zu minimieren, können Sie angeben, wann eine vorherige .NET Installation mithilfe eines Registrierungsschlüssels entfernt werden soll.

.NET Version	Registrierungsschlüssel	Name	Typ	Wert
Alle	HKLM\SOFTWARE\Microsoft\.NET	VorherigeVersionEntfernen	REG_SZ	, , oder
.NET 10	HKLM\SOFTWARE\Microsoft\.NET\10.0	VorherigeVersionEntfernen	REG_SZ	, , oder
.NET 9	HKLM\SOFTWARE\Microsoft\.NET\9.0	VorherigeVersionEntfernen	REG_SZ	, , oder
.NET 8	HKLM\SOFTWARE\Microsoft\.NET\8.0	VorherigeVersionEntfernen	REG_SZ	, , oder

• never behält vorherige Installationen bei und erfordert manuellen Eingriff, um vorherige .NET Installationen zu entfernen.
• entfernt vorherige Installationen, nachdem die neue Version installiert wurde. Dies ist das Standardverhalten in .NET.
• Verschiebt die Entfernung bis zur nächsten Anmeldesitzung von Mitgliedern der Gruppe "Administratoren".
• Bei Werten wird die Groß-/Kleinschreibung nicht beachtet, und ungültige Werte werden auf einen Standardwert zurückgesetzt.

Wenn die Entfernung zurückgestellt wird, schreibt das Installationsprogramm einen Befehl in den RunOnce-Registrierungsschlüssel , um die vorherige Version zu deinstallieren. Der Befehl wird nur ausgeführt, wenn sich ein Benutzer in der Gruppe "Administratoren" auf dem Computer anmeldet.

Hinweis

Dieses Feature ist nur ab .NET 8 (8.0.11) verfügbar. Sie gilt nur für die ausführbaren Dateien des eigenständigen Installationsprogramms und wirkt sich auf Verteilungen wie WinGet aus, die sie verwenden.

Installieren mit Windows Paket-Manager (WinGet)

Sie können .NET über den Windows Paket-Manager-Dienst mithilfe des Tools winget.exe installieren und verwalten. Weitere Informationen zum Installieren und Verwenden von WinGet finden Sie unter Verwenden des Tools WinGet zum Installieren und Verwalten von Anwendungen.

Von Bedeutung

Wenn Sie .NET systemweit installieren, installieren Sie diese mit Administratorrechten.

Die .NET WinGet-Pakete sind:

• Microsoft.DotNet.Runtime.10 – .NET Runtime 10.0
• Microsoft.DotNet.AspNetCore.10 – ASP.NET Core Runtime 10.0
• Microsoft.DotNet.DesktopRuntime.10 – .NET Desktop Runtime 10.0
• Microsoft.DotNet.SDK.10 – .NET SDK 10.0
• Microsoft.DotNet.Runtime.9 – .NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9 – ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9 – .NET Desktop Runtime 9.0
• Microsoft.DotNet.SDK.9 – .NET SDK 9.0
• Microsoft.DotNet.Runtime.8 – .NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8 – ASP.NET Core Runtime 8.0
• Microsoft.DotNet.DesktopRuntime.8 – .NET Desktop Runtime 8.0
• Microsoft.DotNet.SDK.8 – .NET SDK 8.0

Das SDK installieren

Wenn Sie das SDK installieren, müssen Sie die zugehörige Runtime nicht installieren.

1. Installieren von WinGet

2. Öffnen Sie ein Terminal, z. B. PowerShell oder die Eingabeaufforderung.

3. Führen Sie den Befehl aus, und übergeben Sie den Namen des SDK-Pakets:

   winget install Microsoft.DotNet.SDK.10
   

Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.

Installieren Sie die Runtime

Sie können verschiedene Runtimes installieren. Grundlegende Informationen dazu, was in den einzelnen Runtimes enthalten ist, finden Sie im Abschnitt Auswählen der richtigen Runtime.

1. Installieren von WinGet

2. Öffnen Sie ein Terminal, wie z. B. die PowerShell oder Eingabeaufforderung.

3. Führen Sie den Befehl aus, und übergeben Sie den Namen des SDK-Pakets:

   winget install Microsoft.DotNet.DesktopRuntime.10
   winget install Microsoft.DotNet.AspNetCore.10
   

Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.

Suchen nach Versionen

Verwenden Sie den Befehl , um nach verschiedenen Versionen des Pakets zu suchen, das Sie installieren möchten. Der folgende Befehl sucht beispielsweise nach allen über WinGet verfügbaren .NET SDKs:

winget search Microsoft.DotNet.SDK

Die Suchergebnisse werden in einer Tabelle mit den einzelnen Paketbezeichnern ausgegeben.

Name                            Id                           Version                 Source
--------------------------------------------------------------------------------------------
Microsoft .NET SDK 3.1          Microsoft.DotNet.SDK.3_1     3.1.426                 winget
Microsoft .NET SDK 5.0          Microsoft.DotNet.SDK.5       5.0.408                 winget
Microsoft .NET SDK 6.0          Microsoft.DotNet.SDK.6       6.0.428                 winget
Microsoft .NET SDK 7.0          Microsoft.DotNet.SDK.7       7.0.410                 winget
Microsoft .NET SDK 8.0          Microsoft.DotNet.SDK.8       8.0.415                 winget
Microsoft .NET SDK 9.0          Microsoft.DotNet.SDK.9       9.0.306                 winget
Microsoft .NET SDK 10.0         Microsoft.DotNet.SDK.10      10.0.100                winget

Installieren von Vorschauversionen

Wenn eine Vorschauversion verfügbar ist, ersetzen Sie die Versionsnummer in der ID durch das Wort . Im folgenden Beispiel wird die Vorschauversion der .NET Desktop-Runtime installiert:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Installieren mit PowerShell

Die Installation von .NET über das PowerShell-Skript dotnet-install wird für kontinuierliche Integration und nichtadmin-Installationen empfohlen. Wenn Sie .NET für die normale Verwendung auf Ihrem System installieren, verwenden Sie entweder die Installationsmethoden .NET Installer oder Windows Paket-Manager.

Das Skript installiert standardmäßig die neueste long Term Support (LTS) Version, die .NET 10 ist. Sie können eine bestimmte Version durch Angabe des Schalters auswählen. Fügen Sie den Schalter hinzu, um eine Runtime zu installieren. Andernfalls installiert das Skript das SDK. Das Skript ist unter https://dot.net/v1/dotnet-install.ps1 verfügbar und der Quellcode wird auf GitHub gehostet.

Skript herunterladen

Weitere Informationen zum Skript finden Sie unter -Installationsskript-Referenz.

Runtime installieren

Die .NET Runtime wird installiert, indem die Option -Runtime bereitgestellt wird.

1. Laden Sie das Installationsskript herunter von.

2. Öffnen Sie PowerShell, und navigieren Sie zu dem Ordner, der das Skript enthält.

3. Führen Sie die folgenden Befehle aus, um sowohl die Desktoplaufzeit als auch ASP.NET Core Laufzeit für maximale Kompatibilität zu installieren:

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.

Das SDK installieren

Wenn Sie das SDK installieren, müssen Sie die Runtimes nicht installieren.

1. Laden Sie das Installationsskript von [URL/Ort einfügen] herunter.

2. Öffnen Sie PowerShell, und navigieren Sie zu dem Ordner, der das Skript enthält.

3. Führen Sie den folgenden Befehl aus, um das .NET SDK zu installieren.

   dotnet-install.ps1
   

   Hinweis

   Wenn der Schalter weggelassen wird, wird das SDK installiert.

Informationen zur Verwendung der .NET CLI finden Sie unter .NET CLI-Übersicht.

Überprüfen

Vergewissern Sie sich nach dem Herunterladen eines Installationsprogramms oder Binärrelease, dass die Datei nicht geändert oder beschädigt wurde. Sie können die Prüfsumme auf Ihrem Computer überprüfen und sie dann mit dem auf der Downloadwebsite angegebenen Wert vergleichen.

Wenn Sie die Datei von einer offiziellen Downloadseite herunterladen, wird die Prüfsumme für die Datei in einem Textfeld angezeigt. Wählen Sie die Schaltfläche Kopieren aus, um den Prüfsummenwert in Ihre Zwischenablage zu kopieren.

Sie können PowerShell oder die Eingabeaufforderung verwenden, um die Checksumme der heruntergeladenen Datei zu validieren. Beispielsweise meldet der folgende Befehl die Prüfsumme der -sdk-9.0.306-win-x64.exe Datei:

> certutil -hashfile dotnet-sdk-9.0.306-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-9.0.306-win-x64.exe:
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f

Vergleichen Sie die Prüfsumme mit dem von der Downloadwebsite bereitgestellten Wert.

Verwenden von PowerShell und einer Prüfsummendatei zum Überprüfen

Die .NET Versionshinweise enthalten einen Link zu einer Prüfsummendatei, mit der Sie Ihre heruntergeladene Datei überprüfen können. Die folgenden Schritte beschreiben, wie Sie die Prüfsummendatei herunterladen und eine .NET Installationsdatei validieren:

1. Die Seite mit den Versionshinweisen für .NET 9 auf GitHub at https://github.com/dotnet/core/tree/main/release-notes/9.0 enthält einen Abschnitt mit dem Namen Releases. Die Tabelle in diesem Abschnitt enthält Links zu den Downloads- und Prüfsummendateien für jede .NET 9-Version. Die folgende Abbildung zeigt die .NET 8-Versionstabelle als Referenz:

   

2. Wählen Sie den Link für die Version von .NET aus, die Sie heruntergeladen haben. Im vorherigen Abschnitt wurde .NET SDK 9.0.306 verwendet, das sich in der version .NET 9.0.10 befindet.

   Tipp

   Wenn Sie nicht sicher sind, welche .NET Version Ihre Prüfsummendatei enthält, erkunden Sie die Links, bis Sie sie gefunden haben.

3. Auf der Veröffentlichungsseite können Sie die .NET Runtime- und .NET SDK-Version sowie einen Link zur Prüfsummendatei anzeigen. Die folgende Abbildung zeigt die .NET 8-Versionstabelle als Referenz:

   

4. Kopieren Sie den Link zur Prüfsummendatei.

5. Verwenden Sie das folgende Skript, ersetzen Sie jedoch den Link, um die entsprechende Prüfsummendatei herunterzuladen:

   Invoke-WebRequest https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-sha.txt
   

6. Laden Sie sowohl die Prüfsummendatei als auch die .NET Releasedatei in dasselbe Verzeichnis herunter. Durchsuchen Sie die Prüfsummendatei nach der Prüfsumme des .NET-Downloads:

   Wenn die Überprüfung erfolgreich ist, wird TRUE ausgegeben:

   > (Get-Content .\9.0.10-sha.txt | Select-String "dotnet-sdk-9.0.306-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   Wenn FALSE ausgegeben wird, ist die heruntergeladene Datei ungültig und sollte nicht verwendet werden.

Problembehandlung

Nach der Installation des .NET SDK können Probleme auftreten, wenn Sie versuchen, .NET CLI-Befehle auszuführen. In diesem Abschnitt werden diese häufig auftretenden Probleme gesammelt und Lösungen bereitgestellt.

• Kein .NET SDK wurde gefunden
• Das Erstellen von Apps ist langsamer als erwartet
• fehlt.

Es wurde kein .NET SDK gefunden.

Wahrscheinlich haben Sie sowohl die x86-Version (32-Bit) als auch die x64-Version (64-Bit) des .NET SDK installiert. Dies verursacht einen Konflikt, da der Befehl bei der Ausführung als x86-Version interpretiert wird, obwohl er als x64-Version interpretiert werden sollte. Dieses Problem wird behoben, indem die Variable so angepasst wird, dass zuerst die x64-Version aufgelöst wird.

1. Vergewissern Sie sich, dass beide Versionen installiert sind, indem Sie den -Befehl ausführen. Wenn Sie dies tun, sollte ein Eintrag für die Ordner \ und (x86)\ angezeigt werden. Wenn der ordner (x86)\ zuerst ist, wie im folgenden Beispiel gezeigt, ist es falsch, und Sie sollten mit dem nächsten Schritt fortfahren.

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   Tipp

   Obwohl in diesem Beispiel verwendet wird, werden möglicherweise andere Kopien von .exe aufgeführt. Passen Sie sie so an, dass die entsprechende .exe zuerst gelöst wird.

   Wenn das korrekt ist und Program Files\ an erster Stelle steht, haben Sie das in diesem Abschnitt behandelte Problem nicht, und Sie sollten auf GitHub eine .NET-Hilfeanfrage erstellen.

2. Drücken Sie die Schaltfläche Windows, und geben Sie "Systemumgebungsvariablen bearbeiten" in die Suche ein. Wählen Sie Die Systemumgebungsvariablen bearbeiten aus.

   

3. Das Fenster Systemeigenschaften wird zur Registerkarte Erweitert geöffnet. Wählen Sie Umgebungsvariablen aus.

   

4. Wählen Sie im Fenster Umgebungsvariablen unter der Gruppe Systemvariablen die Zeile Pfad* und dann die Schaltfläche Bearbeiten aus.

   Das Umgebungsvariablenfenster mit Benutzer- und Systemvariablen.

5. Verwenden Sie die Schaltflächen "Nach oben" und "Nach unten", um den Eintrag C:\\\ über C:\ (x86)\\zu verschieben.

   Die Liste der Umgebungsvariablen für das System.

Das Erstellen von Apps ist langsamer als erwartet

Stellen Sie sicher, dass das Smart App-Steuerelement, ein Windows-Feature, deaktiviert ist. Smart App Control wird nicht empfohlen, auf Computern zu aktivieren, die für die Entwicklung verwendet werden. Andere Einstellungen als „off“ können sich negativ auf die Leistung des SDK auswirken.

fehlt.

Installieren Sie „Microsoft Visual C++ 2015-2019 Redistributable“ (64 Bit oder 32 Bit).

Zugehöriger Inhalt

• Übersicht über .NET CLI
• Upgrade auf eine neue .NET Version.
• Wie zu überprüfen, ob .NET bereits installiert ist.
• Lernprogramm: Erstellen einer neuen Konsolenanwendung.