Merge pull request Azure#957 from SteveMutungi254/main

Adding a deprecation warning on installation page

Author: SteveMutungi254

azureadps-2.0/AzureAD/migrate/New-AzureADGroupAppRoleAssignment.md

@@ -30,7 +30,7 @@ This article provides migration details from New-AzureADGroupAppRoleAssignment c
 View more [details on permissions](/graph/api/group-post-approleassignments#permissions).
 
 > [!NOTE]
-> As a best practice, we recommend creating app role assignments through the [`appRoleAssignedTo` relationship of the _resource_ service principal](serviceprincipal-post-approleassignedto.md), instead of the `appRoleAssignments` relationship of the assigned user, group, or service principal.
+> As a best practice, we recommend creating app role assignments through the [`appRoleAssignedTo` relationship of the _resource_ service principal](/graph/api/serviceprincipal-post-approleassignedto), instead of the `appRoleAssignments` relationship of the assigned user, group, or service principal.
 
 ## Property Mapping
 

docs-conceptual/azureadps-2.0/install-adv2.md

@@ -1,21 +1,24 @@
 ---
 title: 'Install AzureAD PowerShell for Graph'
-description: This provides a guide on the installation process of the Azure AD PowerShell module.
+description: Installation guidance for the Azure AD PowerShell module.
 ms.service: active-directory
 ms.workload: identity
 ms.topic: overview
-ms.date: 02/08/2022
-ms.author: rodejo
+ms.date: 12/16/2023
+ms.author: eunicewaweru
 ms.custom: posh-docs-conceptual
-ms.reviewer: rodejo
+ms.reviewer: stevemutungi
 ---
 # Install Azure Active Directory PowerShell for Graph
 
+>[!IMPORTANT]
+> Azure AD Powershell is planned for deprecation on **March 30, 2024**. For more details on the deprecation plans, see the [deprecation update](https://techcommunity.microsoft.com/t5/microsoft-entra-azure-ad-blog/important-azure-ad-graph-retirement-and-powershell-module/ba-p/3848270). We encourage you to continue migrating to [Microsoft Graph PowerShell](/powershell/microsoftgraph/overview), which is the recommended module for interacting with Azure AD. In addition, Microsoft Graph PowerShell allows you access to all Microsoft Graph APIs and is available on PowerShell 7. For answers to frequent migration queries, see the [Migration FAQ](migration-faq.yml).
+
 You can use the Azure Active Directory PowerShell module version for Graph for Azure AD administrative tasks such as user management, domain management and for configuring single sign-on. The cmdlets listed here are different from the MSOnline cmdlets which are part of Azure Active Directory PowerShell version 1.0.
 
-The Azure AD PowerShell for Graph module has two versions: a Public Preview version and a General Availability (GA) version. It is not recommended to use the Public Preview version for production scenarios.
+The Azure AD PowerShell for Graph module has two versions: a Public Preview version and a General Availability (GA) version. It isn't recommended to use the Public Preview version for production scenarios.
 
-To download the modules from the PowerShell Gallery use the following;
+Download the modules from the PowerShell Gallery use the following;
 - [AzureADPreview](https://www.powershellgallery.com/packages/AzureADPreview)
 - [AzureAD](https://www.powershellgallery.com/packages/AzureAD)
 
@@ -57,7 +60,7 @@ To install the public preview release, run:
 Install-module AzureADPreview
 ```
 
-Note that you cannot install both the preview version and the GA version on the same computer at the same time.
+You cannot install both the preview version and the GA version on the same computer at the same time.
 
 ### About the PowerShell Gallery
 
@@ -106,7 +109,7 @@ ModuleType Version Name                ExportedCommands
 Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...
 ```
 
-To update the version of the Azure AD PowerShell module on your computer, re-run the **Install-Module** cmdlet:
+To update the version of the Azure AD PowerShell module on your computer, rerun the **Install-Module** cmdlet:
 
 ```PowerShell
 Install-Module AzureADPreview
@@ -116,7 +119,7 @@ This command checks the PowerShell gallery to see if a newer version is availabl
 ## Connect to Azure AD
 
 Before you can run any of the cmdlets discussed in this article, you must first connect to your online service.
-To do so, run the cmdlet **Connect-AzureAD** at the Windows PowerShell command prompt. You will then be prompted for your credentials. If you want, you can supply your credentials in advance, for example:
+To do so, run the cmdlet **Connect-AzureAD** at the Windows PowerShell command prompt. You'll then be prompted for your credentials. If you want, you can supply your credentials in advance, for example:
 
 ```PowerShell
 $AzureAdCred = Get-Credential