Skip to content

Add admin permission callouts for system-wide .NET installations on Windows #49077

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
adegeo merged 4 commits into from
Oct 10, 2025
Merged

Add admin permission callouts for system-wide .NET installations on Windows #49077

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
a2d26be
Initial plan
Copilot Oct 10, 2025
528de58
Add admin permission callouts for system-wide installations
Copilot Oct 10, 2025
88c5ae9
Add ai-usage metadata to frontmatter
Copilot Oct 10, 2025
57ac543
Add admin permission note after default directory explanation
Copilot Oct 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion docs/core/install/windows.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ ms.author: adegeo
ms.topic: install-set-up-deploy #Don't change
ms.date: 11/11/2024
no-loc: ["Program Files", "dotnet"]
ai-usage: ai-assisted
#customer intent: As a developer or user, I want to decide the best way to install .NET on Windows.
---

Expand All @@ -23,6 +24,9 @@ Unlike .NET Framework, .NET isn't tied to your version of Windows. You can only

By default, .NET is installed to the _Program Files\\dotnet_ directory on your computer, unless the installation method chooses a different directory.

> [!IMPORTANT]
> If you're installing .NET system-wide, install with administrative privileges.

.NET is made up of the runtime and the SDK. The runtime runs .NET apps, and the SDK is used to create apps.

## Choose the correct runtime
Expand Down Expand Up @@ -169,6 +173,9 @@ For more information about, see [.NET SDK, MSBuild, and Visual Studio versioning

Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code can use the SDK already installed on your system.

> [!IMPORTANT]
> If you're installing .NET system-wide, install with administrative privileges.

This [WinGet configuration file](https://builds.dotnet.microsoft.com/dotnet/install/dotnet_basic_config_docs.winget) installs the latest .NET SDK, Visual Studio Code and the C# DevKit. If you already have any of them installed, WinGet will skip that step.

01. Download the file and double-click to run it.
Expand All @@ -183,6 +190,9 @@ For instructions on installing .NET through Visual Studio Code, see [Getting Sta

The [download page](https://dotnet.microsoft.com/download/dotnet) for .NET provides Windows Installer executables.

> [!IMPORTANT]
> If you're installing .NET system-wide, install with administrative privileges.

1. Open a web browser and navigate to <https://dotnet.microsoft.com/download/dotnet>.
1. Select the version of .NET you want to download, such as 9.0.
1. Find the SDK or Runtime box that contains the links for downloading .NET.
Expand Down Expand Up @@ -264,7 +274,8 @@ When the removal is deferred, the installer writes a command to the [RunOnce](/w

You can install and manage .NET through the Windows Package Manager service, using the `winget.exe` tool. For more information about how to install and use **WinGet**, see [Use the winget tool to install and manage applications](/windows/package-manager/winget/).

If you're installing .NET system-wide, install with administrative privileges.
> [!IMPORTANT]
> If you're installing .NET system-wide, install with administrative privileges.

The .NET WinGet packages are:

Expand Down