Adding sovereign cloud examples and update environment tables

- Updated environment output tables with BleuCloud, DelosCloud, and GovSGCloud
- Added Example 12: connecting to a sovereign cloud with a custom application
- Added Example 13: disabling WAM when authentication hangs in sovereign clouds
- Added DisableLoginByWAM example to Set-MgGraphOption
- Renumbered existing examples to accommodate new entries

Author: lramosvea

src/Authentication/examples/Connect-MgGraph.md

@@ -65,17 +65,33 @@ Uses a user created managed identity as a standalone Azure resource.
 ### Example 11: Connecting to an environment or cloud
 ```powershell
 PS C:\> Get-MgEnvironment
-Name     AzureADEndpoint                   GraphEndpoint                           Type
-----     ---------------                   -------------                           ----
-China    https://login.chinacloudapi.cn    https://microsoftgraph.chinacloudapi.cn Built-in
-Global   https://login.microsoftonline.com https://graph.microsoft.com             Built-in
-USGov    https://login.microsoftonline.us  https://graph.microsoft.us              Built-in
-USGovDoD https://login.microsoftonline.us  https://dod-graph.microsoft.us          Built-in
+Name         AzureADEndpoint                        GraphEndpoint                           Type
+----         ---------------                        -------------                           ----
+BleuCloud    https://login.sovcloud-identity.fr     https://graph.svc.sovcloud.fr           Built-in
+China        https://login.chinacloudapi.cn         https://microsoftgraph.chinacloudapi.cn Built-in
+DelosCloud   https://login.sovcloud-identity.de     https://graph.svc.sovcloud.de           Built-in
+Global       https://login.microsoftonline.com      https://graph.microsoft.com             Built-in
+GovSGCloud   https://login.sovcloud-identity.sg     https://graph.svc.sovcloud.sg           Built-in
+USGov        https://login.microsoftonline.us       https://graph.microsoft.us              Built-in
+USGovDoD     https://login.microsoftonline.us       https://dod-graph.microsoft.us          Built-in
 PS C:\> Connect-MgGraph -Environment USGov
 ```
 When you use Connect-MgGraph, you can choose to target other environments. By default, Connect-MgGraph targets the global public cloud.
 
-### Example 12: Connecting to an environment as a different identity
+### Example 12: Connecting to a sovereign cloud with a custom application
+```powershell
+PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud -Scopes "User.Read.All"
+```
+Sovereign cloud environments (BleuCloud, DelosCloud, GovSGCloud) require a custom application registration. You cannot use the default Microsoft Graph PowerShell application in these environments. When registering your application, add an additional redirect URI of `ms-appx-web://Microsoft.AAD.BrokerPlugin/<YOUR_APP_CLIENT_ID>` to support WAM broker-based authentication. Requires Microsoft.Graph.Authentication v2.36.1 or later.
+
+### Example 13: Connecting to a sovereign cloud when WAM authentication hangs
+```powershell
+PS C:\> Set-MgGraphOption -DisableLoginByWAM $true
+PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud
+```
+If the authentication popup hangs or times out when connecting to a sovereign cloud (for example, from a jumpbox), WAM broker-based login may not work in that environment. Disable WAM to use interactive browser sign-in instead. You only need to run `Set-MgGraphOption -DisableLoginByWAM $true` once; the setting persists across sessions.
+
+### Example 14: Connecting to an environment as a different identity
 ```powershell
 PS C:\> Connect-MgGraph -ContextScope Process
 ```

src/Authentication/examples/Get-MgEnvironment.md

@@ -1,11 +1,14 @@
 ### Example 1: Get-MgEnvironment
 ```powershell
 PS C:\> Get-MgEnvironment
-Name     AzureADEndpoint                   GraphEndpoint                           Type
-----     ---------------                   -------------                           ----
-China    https://login.chinacloudapi.cn    https://microsoftgraph.chinacloudapi.cn Built-in
-Global   https://login.microsoftonline.com https://graph.microsoft.com             Built-in
-USGov    https://login.microsoftonline.us  https://graph.microsoft.us              Built-in
-USGovDoD https://login.microsoftonline.us  https://dod-graph.microsoft.us          Built-in
+Name         AzureADEndpoint                        GraphEndpoint                           Type
+----         ---------------                        -------------                           ----
+BleuCloud    https://login.sovcloud-identity.fr     https://graph.svc.sovcloud.fr           Built-in
+China        https://login.chinacloudapi.cn         https://microsoftgraph.chinacloudapi.cn Built-in
+DelosCloud   https://login.sovcloud-identity.de     https://graph.svc.sovcloud.de           Built-in
+Global       https://login.microsoftonline.com      https://graph.microsoft.com             Built-in
+GovSGCloud   https://login.sovcloud-identity.sg     https://graph.svc.sovcloud.sg           Built-in
+USGov        https://login.microsoftonline.us       https://graph.microsoft.us              Built-in
+USGovDoD     https://login.microsoftonline.us       https://dod-graph.microsoft.us          Built-in
 ```
 This command gets list of all environments.

src/Authentication/examples/Set-MgGraphOption.md

@@ -3,4 +3,11 @@
 PS C:\> Set-MgGraphOption -EnableLoginByWAM $True
 ```
  Sets web account manager support
- Note: Signin by Web Account Manager (WAM) is enabled by default on Windows and cannot be disabled. Setting this option will no longer have any effect. 
+ Note: Signin by Web Account Manager (WAM) is enabled by default on Windows and cannot be disabled. Setting this option will no longer have any effect. 
+
+### Example 2: Disable WAM for sovereign cloud environments
+```powershell
+PS C:\> Set-MgGraphOption -DisableLoginByWAM $true
+PS C:\> Connect-MgGraph -ClientId "YOUR_APP_CLIENT_ID" -TenantId "YOUR_TENANT_ID" -Environment BleuCloud
+```
+If WAM broker-based authentication hangs or times out when connecting to a sovereign cloud environment (such as BleuCloud, DelosCloud, or GovSGCloud), disable WAM to fall back to interactive browser sign-in. This can occur when authenticating from environments like jumpboxes. The setting persists across PowerShell sessions.