Merge pull request #17661 from sethmanheim/grph-scrpt

Update Graph API retirement script

Author: prmerger-automator[bot]

azure-stack/operator/graph-api-retirement.md

@@ -4,7 +4,7 @@ description: Learn how to mitigate the retirement of the Entra ID Graph API.
 author: sethmanheim
 ms.author: sethm
 ms.topic: conceptual
-ms.date: 03/14/2025
+ms.date: 04/15/2025
 ms.reviewer: rtiberiu
 
 ---
@@ -39,11 +39,14 @@ $ErrorActionPreference='Stop'
 Import-Module Microsoft.Graph.Authentication
 Import-Module Microsoft.Graph.Applications
  
+# Target your Azure Cloud instance name; use Get-MgEnvironment to list available clouds and Add-MgEnvironment to add new ones as needed for custom private/secure clouds
+$envName = 'Global'
+
 # Repeat this flow for each of your target directory tenants
 $tenantId = 'MyTenantId'
- 
+
 # Sign in with admin permissions to read and write all application objects
-Connect-MgGraph -TenantId $tenantId -Scopes Application.ReadWrite.All
+Connect-MgGraph -Environment $envName -TenantId $tenantId -Scopes Application.ReadWrite.All
  
 # Retrieve all applications in the current directory
 Write-Host "Looking-up all applications in directory '$tenantId'..."
@@ -128,6 +131,20 @@ Found '1' total Azure Stack deployments in directory '<ID>>'
 Found '0' total Azure Stack applications which need permission to continue calling Legacy Microsoft Graph Service 
 ```
 
+The following output from the `Get-MgEnvironment` command shows the default cloud instances that are included when you install the Graph module:
+
+```output
+C:\> Get-MgEnvironment
+
+Name     AzureADEndpoint                   GraphEndpoint                           Type    
+----     ---------------                   -------------                           ----    
+USGovDoD https://login.microsoftonline.us  https://dod-graph.microsoft.us          Built-in
+Germany  https://login.microsoftonline.de  https://graph.microsoft.de              Built-in
+USGov    https://login.microsoftonline.us  https://graph.microsoft.us              Built-in
+China    https://login.chinacloudapi.cn    https://microsoftgraph.chinacloudapi.cn Built-in
+Global   https://login.microsoftonline.com https://graph.microsoft.com             Built-in
+```
+
 ## Next steps
 
 [Azure Stack Hub release notes](release-notes.md)