Switching an EWS Service to Microsoft Graph

The standard procedure would be as follows:

1. Create and configure a new Microsoft Graph service.

2. Open all existing jobs and assign the new service to them.

3. Delete the old EWS connection once no jobs are using it anymore.

However, creating a new service may require an additional license for a temporary period. For simple configurations, this step can be avoided by modifying the existing service directly.

Procedure

1. Stop the service and the Configurator.

2. Back up the relevant directory:

   • C:\ProgramData\EEAttachments\

   • C:\ProgramData\ExMixedFolders\

3. In this directory, locate the configuration file whose name corresponds to the name of the service, for example:

   • EWSConnection1.service.settings.conf

4. Open the file in a suitable text editor and change the following entries:

   Replace <IsEWSOAuth>true</IsEWSOAuth> with <IsEWSOAuth>false</IsEWSOAuth>.

   Also replace <ServiceType>EWS</ServiceType> with <ServiceType>MSGRAPH</ServiceType>.

5. Start the Configurator again.

6. Authenticate the existing service against the respective mailbox again. Select the required permissions or, if necessary, configure them directly in the associated app registration in Microsoft Entra ID.

7. Finally, review the existing jobs and make any necessary adjustments.