Skip to content

Merge main into live #55886

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

Open
dotnet-policy-service wants to merge 10 commits into
base: live
Choose a base branch
from
Open

Merge main into live #55886

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
290e22b
Add .NET 11 breaking change: restore doesn't search the global packag…
Copilot Sep 3, 2026
d5e8dbc
Bump the dotnet group with 2 updates (#55868)
dependabot[bot] Sep 3, 2026
9014681
Bump the dotnet group with 2 updates (#55867)
dependabot[bot] Sep 3, 2026
5b613a4
Bump the dotnet group with 1 update (#55852)
dependabot[bot] Sep 3, 2026
59042a3
Bump the dotnet group with 1 update (#55848)
dependabot[bot] Sep 3, 2026
5a8372e
Update package index with latest published versions (#55882)
azure-sdk-automation[bot] Sep 3, 2026
c918d08
Add known issue to 08-11-august-cumulative-update.md (#55871)
TaraOverfield Sep 4, 2026
369d33a
Update package index with latest published versions (#55883)
azure-sdk-automation[bot] Sep 4, 2026
55e6c9e
Add Kubernetes Resource Monitoring documentation (#54134)
amadeuszl Sep 4, 2026
6b94bd8
Document launch profiles for dotnet run (#55785)
tannergooding Sep 4, 2026
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
16 changes: 8 additions & 8 deletions docs/azure/includes/dotnet-all.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,7 @@
| Resource Management - Compute Bulk Actions | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ComputeBulkActions/1.0.0-beta.1) | | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeBulkActions_1.0.0-beta.1/sdk/computebulkactions/Azure.ResourceManager.ComputeBulkActions/) |
| Resource Management - Compute Fleet | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.ComputeFleet/1.0.0)<br>NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.ComputeFleet/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeFleet-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeFleet_1.0.0/sdk/computefleet/Azure.ResourceManager.ComputeFleet/)<br>GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeFleet_1.1.0-beta.3/sdk/computefleet/Azure.ResourceManager.ComputeFleet/) |
| Resource Management - Compute Limit | NuGet [1.4.0](https://www.nuget.org/packages/Azure.ResourceManager.ComputeLimit/1.4.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeLimit-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeLimit_1.4.0/sdk/computelimit/Azure.ResourceManager.ComputeLimit/) |
| Resource Management - Compute Recommender | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute.Recommender/1.0.0)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Compute.Recommender/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute.Recommender-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute.Recommender_1.0.0/sdk/computerecommender/Azure.ResourceManager.Compute.Recommender/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute.Recommender_1.1.0-beta.1/sdk/computerecommender/Azure.ResourceManager.Compute.Recommender/) |
| Resource Management - Compute Recommender | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute.Recommender/1.0.0)<br>NuGet [1.1.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Compute.Recommender/1.1.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute.Recommender-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute.Recommender_1.0.0/sdk/computerecommender/Azure.ResourceManager.Compute.Recommender/)<br>GitHub [1.1.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute.Recommender_1.1.0-beta.2/sdk/computerecommender/Azure.ResourceManager.Compute.Recommender/) |
| Resource Management - Compute Schedule | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ComputeSchedule/1.1.0)<br>NuGet [1.2.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.ComputeSchedule/1.2.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeSchedule-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeSchedule_1.1.0/sdk/computeschedule/Azure.ResourceManager.ComputeSchedule/)<br>GitHub [1.2.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeSchedule_1.2.0-beta.5/sdk/computeschedule/Azure.ResourceManager.ComputeSchedule/) |
| Resource Management - Confidential Ledger | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ConfidentialLedger-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.1.0/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/) |
| Resource Management - Confluent | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.Confluent/1.2.1)<br>NuGet [1.3.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Confluent/1.3.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Confluent-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Confluent_1.2.1/sdk/confluent/Azure.ResourceManager.Confluent/)<br>GitHub [1.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Confluent_1.3.0-beta.1/sdk/confluent/Azure.ResourceManager.Confluent/) |
Expand Down Expand Up @@ -469,13 +469,13 @@
| App Configuration Provider | NuGet [8.6.0](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.AspNetCore/8.6.0)<br>NuGet [8.7.0-preview](https://www.nuget.org/packages/Microsoft.Azure.AppConfiguration.AspNetCore/8.7.0-preview) | | |
| Azure Functions CLI | NuGet [5.0.0-preview.1](https://www.nuget.org/packages/Azure.Functions.Cli.Abstractions/5.0.0-preview.1) | | |
| Azure Functions SDK | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Functions.Sdk/1.0.0) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp/1.0.0)<br>NuGet [3.0.0-beta.40](https://www.nuget.org/packages/Azure.Mcp/3.0.0-beta.40) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.linux-arm64/1.0.0)<br>NuGet [3.0.0-beta.40](https://www.nuget.org/packages/Azure.Mcp.linux-arm64/3.0.0-beta.40) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.linux-x64/1.0.0)<br>NuGet [3.0.0-beta.40](https://www.nuget.org/packages/Azure.Mcp.linux-x64/3.0.0-beta.40) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.osx-arm64/1.0.0)<br>NuGet [3.0.0-beta.40](https://www.nuget.org/packages/Azure.Mcp.osx-arm64/3.0.0-beta.40) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.osx-x64/1.0.0)<br>NuGet [3.0.0-beta.40](https://www.nuget.org/packages/Azure.Mcp.osx-x64/3.0.0-beta.40) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.win-arm64/1.0.0)<br>NuGet [3.0.0-beta.40](https://www.nuget.org/packages/Azure.Mcp.win-arm64/3.0.0-beta.40) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.win-x64/1.0.0)<br>NuGet [3.0.0-beta.40](https://www.nuget.org/packages/Azure.Mcp.win-x64/3.0.0-beta.40) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp/1.0.0)<br>NuGet [3.0.0-beta.41](https://www.nuget.org/packages/Azure.Mcp/3.0.0-beta.41) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.linux-arm64/1.0.0)<br>NuGet [3.0.0-beta.41](https://www.nuget.org/packages/Azure.Mcp.linux-arm64/3.0.0-beta.41) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.linux-x64/1.0.0)<br>NuGet [3.0.0-beta.41](https://www.nuget.org/packages/Azure.Mcp.linux-x64/3.0.0-beta.41) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.osx-arm64/1.0.0)<br>NuGet [3.0.0-beta.41](https://www.nuget.org/packages/Azure.Mcp.osx-arm64/3.0.0-beta.41) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.osx-x64/1.0.0)<br>NuGet [3.0.0-beta.41](https://www.nuget.org/packages/Azure.Mcp.osx-x64/3.0.0-beta.41) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.win-arm64/1.0.0)<br>NuGet [3.0.0-beta.41](https://www.nuget.org/packages/Azure.Mcp.win-arm64/3.0.0-beta.41) | | |
| Azure MCP | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Mcp.win-x64/1.0.0)<br>NuGet [3.0.0-beta.41](https://www.nuget.org/packages/Azure.Mcp.win-x64/3.0.0-beta.41) | | |
| Azure MCP Types Internal | NuGet [0.2.804](https://www.nuget.org/packages/Microsoft.Azure.Mcp.AzTypes.Internal.Compact/0.2.804) | | |
| Azure.Communication.Administration | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.Communication.Administration/1.0.0-beta.3) | | |
| Caching - PostgreSQL | NuGet [1.2.2](https://www.nuget.org/packages/Microsoft.Extensions.Caching.Postgres/1.2.2) | | |
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/includes/dotnet-new.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -270,7 +270,7 @@
| Resource Management - Compute Bulk Actions | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ComputeBulkActions/1.0.0-beta.1) | | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeBulkActions_1.0.0-beta.1/sdk/computebulkactions/Azure.ResourceManager.ComputeBulkActions/) |
| Resource Management - Compute Fleet | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.ComputeFleet/1.0.0)<br>NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.ComputeFleet/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeFleet-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeFleet_1.0.0/sdk/computefleet/Azure.ResourceManager.ComputeFleet/)<br>GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeFleet_1.1.0-beta.3/sdk/computefleet/Azure.ResourceManager.ComputeFleet/) |
| Resource Management - Compute Limit | NuGet [1.4.0](https://www.nuget.org/packages/Azure.ResourceManager.ComputeLimit/1.4.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeLimit-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeLimit_1.4.0/sdk/computelimit/Azure.ResourceManager.ComputeLimit/) |
| Resource Management - Compute Recommender | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute.Recommender/1.0.0)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Compute.Recommender/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute.Recommender-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute.Recommender_1.0.0/sdk/computerecommender/Azure.ResourceManager.Compute.Recommender/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute.Recommender_1.1.0-beta.1/sdk/computerecommender/Azure.ResourceManager.Compute.Recommender/) |
| Resource Management - Compute Recommender | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute.Recommender/1.0.0)<br>NuGet [1.1.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Compute.Recommender/1.1.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute.Recommender-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute.Recommender_1.0.0/sdk/computerecommender/Azure.ResourceManager.Compute.Recommender/)<br>GitHub [1.1.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute.Recommender_1.1.0-beta.2/sdk/computerecommender/Azure.ResourceManager.Compute.Recommender/) |
| Resource Management - Compute Schedule | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ComputeSchedule/1.1.0)<br>NuGet [1.2.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.ComputeSchedule/1.2.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.ComputeSchedule-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeSchedule_1.1.0/sdk/computeschedule/Azure.ResourceManager.ComputeSchedule/)<br>GitHub [1.2.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ComputeSchedule_1.2.0-beta.5/sdk/computeschedule/Azure.ResourceManager.ComputeSchedule/) |
| Resource Management - Confidential Ledger | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ConfidentialLedger-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.1.0/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/) |
| Resource Management - Confluent | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.Confluent/1.2.1)<br>NuGet [1.3.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Confluent/1.3.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Confluent-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Confluent_1.2.1/sdk/confluent/Azure.ResourceManager.Confluent/)<br>GitHub [1.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Confluent_1.3.0-beta.1/sdk/confluent/Azure.ResourceManager.Confluent/) |
Expand Down
1 change: 1 addition & 0 deletions docs/core/compatibility/11.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,6 +111,7 @@ See [Breaking changes in EF Core 11](/ef/core/what-is-new/ef-core-11.0/breaking-
| [NativeAOT CLI command handling enabled by default](sdk/11/native-cli-command-handling-enabled.md) | Behavioral change |
| [NU1703 warns for packages that use deprecated MonoAndroid framework assets](sdk/11/nu1703-deprecated-monoandroid-framework.md) | Source incompatible |
| [NuGet pack warns for package IDs with restricted characters](sdk/11/nuget-pack-nu5052-packageid.md) | Behavioral change |
| [Restore doesn't search global packages folder for higher version](sdk/11/restore-global-packages-folder-version-search.md) | Source incompatible |
| [SDK local container runtime selection prefers platform-native tools](sdk/11/native-local-container-runtimes.md) | Behavioral change |
| [Template engine packages no longer support netstandard2.0](sdk/11/template-engine-netstandard.md) | Binary/source incompatible |
| [VSTest removes dependency on Newtonsoft.Json](sdk/11/vstest-removes-newtonsoft-json.md) | Binary/source incompatible |
52 changes: 52 additions & 0 deletions docs/core/compatibility/sdk/11/restore-global-packages-folder-version-search.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
title: "Breaking change: Restore doesn't search the global packages folder for a higher package version"
description: "Learn about the breaking change in .NET 11 where NuGet restore no longer considers versions in the global packages folder when it selects a higher package version."
ms.date: 09/01/2026
ai-usage: ai-assisted
---

# Restore doesn't search the global packages folder for a higher package version

When a `PackageReference` or package dependency requests a package version that doesn't exist, NuGet restore searches for the lowest version that's higher than the requested version. NuGet restore no longer includes the versions in the global packages folder in that search.

## Version introduced

.NET 11 RC 1

## Previous behavior

Previously, when restore couldn't find the requested version, it searched both the package sources and the global packages folder for the "next best" version, that is, the lowest version that's higher than the requested version. Restore selected that version and raised an [NU1603](/nuget/reference/errors-and-warnings/nu1603) warning. If no higher version was found, restore reported an NU1102 error.

| Package source | Global packages folder | Requested version | Version selected | Restore outcome |
|----------------|------------------------|-------------------|------------------|-----------------|
| 1.0.0, 2.0.0 | 1.5.0 | 1.1.0 | 1.5.0 | NU1603 warning |
| 1.0.0 | 1.5.0 | 1.1.0 | 1.5.0 | NU1603 warning |

## New behavior

Starting in .NET 11, restore searches only the package sources for the "next best" version. Because the global packages folder is excluded from the search, restore might select a higher version than before, or fail with an [NU1102 error](/nuget/reference/errors-and-warnings/nu1102) if no package source has a higher version.

| Package source | Global packages folder | Requested version | Version selected | Restore outcome |
|----------------|------------------------|-------------------|------------------|-----------------|
| 1.0.0, 2.0.0 | 1.5.0 | 1.1.0 | 2.0.0 | NU1603 warning |
| 1.0.0 | 1.5.0 | 1.1.0 | n/a | NU1102 error |

If the global packages folder contains the exact requested version, restore uses that version, even if no package source has that version. This behavior is unchanged.

## Type of breaking change

This change can affect [source compatibility](../../categories.md#source-compatibility).

## Reason for change

Restore is now more deterministic and repeatable. For performance reasons, NuGet doesn't validate that packages in the global packages folder match the packages on the package sources. However, restore now selects the same package version on different computers, where the global packages folder might contain different versions.

## Recommended action

Reference only package versions that exist on your package sources. This practice ensures that the version selected during restore doesn't change over time as new versions are published to the package sources.

For more information, see [Best practices for a secure software supply chain](/nuget/concepts/security-best-practices).

## Affected APIs

None.
2 changes: 2 additions & 0 deletions docs/core/compatibility/toc.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,8 @@ items:
href: sdk/11/nu1703-deprecated-monoandroid-framework.md
- name: NuGet pack warns for package IDs with restricted characters
href: sdk/11/nuget-pack-nu5052-packageid.md
- name: Restore doesn't search global packages folder for higher version
href: sdk/11/restore-global-packages-folder-version-search.md
- name: SDK local container runtime selection prefers platform-native tools
href: sdk/11/native-local-container-runtimes.md
- name: Template engine packages no longer support netstandard2.0
Expand Down
Loading
Loading