--- title: "Installing Exchange Agent 2023.03.27" slug: "installing-exchange-agent-20230327" description: "Instructions for udating the RapidIdentity Exchange Agent Adapter to the 2023.03.27 version. " tags: ["RapidIdentity Exchange Agent", "Administrator", "How To"] updated: 2023-04-17T17:28:43Z published: 2023-04-17T17:28:43Z canonical: "help.rapididentity.com/installing-exchange-agent-20230327" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.rapididentity.com/llms.txt > Use this file to discover all available pages before exploring further. # Installing Exchange Agent 2023.03.27 ## Upgrading Exchange Agent for Microsoft Online Deprecation Microsoft is retiring several PowerShell modules that can impact the RapidIdentity Exchange Agent, requiring customers to upgrade their RapidIdentity Exchange Agent to the new 2023.03.27 version in advance of Microsoft's change. > *Click [here](/v1/docs/microsoft-powershell-deprecations) for more information regarding Microsoft's PowerShell deprecations.* ### Upgrade Instructions **Note:** The instructions below assume that a version of the Exchange Agent using Modern Authentication is already installed and functional. #### Prerequisites - RapidIdentity On-Premise customers must upgrade to 2023.0.0-hotfix1 - RapidIdentity Cloud customers must be running 2023.01.0-hotfix2 #### Process 1. Log into Azure AD and find your existing *App Registration* for the Exchange Agent. 2. Click *API Permissions*: ![Screenshot 2023-03-28 at 12.59.50 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%2012.59.50%20PM.png) 3. Click *Add a Permission*: ![Screenshot 2023-03-28 at 1.02.41 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.02.41%20PM.png) 4. Click *Microsoft Graph*: ![Screenshot 2023-03-28 at 1.10.59 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.10.59%20PM.png) 5. Click *Application Permissions*: ![Screenshot 2023-03-28 at 1.12.56 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.12.56%20PM.png) 6. Add the following permissions: ![Screenshot 2023-03-28 at 1.15.00 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.15.00%20PM.png) 7. Click *Grant Admin Consent for < domain >*: ![Screenshot 2023-03-28 at 1.18.16 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.18.16%20PM.png) 8. Navigate back to *Azure Active Directory*: ![Screenshot 2023-03-28 at 1.19.52 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.19.52%20PM.png) 9. Click *Roles and Administrators*: ![Screenshot 2023-03-28 at 1.21.18 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.21.18%20PM.png) 10. Search for *Password Administrator*: ![Screenshot 2023-03-28 at 1.22.21 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.22.21%20PM.png) 11. Double click on the row that is returned: ![Screenshot 2023-03-28 at 1.23.16 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.23.16%20PM.png) 12. Click *Add Assignments*: ![Screenshot 2023-03-28 at 1.24.13 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.24.13%20PM.png) 13. Search for your *App Registration* name, select the result, and click *Add*: ![Screenshot 2023-03-28 at 1.25.37 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.25.37%20PM.png) 14. Now, navigate to your Windows server where the Exchange Agent is installed and uninstall it. 15. Install Microsoft Graph Powershell module: ``` Install-Module Microsoft.Graph -Scope AllUsers ``` 1. Install the new Exchange Agent. Download by clicking below: [idautoExchangeAdminWSInstaller-2023.3.27.msi](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/idautoExchangeAdminWSInstaller-2023.3.27.msi) 1. Open the Internet Information Service (IIS) Manager to configure the Agent, navigate to **Application Pools** and select **Advanced Settings** on ** *idautoExchangeAdminWS* and update the application pool for Exchange Agent with the Administrator User and Password. 2. Use the IIS Manager to **Recycle** the ***idautoExchangeAdminWS*** Application Pool. 3. You are ready to test! Use this URL to test: http://localhost/idautoExchangeAdminWS/test ![Screenshot 2023-03-28 at 1.32.53 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.32.53%20PM.png) 4. You will notice that there is a new field: Tenant ID. This corresponds to the Azure Tenant ID, and can be found in the Azure AD Portal in the *App Registration* details. ![Screenshot 2023-03-28 at 1.34.42 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.34.42%20PM.png) ![Screenshot 2023-03-28 at 1.38.13 PM.png](https://cdn.document360.io/4d958006-b877-42af-8de5-00e3bb7fe41d/Images/Documentation/Screenshot%202023-03-28%20at%201.38.13%20PM.png) ## Related - [Microsoft PowerShell Deprecations](/microsoft-powershell-deprecations.md) - [Exchange Agent 2023.03.27 - What's Changed](/exchange-agent-20230327-whats-changed.md)