Merging changes synced from https://github.com/MicrosoftDocs/azure-docs-pr (branch live)

Author: Learn Build Service GitHub App

articles/active-directory/develop/includes/console-app/quickstart-netcore.md

@@ -128,14 +128,14 @@ This quickstart application uses a client secret to identify itself as a confide
 
 This section provides an overview of the code required to sign in users. The overview can be useful to understand how the code works, what the main arguments are, and how to add sign-in to an existing .NET Core console application.
 
-### Microsoft.Identity.Web.MicrosoftGraph
+### Microsoft.Identity.Web.GraphServiceClient
 
-Microsoft Identity Web (in the [Microsoft.Identity.Web.TokenAcquisition](https://www.nuget.org/packages/Microsoft.Identity.Web.TokenAcquisition) package) is the library that's used to request tokens for accessing an API protected by the Microsoft identity platform. This quickstart requests tokens by using the application's own identity instead of delegated permissions. The authentication flow in this case is known as a [client credentials OAuth flow](../../v2-oauth2-client-creds-grant-flow.md). For more information on how to use MSAL.NET with a client credentials flow, see [this article](https://aka.ms/msal-net-client-credentials). Given the daemon app in this quickstart calls Microsoft Graph, you install the [Microsoft.Identity.Web.MicrosoftGraph](https://www.nuget.org/packages/Microsoft.Identity.Web.MicrosoftGraph) package, which handles automatically authenticated requests to Microsoft Graph (and references itself Microsoft.Identity.Web.TokenAcquisition)
+Microsoft Identity Web (in the [Microsoft.Identity.Web.TokenAcquisition](https://www.nuget.org/packages/Microsoft.Identity.Web.TokenAcquisition) package) is the library that's used to request tokens for accessing an API protected by the Microsoft identity platform. This quickstart requests tokens by using the application's own identity instead of delegated permissions. The authentication flow in this case is known as a [client credentials OAuth flow](../../v2-oauth2-client-creds-grant-flow.md). For more information on how to use MSAL.NET with a client credentials flow, see [this article](https://aka.ms/msal-net-client-credentials). Given the daemon app in this quickstart calls Microsoft Graph, you install the [Microsoft.Identity.Web.GraphServiceClient](https://www.nuget.org/packages/Microsoft.Identity.Web.GraphServiceClient) package, which handles automatically authenticated requests to Microsoft Graph (and references itself Microsoft.Identity.Web.TokenAcquisition)
 
-Microsoft.Identity.Web.MicrosoftGraph can be installed by running the following command in the Visual Studio Package Manager Console:
+Microsoft.Identity.Web.GraphServiceClient can be installed by running the following command in the Visual Studio Package Manager Console:
 
 ```dotnetcli
-dotnet add package Microsoft.Identity.Web.MicrosoftGraph
+dotnet add package Microsoft.Identity.Web.GraphServiceClient
 ```
 
 ### Application initialization
@@ -203,9 +203,7 @@ To request a token by using the app's identity, use the `AcquireTokenForClient`
 ```csharp
 GraphServiceClient graphServiceClient = serviceProvider.GetRequiredService<GraphServiceClient>();
 var users = await graphServiceClient.Users
-              .Request()
-              .WithAppOnly()
-              .GetAsync();
+              .GetAsync(r => r.Options.WithAppOnly());
 ```
 
 [!INCLUDE [Help and support](../../../../../includes/active-directory-develop-help-support-include.md)]

articles/active-directory/develop/includes/web-app/quickstart-aspnet-core.md

@@ -162,7 +162,7 @@ The controller or its methods can be protected by applying the `[Authorize]` att
 [AuthorizeForScopes(ScopeKeySection = "DownstreamApi:Scopes")]
 public async Task<IActionResult> Index()
 {
-    var user = await _graphServiceClient.Me.Request().GetAsync();
+    var user = await _graphServiceClient.Me.GetAsync();
     ViewData["ApiResult"] = user.DisplayName;
 
     return View();

articles/active-directory/develop/includes/web-app/quickstart-aspnet.md

@@ -101,7 +101,7 @@ You can set up the authentication pipeline with cookie-based authentication by u
 
 ```powershell
 Install-Package Microsoft.Identity.Web.Owin
-Install-Package Microsoft.Identity.Web.MicrosoftGraph
+Install-Package Microsoft.Identity.Web.GraphServiceClient
 Install-Package Microsoft.Owin.Security.Cookies
 ```
 
@@ -167,7 +167,7 @@ You can call Microsoft Graph from the controller by getting the instance of Grap
 ```csharp
     try
     { 
-        var me = await this.GetGraphServiceClient().Me.Request().GetAsync();
+        var me = await this.GetGraphServiceClient().Me.GetAsync();
         ViewBag.Username = me.DisplayName;
     }
     catch (ServiceException graphEx) when (graphEx.InnerException is MicrosoftIdentityWebChallengeUserException)

articles/active-directory/develop/microsoft-identity-web.md

@@ -36,8 +36,8 @@ Microsoft Identity Web is available on NuGet as a set of packages that provide m
 
 - [Microsoft.Identity.Web](https://www.nuget.org/packages/Microsoft.Identity.Web) - The main package. Required by all apps that use Microsoft Identity Web.
 - [Microsoft.Identity.Web.UI](https://www.nuget.org/packages/Microsoft.Identity.Web.UI) - Optional. Adds UI for user sign-in and sign-out and an associated controller for web apps.
-- [Microsoft.Identity.Web.MicrosoftGraph](https://www.nuget.org/packages/Microsoft.Identity.Web.MicrosoftGraph) - Optional. Provides simplified interaction with the Microsoft Graph API.
-- [Microsoft.Identity.Web.MicrosoftGraphBeta](https://www.nuget.org/packages/Microsoft.Identity.Web.MicrosoftGraphBeta) - Optional. Provides simplified interaction with the Microsoft Graph API [beta endpoint](/graph/api/overview?view=graph-rest-beta&preserve-view=true).
+- [Microsoft.Identity.Web.GraphServiceClient](https://www.nuget.org/packages/Microsoft.Identity.Web.GraphServiceClient) - Optional. Provides simplified interaction with the Microsoft Graph API.
+- [Microsoft.Identity.Web.GraphServiceClientBeta](https://www.nuget.org/packages/Microsoft.Identity.Web.GraphServiceClientBeta) - Optional. Provides simplified interaction with the Microsoft Graph API [beta endpoint](/graph/api/overview?view=graph-rest-beta&preserve-view=true).
 
 ## Install by using a Visual Studio project template
 

articles/active-directory/develop/multi-service-web-app-access-microsoft-graph-as-app.md

@@ -132,9 +132,9 @@ The [ChainedTokenCredential](/dotnet/api/azure.identity.chainedtokencredential),
 
 To see this code as part of a sample application, see the [sample on GitHub](https://github.com/Azure-Samples/ms-identity-easyauth-dotnet-storage-graphapi/tree/main/3-WebApp-graphapi-managed-identity).
 
-### Install the Microsoft.Identity.Web.MicrosoftGraph client library package
+### Install the Microsoft.Identity.Web.GraphServiceClient client library package
 
-Install the [Microsoft.Identity.Web.MicrosoftGraph NuGet package](https://www.nuget.org/packages/Microsoft.Identity.Web.MicrosoftGraph) in your project by using the .NET Core command-line interface or the Package Manager Console in Visual Studio.
+Install the [Microsoft.Identity.Web.GraphServiceClient NuGet package](https://www.nuget.org/packages/Microsoft.Identity.Web.GraphServiceClient) in your project by using the .NET Core command-line interface or the Package Manager Console in Visual Studio.
 
 #### .NET Core command-line
 
@@ -143,7 +143,7 @@ Open a command line, and switch to the directory that contains your project file
 Run the install commands.
 
 ```dotnetcli
-dotnet add package Microsoft.Identity.Web.MicrosoftGraph
+dotnet add package Microsoft.Identity.Web.GraphServiceClient
 dotnet add package Microsoft.Graph
 ```
 
@@ -153,7 +153,7 @@ Open the project/solution in Visual Studio, and open the console by using the **
 
 Run the install commands.
 ```powershell
-Install-Package Microsoft.Identity.Web.MicrosoftGraph
+Install-Package Microsoft.Identity.Web.GraphServiceClient
 Install-Package Microsoft.Graph
 ```
 
@@ -189,7 +189,6 @@ public async Task OnGetAsync()
     List<MSGraphUser> msGraphUsers = new List<MSGraphUser>();
     try
     {
-        //var users = await graphServiceClient.Users.Request().GetAsync();
         var users = await graphServiceClient.Users.GetAsync();
         foreach (var u in users.Value)
         {

articles/active-directory/develop/multi-service-web-app-access-microsoft-graph-as-user.md

@@ -137,7 +137,7 @@ To see this code as part of a sample application, see the [sample on GitHub](htt
 
 ### Install client library packages
 
-Install the [Microsoft.Identity.Web](https://www.nuget.org/packages/Microsoft.Identity.Web/) and [Microsoft.Identity.Web.MicrosoftGraph](https://www.nuget.org/packages/Microsoft.Identity.Web.MicrosoftGraph) NuGet packages in your project by using the .NET Core command-line interface or the Package Manager Console in Visual Studio.
+Install the [Microsoft.Identity.Web](https://www.nuget.org/packages/Microsoft.Identity.Web/) and [Microsoft.Identity.Web.GraphServiceClient](https://www.nuget.org/packages/Microsoft.Identity.Web.GraphServiceClient) NuGet packages in your project by using the .NET Core command-line interface or the Package Manager Console in Visual Studio.
 
 #### .NET Core command line
 
@@ -146,7 +146,7 @@ Open a command line, and switch to the directory that contains your project file
 Run the install commands.
 
 ```dotnetcli
-dotnet add package Microsoft.Identity.Web.MicrosoftGraph
+dotnet add package Microsoft.Identity.Web.GraphServiceClient
 
 dotnet add package Microsoft.Identity.Web
 ```
@@ -157,7 +157,7 @@ Open the project/solution in Visual Studio, and open the console by using the **
 
 Run the install commands.
 ```powershell
-Install-Package Microsoft.Identity.Web.MicrosoftGraph
+Install-Package Microsoft.Identity.Web.GraphServiceClient
 
 Install-Package Microsoft.Identity.Web
 ```
@@ -256,11 +256,11 @@ public class IndexModel : PageModel
     {
         try
         {
-            var user = await _graphServiceClient.Me.Request().GetAsync();
+            var user = await _graphServiceClient.Me.GetAsync();
             ViewData["Me"] = user;
             ViewData["name"] = user.DisplayName;
 
-            using (var photoStream = await _graphServiceClient.Me.Photo.Content.Request().GetAsync())
+            using (var photoStream = await _graphServiceClient.Me.Photo.Content.GetAsync())
             {
                 byte[] photoByte = ((MemoryStream)photoStream).ToArray();
                 ViewData["photo"] = Convert.ToBase64String(photoByte);

articles/active-directory/develop/quickstart-v2-aspnet-core-webapp-calls-graph.md

@@ -139,8 +139,8 @@ ms.custom: devx-track-csharp, aaddev, "scenarios:getting-started", "languages:as
 > [AuthorizeForScopes(ScopeKeySection = "DownstreamApi:Scopes")]
 > public async Task<IActionResult> Index()
 > {
->     var user = await _graphServiceClient.Me.Request().GetAsync();
->     ViewData["ApiResult"] = user.DisplayName;
+>     var user = await _graphServiceClient.Me.GetAsync();
+>     ViewData["ApiResult"] = user?.DisplayName;
 > 
 >     return View();
 > }

articles/active-directory/develop/quickstart-v2-netcore-daemon.md

@@ -102,14 +102,14 @@ ms.custom: devx-track-csharp, aaddev, identityplatformtop40, "scenarios:getting-
 >
 > ![Diagram that shows how the sample app generated by this quickstart works.](media/quickstart-v2-netcore-daemon/> netcore-daemon-intro.svg)
 >
-> ### Microsoft.Identity.Web.MicrosoftGraph
+> ### Microsoft.Identity.Web.GraphServiceClient
 >
-> Microsoft Identity Web (in the [Microsoft.Identity.Web.TokenAcquisition](https://www.nuget.org/packages/Microsoft.Identity.Web.TokenAcquisition) package) is the library that's used to request tokens for accessing an API protected by the Microsoft identity platform. This quickstart requests tokens by using the application's own identity instead of delegated permissions. The authentication flow in this case is known as a [client credentials OAuth flow](v2-oauth2-client-creds-grant-flow.md). For more information on how to use MSAL.NET with a client credentials flow, see [this article](https://aka.ms/msal-net-client-credentials). Given the daemon app in this quickstart calls Microsoft Graph, you install the [Microsoft.Identity.Web.MicrosoftGraph](https://www.nuget.org/packages/Microsoft.Identity.Web.MicrosoftGraph) package, which handles automatically authenticated requests to Microsoft Graph (and references itself Microsoft.Identity.Web.TokenAcquisition)
+> Microsoft Identity Web (in the [Microsoft.Identity.Web.TokenAcquisition](https://www.nuget.org/packages/Microsoft.Identity.Web.TokenAcquisition) package) is the library that's used to request tokens for accessing an API protected by the Microsoft identity platform. This quickstart requests tokens by using the application's own identity instead of delegated permissions. The authentication flow in this case is known as a [client credentials OAuth flow](v2-oauth2-client-creds-grant-flow.md). For more information on how to use MSAL.NET with a client credentials flow, see [this article](https://aka.ms/msal-net-client-credentials). Given the daemon app in this quickstart calls Microsoft Graph, you install the [Microsoft.Identity.Web.GraphServiceClient](https://www.nuget.org/packages/Microsoft.Identity.Web.GraphServiceClient) package, which handles automatically authenticated requests to Microsoft Graph (and references itself Microsoft.Identity.Web.TokenAcquisition)
 >
-> Microsoft.Identity.Web.MicrosoftGraph can be installed by running the following command in the Visual Studio Package Manager Console:
+> Microsoft.Identity.Web.GraphServiceClient can be installed by running the following command in the Visual Studio Package Manager Console:
 >
 > ```dotnetcli
-> dotnet add package Microsoft.Identity.Web.MicrosoftGraph
+> dotnet add package Microsoft.Identity.Web.GraphServiceClient
 > ```
 >
 > ### Application initialization
@@ -177,9 +177,7 @@ ms.custom: devx-track-csharp, aaddev, identityplatformtop40, "scenarios:getting-
 > ```csharp
 > GraphServiceClient graphServiceClient = serviceProvider.GetRequiredService<GraphServiceClient>();
 > var users = await graphServiceClient.Users
->               .Request()
->               .WithAppOnly()
->               .GetAsync();
+>               .GetAsync(r => r.Options.WithAppOnly());
 > ```
 >
 > [!INCLUDE [Help and support](../../../includes/active-directory-develop-help-support-include.md)]

articles/active-directory/develop/scenario-daemon-app-configuration.md

@@ -70,7 +70,7 @@ Here's an example of defining the configuration in an [*appsettings.json*](https
 
 ```
 
-You provide a certificate instead of the client secret, or [workload identity federation](/azure/active-directory/workload-identities/workload-identity-federation.md) credentials.
+You provide a certificate instead of the client secret, or [workload identity federation](../workload-identities/workload-identity-federation.md) credentials.
 
 # [Java](#tab/java)
 
@@ -161,7 +161,7 @@ Reference the MSAL package in your application code.
 # [.NET](#tab/idweb)
 
 Add the [Microsoft.Identity.Web.TokenAcquisition](https://www.nuget.org/packages/Microsoft.Identity.Web.TokenAcquisition) NuGet package to your application. 
-Alternatively, if you want to call Microsoft Graph, add the [Microsoft.Identity.Web.MicrosoftGraph](https://www.nuget.org/packages/Microsoft.Identity.Web.MicrosoftGraph) package.
+Alternatively, if you want to call Microsoft Graph, add the [Microsoft.Identity.Web.GraphServiceClient](https://www.nuget.org/packages/Microsoft.Identity.Web.GraphServiceClient) package.
 Your project could be as follows. The *appsettings.json* file needs to be copied to the output directory.
 
 ```xml
@@ -174,7 +174,7 @@ Your project could be as follows. The *appsettings.json* file needs to be copied
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.Identity.Web.MicrosoftGraph" Version="2.6.1" />
+    <PackageReference Include="Microsoft.Identity.Web.GraphServiceClient" Version="2.12.2" />
   </ItemGroup>
 
   <ItemGroup>
@@ -452,7 +452,7 @@ app = ConfidentialClientApplicationBuilder.Create(config.ClientId)
 # [.NET](#tab/idweb)
 
 Instead of a client secret or a certificate, the confidential client application can also prove its identity by using client assertions. See
-[CredentialDescription](/dotnet/api/microsoft.identity.abstractions.credentialdescription?view=msal-model-dotnet-latest) for details.
+[CredentialDescription](/dotnet/api/microsoft.identity.abstractions.credentialdescription?view=msal-model-dotnet-latest&preserve-view=true) for details.
 
 # [Java](#tab/java)
 

articles/active-directory/develop/scenario-daemon-call-api.md

@@ -59,9 +59,7 @@ try
 {
     GraphServiceClient graphServiceClient = serviceProvider.GetRequiredService<GraphServiceClient>();
     var users = await graphServiceClient.Users
-        .Request()
-        .WithAppOnly()
-        .GetAsync();
+        .GetAsync(r => r.Options.WithAppOnly());
     Console.WriteLine($"{users.Count} users");
     Console.ReadKey();
 }