diff --git a/docs/framework/get-started/system-requirements.md b/docs/framework/get-started/system-requirements.md index 95c81152b7c1b..6eb5b4f11ac4a 100644 --- a/docs/framework/get-started/system-requirements.md +++ b/docs/framework/get-started/system-requirements.md @@ -1,7 +1,7 @@ --- title: ".NET Framework system requirements" description: "Find out about the hardware, operating system, and software requirements to install .NET Framework 4.5 and later versions." -ms.date: 05/01/2023 +ms.date: 04/24/2024 helpviewer_keywords: - "software requirements" - ".NET Framework, system requirements" @@ -13,20 +13,19 @@ helpviewer_keywords: The tables in this article provide the hardware, operating system, and software requirements for the following .NET Framework versions: -- .NET Framework 4.5 and its point releases (4.5.1 and 4.5.2). -- .NET Framework 4.6 and its point releases (4.6.1 and 4.6.2). +- .NET Framework 4.6.2. - .NET Framework 4.7 and its point releases (4.7.1 and 4.7.2). - .NET Framework 4.8 and its point release (4.8.1). -For information on .NET Framework versions earlier than .NET Framework 4.5, see [.NET Framework versions and dependencies](../migration-guide/versions-and-dependencies.md). +For information on earlier .NET Framework versions, see [.NET Framework versions and dependencies](../migration-guide/versions-and-dependencies.md). Development environments that enable you to develop apps for .NET Framework have a separate set of requirements. [!INCLUDE[net-framework-4-versions](../../../includes/net-framework-4x-versions.md)] -For download information and links, see [Install the .NET Framework for developers](../install/guide-for-developers.md). +For download information and links, see [Install .NET Framework for developers](../install/guide-for-developers.md). -For information on the support lifecycle of .NET Framework versions, see [Microsoft Support Lifecycle](https://support.microsoft.com/lifecycle/search?sort=PN&alpha=Microsoft%20.NET%20Framework&Filter=FilterNO). +For information on the support lifecycle of .NET Framework versions, see [Microsoft support lifecycle](https://support.microsoft.com/lifecycle/search?sort=PN&alpha=Microsoft%20.NET%20Framework&Filter=FilterNO). ## Hardware requirements @@ -41,75 +40,62 @@ For information on the support lifecycle of .NET Framework versions, see [Micros .NET Framework requires administrator privileges for installation. If you don't have administrator rights to the computer where you'd like to install .NET Framework, contact your network administrator. -## Supported client operating systems - -| Operating system | Supported editions | Preinstalled with the OS | Installable separately | -| ---------------- | ------------------ | ------------------------ | ---------------------- | -| Windows 11, 2022 Update
(version 22H2) | 64-bit | .NET Framework 4.8.1 | -- | -| Windows 11 | 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | -| Windows 10 2022 Update
(version 22H2) | 32-bit and 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | -| Windows 10 November 2021 Update
(version 21H2) | 32-bit and 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | -| Windows 10 May 2021 Update
(version 21H1) | 32-bit and 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | -| Windows 10 October 2020 Update
(version 20H2) | 32-bit and 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | -| Windows 10 May 2020 Update
(version 2004) | 32-bit and 64-bit | .NET Framework 4.8 | -- | -| Windows 10 November 2019 Update
(version 1909) | 32-bit and 64-bit | .NET Framework 4.8 | -- | -| Windows 10 May 2019 Update
(version 1903) | 32-bit and 64-bit | .NET Framework 4.8 | -- | -| Windows 10 October 2018 Update
(version 1809) | 32-bit and 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | -| Windows 10 April 2018 Update
(version 1803) | 32-bit and 64-bit | .NET Framework 4.7.2 |.NET Framework 4.8| -| Windows 10 Fall Creators Update
(version 1709) | 32-bit and 64-bit | .NET Framework 4.7.1 | .NET Framework 4.7.2

.NET Framework 4.8 | -| Windows 10 Creators Update
(version 1703) | 32-bit and 64-bit | .NET Framework 4.7 | .NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | -| Windows 10 Anniversary Update
(version 1607) | 32-bit and 64-bit | .NET Framework 4.6.2 |.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | -| Windows 10 November Update
(version 1511) | 32-bit and 64-bit | .NET Framework 4.6.1 | .NET Framework 4.6.2 | -| Windows 10
(version 1507) | 32-bit and 64-bit | .NET Framework 4.6 | .NET Framework 4.6.1

.NET Framework 4.6.2 | -| Windows 8.1 | 32-bit, 64-bit, and ARM | .NET Framework 4.5.1 | .NET Framework 4.5.2

.NET Framework 4.6

.NET Framework 4.6.1

.NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | -| Windows 8 | 32-bit, 64-bit, and ARM | .NET Framework 4.5 | .NET Framework 4.5.1

.NET Framework 4.5.2

.NET Framework 4.6

.NET Framework 4.6.1 | -| Windows 7 SP1|32-bit and 64-bit | -- | .NET Framework 4

.NET Framework 4.5

.NET Framework 4.5.1

.NET Framework 4.5.2

.NET Framework 4.6

.NET Framework 4.6.1

.NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | -| Windows Vista SP2|32-bit and 64-bit | -- | .NET Framework 4

.NET Framework 4.5

.NET Framework 4.5.1

.NET Framework 4.5.2

.NET Framework 4.6 | -| Windows XP |32-bit and 64-bit | -- | .NET Framework 4 | - -**Notes:** - -- On Windows 7 systems, .NET Framework requires Windows 7 SP1. If you're on Windows 7 and haven't yet installed Service Pack 1, you need to do so before installing the .NET Framework. - -- .NET Framework 4.5 is supported on the Windows Preinstallation Environment (Windows PE). Not all features are supported on Windows PE. - -- .NET Framework 4 also supports the IA64 platform. - -- For all platforms, we recommend that you upgrade to the latest Windows Service Pack and install critical updates available from [Windows Update](https://support.microsoft.com/help/12373/windows-update-faq) to ensure the best compatibility and security. - -- On 64-bit operating systems, .NET Framework supports both WOW64 (32-bit processing on a 64-bit machine) and native 64-bit processing. - -## Supported server operating systems - -| Operating system | Supported editions | Preinstalled with the OS | Installable separately | -| ---------------- | ------------------ | ------------------------ | ---------------------- | -| Windows Server 2022 | 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | -| Windows Server 2019 | 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | -| Windows Server, version 1809 | 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | -| Windows Server, version 1803 | 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | -| Windows Server, version 1709 | 64-bit | .NET Framework 4.7.1 | .NET Framework 4.7.2| -| Windows Server 2016 | 64-bit | .NET Framework 4.6.2 | .NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | -| Windows Server 2012 R2 | 64-bit | .NET Framework 4.5.1 | .NET Framework 4.5.2

.NET Framework 4.6

.NET Framework 4.6.1

.NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | -| Windows Server 2012 (64-bit edition) | 64-bit| .NET Framework 4.5 | .NET Framework 4.5.1

.NET Framework 4.5.2

.NET Framework 4.6

.NET Framework 4.6.1

.NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | -| Windows Server 2008 R2 SP1|64-bit | -- | .NET Framework 4

.NET Framework 4.5

.NET Framework 4.5.1

.NET Framework 4.5.2

.NET Framework 4.6

.NET Framework 4.6.1

.NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | -| Windows Server 2008 SP2|32-bit and 64-bit | -- | .NET Framework 4

.NET Framework 4.5

.NET Framework 4.5.1

.NET Framework 4.5.2

.NET Framework 4.6

.NET Framework 4.6.2 | - -**Notes:** - -- Windows Server 2012 includes .NET Framework 4.5, so you don't have to install it separately. Similarly, Windows Server 2012 R2 includes .NET Framework 4.5.1. - -- .NET Framework has limited support for the Server Core Role with Windows Server 2008 R2 SP1 or later. See [Server Core .NET Functionality](/previous-versions//dd745015(v=vs.85)) for a list of unsupported APIs. - -- .NET Framework isn't supported on Windows Server 2008 R2 for Itanium-Based Systems. - -- On Windows Server 2008 SP2, .NET Framework is not supported in the Server Core Role. - -- For all platforms, we recommend that you upgrade to the latest Windows Service Pack and critical updates available from [Windows Update](https://support.microsoft.com/help/12373/windows-update-faq) to ensure the best compatibility and security. Installation of the latest Windows Service Pack may be required on some operating systems. - -- On 64-bit operating systems, .NET Framework supports both WOW64 (32-bit processing on a 64-bit machine) and native 64-bit processing. +## Compatible operating systems + +- [Client operating systems](#client-operating-systems) +- [Server operating systems](#server-operating-systems) + +For all platforms, to ensure the best compatibility and security, we recommend that you install critical updates available from [Windows Update](https://support.microsoft.com/help/12373/windows-update-faq). + +On 64-bit operating systems, .NET Framework supports both WOW64 (32-bit processing on a 64-bit machine) and native 64-bit processing. + +### Client operating systems + +| Operating system | Compatible editions | Preinstalled with the OS | Installable separately | +|----------------------------------------------------|---------------------|--------------------------|------------------------| +| Windows 11, 2023 Update
(version 23H2) | 64-bit | .NET Framework 4.8.1 | -- | +| Windows 11, 2022 Update
(version 22H2) | 64-bit | .NET Framework 4.8.1 | -- | +| Windows 11 | 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | +| Windows 10 2022 Update
(version 22H2) | 32-bit and 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | +| Windows 10 November 2021 Update
(version 21H2) | 32-bit and 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | +| Windows 10 May 2021 Update
(version 21H1)† | 32-bit and 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | +| Windows 10 October 2020 Update
(version 20H2)† | 32-bit and 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | +| Windows 10 May 2020 Update
(version 2004)† | 32-bit and 64-bit | .NET Framework 4.8 | -- | +| Windows 10 November 2019 Update
(version 1909)†| 32-bit and 64-bit | .NET Framework 4.8 | -- | +| Windows 10 May 2019 Update
(version 1903)† | 32-bit and 64-bit | .NET Framework 4.8 | -- | +| Windows 10 October 2018 Update
(version 1809)† | 32-bit and 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | +| Windows 10 April 2018 Update
(version 1803)† | 32-bit and 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | +| Windows 10 Fall Creators Update
(version 1709)† | 32-bit and 64-bit | .NET Framework 4.7.1 | .NET Framework 4.7.2

.NET Framework 4.8 | +| Windows 10 Creators Update
(version 1703)† | 32-bit and 64-bit | .NET Framework 4.7 | .NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | +| Windows 10 Anniversary Update
(version 1607)† | 32-bit and 64-bit | .NET Framework 4.6.2 |.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | +| Windows 10 November Update
(version 1511)† | 32-bit and 64-bit | .NET Framework 4.6.1 | .NET Framework 4.6.2 | +| Windows 10
(version 1507)† | 32-bit and 64-bit | .NET Framework 4.6 | .NET Framework 4.6.2 | +| Windows 8.1† | 32-bit, 64-bit, and ARM | .NET Framework 4.5.1 | .NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | +| Windows 7 SP1† | 32-bit and 64-bit | -- | .NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | + +†The following operating systems, while listed in the table, are out-of-support: Windows 7, Windows 8.1, Windows 10 (all versions except 21H2 and 22H2). + +### Server operating systems + +| Operating system | Compatible editions | Preinstalled with the OS | Installable separately | +|-------------------------------|---------------------|--------------------------|------------------------| +| Windows Server 2022 | 64-bit | .NET Framework 4.8 | .NET Framework 4.8.1 | +| Windows Server 2019† | 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | +| Windows Server, version 1809† | 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | +| Windows Server, version 1803† | 64-bit | .NET Framework 4.7.2 | .NET Framework 4.8 | +| Windows Server, version 1709† | 64-bit | .NET Framework 4.7.1 | .NET Framework 4.7.2 | +| Windows Server 2016† | 64-bit | .NET Framework 4.6.2 | .NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | +| Windows Server 2012 R2† | 64-bit | .NET Framework 4.5.1 | .NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | +| Windows Server 2012 (64-bit edition)† | 64-bit | .NET Framework 4.5 | .NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | +| Windows Server 2008 R2 SP1†‡ | 64-bit | -- | .NET Framework 4.6.2

.NET Framework 4.7

.NET Framework 4.7.1

.NET Framework 4.7.2

.NET Framework 4.8 | +| Windows Server 2008 SP2†§ | 32-bit and 64-bit | -- | .NET Framework 4.6.2 | + +†This operating system is out-of-support. +‡On Windows Server 2008 R2, .NET Framework isn't supported for Itanium-based systems. +§On Windows Server 2008 SP2, .NET Framework isn't supported in the Server Core role. ## See also -- [Installation Guide](../install/index.md) -- [Getting Started](index.md) +- [Installation guide](../install/index.md) +- [Getting started](index.md) - [Troubleshoot blocked .NET Framework installations and uninstallations](../install/troubleshoot-blocked-installations-and-uninstallations.md) diff --git a/docs/framework/migration-guide/versions-and-dependencies.md b/docs/framework/migration-guide/versions-and-dependencies.md index fd8008d645d49..f040bddada284 100644 --- a/docs/framework/migration-guide/versions-and-dependencies.md +++ b/docs/framework/migration-guide/versions-and-dependencies.md @@ -1,7 +1,7 @@ --- title: .NET Framework & Windows OS versions description: Learn about key features in each version of .NET Framework, including underlying CLR versions and versions installed by the Windows operating system. -ms.date: 07/31/2023 +ms.date: 04/24/2024 helpviewer_keywords: - "versions, .NET Framework" --- @@ -55,15 +55,15 @@ Jump to: - New accessibility features - [Release notes](https://github.com/Microsoft/dotnet/tree/main/releases/net481/README.md) -| | Versions | -|-|-| -|**CLR**|4| -|**Windows**|✔️ September 2022 Release (Version 22621)
➕ 11 October 2021 Release (Version 22000)
➕ 10 November 2021 Update
➕ 10 May 2021 Update
➕ 10 October 2020 Update
| -|**Windows Server**|➕ Windows Server 2022
| +| | Versions | +|--------------------|-----------------------| +| **CLR** | 4 | +| **Windows** | ✔️ October 2023 Release (Version 22631)
✔️ September 2022 Release (Version 22621)
➕ 11 October 2021 Release (Version 22000)
➕ 10 November 2021 Update
➕ 10 May 2021 Update
➕ 10 October 2020 Update
| +| **Windows Server** | ➕ Windows Server 2022 | To determine the installed .NET version, use the following `Release` DWORD: -- 533320 (Windows 11 September 2022 Release) +- 533320 (Windows 11 September 2022 Release and Windows 11 October 2023 Release) - 533325 (all other OS versions) For more information, see [instructions](how-to-determine-which-versions-are-installed.md). @@ -74,9 +74,9 @@ For more information, see [instructions](how-to-determine-which-versions-are-ins - [New in accessibility](../whats-new/whats-new-in-accessibility.md#whats-new-in-accessibility-in-net-framework-48) - [Release notes](https://github.com/Microsoft/dotnet/tree/main/releases/net48/README.md) -| | Versions | -|-|-| -|**CLR**|4| +| | Versions | +|---------|----------| +| **CLR** | 4 | |**Windows**|✔️ 11 October 2021 Release (Version 22000)
✔️ 10 November 2021 Update
✔️ 10 May 2021 Update
✔️ 10 October 2020 Update
✔️ 10 May 2020 Update
✔️ 10 November 2019 Update
✔️ 10 May 2019 Update
➕ 10 October 2018 Update (Version 1809)
➕ 10 April 2018 Update (Version 1803)
➕ 10 Fall Creators Update (Version 1709)
➕ 10 Creators Update (Version 1703)
➕ 10 Anniversary Update (Version 1607)
➕ 8.1
➕7| |**Windows Server**|✔️ Windows Server 2022
➕ Windows Server 2019
➕ Windows Server, version 1809
➕ Windows Server, version 1803
➕ 2016
➕ 2012 R2
➕ 2012
➕ 2008 R2 SP1| @@ -95,14 +95,14 @@ For more information, see [instructions](how-to-determine-which-versions-are-ins - [New in accessibility](../whats-new/whats-new-in-accessibility.md#whats-new-in-accessibility-in-net-framework-472) - [Release notes](https://github.com/Microsoft/dotnet/tree/main/releases/net472/README.md) -| | Versions | -|-|-| -|**CLR**|4| -|**Included in Visual Studio**|20191| +| | Versions | +|-------------------------------|----------| +| **CLR** | 4 | +| **Included in Visual Studio** | 2019† | |**Windows**|✔️ 10 October 2018 Update (Version 1809)
✔️ 10 April 2018 Update (Version 1803)
➕ 10 Fall Creators Update (Version 1709)
➕ 10 Creators Update (Version 1703)
➕ 10 Anniversary Update (Version 1607)
➕ 8.1
➕7| |**Windows Server**|✔️ Windows Server 2019
✔️ Windows Server, version 1809
✔️ Windows Server, version 1803
➕ Windows Server, version 1709
➕ 2016
➕ 2012 R2
➕ 2012
➕ 2008 R2 SP1| -1 Requires installing the **.NET desktop development**, **ASP.NET and web development**, **Azure development**, **Office/SharePoint development**, **Mobile development with .NET**, or **.NET Core cross-platform development** workloads. +†Requires installing the **.NET desktop development**, **ASP.NET and web development**, **Azure development**, **Office/SharePoint development**, **Mobile development with .NET**, or **.NET Core cross-platform development** workloads. To determine the installed .NET version, use the following `Release` DWORD: @@ -118,9 +118,9 @@ For more information, see [instructions](how-to-determine-which-versions-are-ins - [New in accessibility](../whats-new/whats-new-in-accessibility.md#whats-new-in-accessibility-in-net-framework-471) - [Release notes](https://github.com/Microsoft/dotnet/tree/main/releases/net471/README.md) -| | Versions | -|-|-| -|**CLR**|4| +| | Versions | +|---------|----------| +| **CLR** | 4 | |**Windows**|✔️ 10 Fall Creators Update (Version 1709)
➕ 10 Creators Update (Version 1703)
➕ 10 Anniversary Update (Version 1607)
➕ 8.1
➕7| |**Windows Server**|➕ Windows Server, version 1803
✔️ Windows Server, version 1709
➕ 2016
➕ 2012 R2
➕ 2012
➕ 2008 R2 SP1|