Merge pull request #233871 from rolyon/rolyon-aad-powershell-graph-zone-pivot-include

[Azure AD] [PowerShell] Zone pivots and include

Author: Stacyrch140

articles/active-directory/includes/aad-powershell-migration-include.md

@@ -0,0 +1,15 @@
+---
+title: include file
+description: include file
+author: rolyon
+manager: amycolannino
+ms.service: active-directory
+ms.workload: identity
+ms.topic: include
+ms.date: 04/10/2023
+ms.author: rolyon
+ms.custom: include file
+---
+
+> [!IMPORTANT]
+> [Azure AD PowerShell](/powershell/azure/active-directory/overview) is planned to be deprecated on June 30, 2023. Microsoft recommends that you use [Microsoft Graph PowerShell](/powershell/microsoftgraph/overview). For more information, see [Upgrade from Azure AD PowerShell to Microsoft Graph PowerShell](/powershell/microsoftgraph/migration-steps).

articles/active-directory/roles/groups-assign-role.md

@@ -90,6 +90,8 @@ $roleAssignment = New-MgRoleManagementDirectoryRoleAssignment -DirectoryScopeId
 
 # [Azure AD PowerShell](#tab/aad-powershell)
 
+[!INCLUDE [aad-powershell-migration-include](../includes/aad-powershell-migration-include.md)]
+
 ### Create a role-assignable group
 
 Use the [New-AzureADMSGroup](/powershell/module/azuread/new-azureadmsgroup?branch=main) command to create a role-assignable group.

articles/zone-pivot-groups.yml

@@ -2272,6 +2272,32 @@ groups:
     title: ASE Pro 2
   - id: ase-pro-gpu
     title: ASE Pro
+# Owner: barclayn, rolyon
+## Zone pivot with Azure portal, Azure AD PowerShell, Microsoft Graph PowerShell, Microsoft Graph
+- id: identity-pivot-portal-aadpowershell-mspowershell-msgraph
+  title: Manage identity
+  prompt: Choose an option
+  pivots:
+  - id: portal
+    title: Azure portal
+  - id: aad-powershell
+    title: Azure AD PowerShell
+  - id: ms-powershell
+    title: Microsoft Graph PowerShell
+  - id: ms-graph
+    title: Microsoft Graph
+# Owner: barclayn, rolyon
+## Zone pivot with Azure portal, Microsoft Graph PowerShell, Microsoft Graph
+- id: identity-pivot-portal-mspowershell-msgraph
+  title: Manage identity
+  prompt: Choose an option
+  pivots:
+  - id: portal
+    title: Azure portal
+  - id: ms-powershell
+    title: Microsoft Graph PowerShell
+  - id: ms-graph
+    title: Microsoft Graph
 # Owner: rolyon
 - id: app-provisioning-cross-tenant-synchronization
   title: Application provisioning or cross-tenant synchronization