Installing Exchange Agent 2023.03.27
  • 17 Apr 2023
  • 1 Minute to read
  • Dark

Installing Exchange Agent 2023.03.27

  • Dark

Article summary

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 for more information regarding Microsoft's PowerShell deprecations.

Upgrade Instructions


The instructions below assume that a version of the Exchange Agent using Modern Authentication is already installed and functional.


  • RapidIdentity On-Premise customers must upgrade to 2023.0.0-hotfix1
  • RapidIdentity Cloud customers must be running 2023.01.0-hotfix2


  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
  3. Click Add a Permission:
    Screenshot 2023-03-28 at 1.02.41 PM.png
  4. Click Microsoft Graph:
    Screenshot 2023-03-28 at 1.10.59 PM.png
  5. Click Application Permissions:
    Screenshot 2023-03-28 at 1.12.56 PM.png
  6. Add the following permissions:
    Screenshot 2023-03-28 at 1.15.00 PM.png
  7. Click Grant Admin Consent for < domain >:
    Screenshot 2023-03-28 at 1.18.16 PM.png
  8. Navigate back to Azure Active Directory:
    Screenshot 2023-03-28 at 1.19.52 PM.png
  9. Click Roles and Administrators:
    Screenshot 2023-03-28 at 1.21.18 PM.png
  10. Search for Password Administrator:
    Screenshot 2023-03-28 at 1.22.21 PM.png
  11. Double click on the row that is returned:
    Screenshot 2023-03-28 at 1.23.16 PM.png
  12. Click Add Assignments:
    Screenshot 2023-03-28 at 1.24.13 PM.png
  13. Search for your App Registration name, select the result, and click Add:
    Screenshot 2023-03-28 at 1.25.37 PM.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:


  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

  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

    Screenshot 2023-03-28 at 1.38.13 PM.png

Was this article helpful?