Troubleshooting Tips

If the MSOnline PowerShell module is not installed, you will not be able to run the MFA settings management action.

Steps to install MSOnline Module

1. To check if this module is installed, open PowerShell and enter the following cmdlet:

   Get-Module -ListAvailable -Name MSOnline.

   This will list the module if it is installed.

2. If the version of the module installed is other than 1. 1. 183. 81, uninstall the MSOnline module by opening PowerShell as an administrator and entering the following cmdlet:

   Uninstall-Module MSOnline

3. To install the module, open PowerShell as an administrator and enter the following cmdlet:

   Install-Module -Name MSOnline -RequiredVersion 1.1.183.81 -Force

4. After installing the module, please restart the application.
5. After starting the application, refresh the tenant data.
   • Click Tenant Settings found in the top right corner.
   • Under Actions,Click on icon of the tenant.

1. Uninstall the old version of MSOnline module v1.0:

   • Open Control Panel and click on Uninstall a program.
   • Search for Windows Azure Active Directory Module For Windows PowerShell, select it, and click Uninstall.

2. Install the latest MSOnline module using the following command

   • Install-Module -Name MSOnline -RequiredVersion 1.1.183.81 -Force

You must be using 32 bit version of M365 Manager Plus. Windows Azure Active Directory Module v2 (AzureAD) must be installed to manage and generate reports on Azure Active Directory, which is not available in 32 bit version.

Hence follow the below mentioned steps,

1. Download and install M365 Manager Plus (64-bit)

2. To install Azure Active Directory Module v2 (Azure AD):

• Install PowerShellGet using this link
• Install nuget package provide in PowerShell with the following command Install-PackageProvider -Name Nuget -MinimumVersion 2.8.5.201 -Force;
• Now, use the below command to install Azure AD v2 (AzureAD) module Install-Module -Name AzureAD -Force
• If the problem still persists, your firewall might be blocking it. Please contact m365managerplus-support@manageengine.com.

If MicrosoftTeams module is not installed, you will not be able to view any general reports on Skype for Business.

Note: PowerShell version 5.1 or higher is required to install MicrosoftTeams PowerShell module.

1. To check if the module is installed, open PowerShell and enter Get-module -ListAvailable -Name MicrosoftTeams. If MicrosoftTeams module is already installed, it will be listed in the result. If not, run the below PowerShell command in as an administrator,

   • Install-Module -Name MicrosoftTeams -Force;

2. After installing the module, please restart the application.

You must be using 32 bit version of M365 Manager Plus. MicrosoftTeams, which is required to generate reports on Skype for Business is not available for 32-bit version.

To resolve this issue,

1. Download and install M365 Manager Plus (64-bit)

2. Follow these steps to install MicrosoftTeams module.

3. After installing the module, please restart the application.

Microsoft retired all the earlier versions of the Microsoft Teams PowerShell module from June 15, 2022. Only the module versions present in the 4.x.x series or later are supported now. Therefore, it is recommended to update the Microsoft Teams PowerShell module to the latest version available for smooth functioning of the product.

Follow the steps below to update the Microsoft Teams PowerShell module:

1. Run the PowerShell command below as an administrator on the machine where the product is installed:

   • Update-Module -Name MicrosoftTeams -Force;

2. Once the module has been updated, please restart the product.

3. If the problem persists please contact m365managerplus-support@manageengine.com.

For General Skype reports, Microsoft .NET framework version 4.8 or higher is required.

1. To check if Microsoft .NET Framework is installed, open the Command Prompt from Run. Enter the following command:

   reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\full" /v version

2. Check the displayed version. If the version is below 4.8, install Microsoft .NET Framework version 4.8 from here.

1. The product requires an active internet connection to interact and function as desired. Please make sure that your internet connection is active and stable.

2. To allow the product to interact with Microsoft 365, add these ports and url’s to your firewall’s allowed to connect to the internet list. Failure to do so will result in certain features not working as intended.

PostgreSQL

The backup fails due to one of the following reasons.

1. The backup file size exceeds the available free space.
• Free up some space in the product installation directory and try again.
2. User Logon Account does not have Write permission for the backup folder
• Provide the User Logon Account Write permission for <product_installation_directory>/Patch/backupDB folder.
3. The database is down.
• Bundled PostgreSQL users,
• Navigate to <product _installation_directory>\bin folder
• Start Command Prompt as an administrator
• Execute the command startDB.bat to start the database.
• External PostgreSQL users,
• Open Run window using Winkey + R
• Type services.msc
• Locate PostgreSQL service based on version installed.
• Right click and choose Start.
• If the External PostgreSQL is not listed
• Open Command Prompt
• Navigate to <postgres_installation_directory>\bin
• Execute pg_ctl -D "<postgres_installation_directory>\data" start
4. Missing pg_dump.exe file in the <product _installation_directory>\pgsql\bin folder.
• Download the file from this page based on the PostgreSQL version you are on. To find the PostgreSQL version. Run the below command in <product _installation_directory>\pgsql folder.
• postgres -V

If the problem still persists please contact m365managerplus-support@manageengine.com.

MSSQL

The backup fails due to one of the following reasons.

1. The backup file size exceeds the available free space.
• Free up some space in the product installation directory and MSSQL Installation directory and try again.
2. User Logon Account does not have Write permission for the backup folder
• Provide the User Logon Account Write permission for
  - <product_installation_directory>/Patch/backupDB folder.
  - <MSSQL_SERVER_installation_directory>/MSSQL/Backup folder.
3. Database Version incompatibility.
• M365 Manager Plus supports MSSQL 2008 and above. Please migrate to a compatible database version.
4. The database is down.
• To start your database,
• Ensure that the TCP/IP port is set to static in the SQL Server Configuration Manager.
• Ensure that the SQL Server Browser is Enabled and Running.
• Restart the MSSQL Server.

If the problem still persists please contact m365managerplus-support@manageengine.com.

If the REST API Access column shows Enable Now:

Cause

• The above prompt is shown if you have not granted all the permissions required by M365 Manager Plus while configuring the tenant.

If the REST API Access column shows Update Permissions:

Cause

• The above prompt is shown if M365 Manager Plus needs a few additional permissions for the newly added features to work.

If the REST API Access column shows Grant Admin Consent:

Cause

• The above prompt is shown if admin has not provided consent for the permissions that were provided for the applications.

Solutions

• Click Tenant Settings button on the right-side corner of the product.
• Click on the action required under the REST API Access column. You will be navigated to the Microsoft 365 login page.
• Login as Global Admin and proceed to provide consent.

Note: Follow the steps in this document to grant the required permissions for REST API access.

Cause

• The above error will be shown if M365 Manager Plus needs a few additional permissions for the newly added features to work.

Solution

• Follow the steps in this document to grant the required permissions for REST API access.

Cause

• One of the above errors will be shown if the service account creation could not be completed.

Solution

• Follow the steps below to resolve this issue.
• Create an Microsoft 365 service account with following roles: Exchange Admin, Global Reader, Privileged Authentication Admin, Privileged Role Admin, Teams Service Admin, and User Admin.
• In M365 Manager Plus, click on the Configure option under the Service Account column.
• Provide the credentials of the service account you had created.
• Click on Update.

Cause

• The above error will be shown if the service account password has expired.

Solution

• Reset the service account password from its user profile in the Microsoft 365 admin center, and update the new password for the service account in the configured tenant.

Cause

• The above error will be shown if the Application Secret Key is invalid or has expired.

Solution

• Update the Secret Key in the product's Tenant Settings.
• Check this document to know how to get your Azure AD Application Secret Key.

1. To test the connectivity of your Microsoft 365 environment using PowerShell, follow the steps listed here.

1. Make sure that the report corresponding to the graph can be generated without any issue for the specified number of days.

2. If the report cannot be generated, follow the troubeshooting tips listed based on the cause of error.

3. If the report can be generated but the graph in the dashboard does not mirror the values, contact m365managerplus-support@manageengine.com .

1. Make sure that you have entered the correct user name and password.

2. Check if the user account is blocked. To check if an account is blocked, follow the steps listed here.

3. Check if the required roles are assigned to the service account. Click here to view the list of required roles.

4. Run the Office365Troubleshoot.ps1 script file

• Open PowerShell as the administrator.
• Run the command Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force -Scope process.
• Run the below script:
  <install-dir>/bin/Office365Troubleshoot.ps1

Note: <install-dir> here refers to the directory in which you have installed the M365 Manager Plus application.

• Enter the username and password of the configured Microsoft 365 account.
• If Exchange session returns a value Error Occurred, the problem is with the configured account.
  • If the problem occurs when you try to configure an Microsoft 365 tenant, try using a dedicated service account to configure M365 Manager Plus by following the steps listed here.
  • If the problem occurs at any other stage, please contact m365managerplus-support@manageengine.com with a screenshot of the error.

1. Make sure that you have entered the correct user name and password.

2. Run the Office365Troubleshoot.ps1 script file

• Open PowerShell as the administrator.
• Run the command Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force -Scope process.
• Run the below script:
  <install-dir>/bin/Office365Troubleshoot.ps1

Note: <install-dir> here refers to the directory in which you have installed the M365 Manager Plus application.

• Enter the username and password of the configured Microsoft 365 account.

1. Please check if you can log in to the Microsoft 365 portal with the user account.

2. Reset the account password and try again.

1. Please check if you can log in to the Microsoft 365 portal with the user tenant.

2. Check if the user account is blocked. To check if an tenant is blocked, follow the steps listed here.

1. The error occurs when a PSSession can not be opened successfully.

2. Run the Office365Troubleshoot.ps1 script file

• Open PowerShell as the administrator.
• Run the command Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force -Scope process.
• Run the below script:
  <install-dir>/bin/Office365Troubleshoot.ps1

Note: <install-dir> here refers to the directory in which you have installed the M365 Manager Plus application.

• Enter the username and password of the configured Microsoft 365 account.
• If Exchange session returns a value Error Occurred, the problem is with the configured account.
  • If the problem occurs when you try to configure an Microsoft 365 tenant, try using a dedicated service account to configure M365 Manager Plus by following the steps listed here.
  • If the problem occurs at any other stage, the error may be temporary and try again after some time. If the issue persists, please contact m365managerplus-support@manageengine.com .

1. Run the Office365Troubleshoot.ps1 script file

• Open PowerShell as the administrator.
• Run the command Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force -Scope process.
• Run the below script:
  <install-dir>/bin/Office365Troubleshoot.ps1

Note: <install-dir> here refers to the directory in which you have installed the M365 Manager Plus application.

• Enter the username and password of the configured Microsoft 365 account.
• If Exchange session returns a value Error Occurred, the problem is with the configured account.
  • If the problem occurs when you try to configure an Microsoft 365 tenant, try using a dedicated service account to configure M365 Manager Plus by following the steps listed here.
  • If the problem occurs at any other stage, please contact m365managerplus-support@manageengine.com with a screenshot of the error.

1. Make sure that you have entered the correct user name and password.

2. MicrosoftTeams module does not support App Password. If the Service Account is MFA-enabled, please provide the account password.

3. The Microsoft 365 authentication system may be not functioning properly. Please try again after some time.

1. MSOnline module might have some compatibility issues.
   • To check your module version run the below script:
     (Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\ Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
   • If the version is higher than the suggested version, uninstall the module and install the compatible module using the below command
     1. Open PowerShell as Administrator.
     2. Install the MSOnline module with the below command:
        • Install-Module -Name MSOnline -RequiredVersion 1.1.183.81 -Force
   • If the version matches, try reinstalling the module.
2. Microsoft Online Services Sign-in Assistant may not be ready yet. To restart the service:
   • Type services.msc in Run and hit enter.
   • Find Microsoft Online Services Sign-in Assistant, right click and select restart.
3. This error may arise due to credentials without proper permission when the product is installed as a service. To resolve this, try using Domain User account as a Service Logon account. To do this:
   • Type services.msc in Run and hit enter.
   • Right click ManageEngine M365 Manager Plus and select Properties.
   • Select Log On tab.
   • Select This Account and type the valid credentials.
   • Click OK.
4. Your tenant might not be available in default Azure environment :

   • Click Tenant Settings option found at the top right corner.

   • Choose the correct Azure cloud environment from Azure Environment drop-down.

5. If the problem still persists, run the Office365Troubleshoot.ps1 script file a
   • Open PowerShell as the administrator
   • Run the command Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force -Scope process.
Run the below script: <installdir>/bin/Office365Troubleshoot.ps1

Note: <install-dir> here refers to the directory in which you have installed the M365 Manager Plus application.

• Enter the username and password of the configured Microsoft 365 account.
• Contact m365managerplus-support@manageengine.com with the screenshot of the error message you get.

The following reports require Unified Audit Log to be enabled:

To generate audit reports for all operations, follow the steps listed below.

• Open PowerShell as the administrator.
• Run the command Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force -Scope process.
• Run the below script:
  <install-dir>/bin/Office365Troubleshoot.ps1

Note: <install-dir> here refers to the directory in which you have installed the M365 Manager Plus application.

• Enter the username and password of the configured Microsoft 365 account.
• If Exchange session returns a value Error Occurred, please contact m365managerplus-support@manageengine.com to resolve this issue.
• If the Exchange session returns a success value, follow the steps listed below:
• Run the script provided below to enable auditing for the connected Microsoft 365 tenant.
  Set-AdminAuditLogConfig -UnifiedAuditLogIngestionEnabled $true
• Proceed with enabling auditing for the individual mailboxes.
• Enabling complete auditing for all mailboxes
• Enabling complete auditing for particular mailboxes
• Enabling auditing for select operations for all mailboxes

To enable complete auditing for all mailboxes

Get-Mailbox -ResultSize unlimited |Set-Mailbox -AuditEnabled $true -AuditOwner Create,HardDelete,MailboxLogin,Move,MoveToDeletedItems,SoftDelete,Update -AuditAdmin Copy,Create,FolderBind,HardDelete,MessageBind,Move,MoveToDeletedItems, SendAs,SendOnBehalf,SoftDelete,Update -AuditDelegate Create, FolderBind, SendAs, SendOnBehalf, SoftDelete, HardDelete, Update, Move, MoveToDeletedItems

To enable complete auditing for particular mailboxes

Set-Mailbox -Identity abc@microsoft.com -AuditEnabled $true -AuditOwner Create,HardDelete,MailboxLogin,Move,MoveToDeletedItems,SoftDelete,Update -AuditAdmin Copy,Create,FolderBind,HardDelete,MessageBind,Move,MoveToDeletedItems, SendAs,SendOnBehalf,SoftDelete,Update -AuditDelegate Create, FolderBind, SendAs, SendOnBehalf, SoftDelete, HardDelete, Update, Move, MoveToDeletedItems

To enable auditing for select operations for all mailboxes

Get-Mailbox -ResultSize unlimited |Set-Mailbox -AuditEnabled $true -AuditOwner Create,HardDelete,MailboxLogin,Move,MoveToDeletedItems,SoftDelete,Update -AuditAdmin Copy,Create,FolderBind,HardDelete,MessageBind,Move,MoveToDeletedItems,SendAs, SendOnBehalf,SoftDelete,Update -AuditDelegate Create, FolderBind, SendAs, SendOnBehalf, SoftDelete, HardDelete, Update, Move, MoveToDeletedItems


Identify the operations that you want to be audited from the underlined section and exclude the rest from the script.

If any of the generated reports under users or mailboxes section do not contain information for certain individuals, then follow the steps listed below.

• Check if the user’s information is displayed in the All Users report or Mailbox Users report.
• If the user’s information is displayed there, the reason for the partial data in the report is that the specific user is not managed by M365 Manager Plus.

To rectify this, purchase more licenses or reassign licenses to accommodate the user by following the steps listed below:

• In M365 Manager Plus, select the Tenant Settings option found at the top right corner.
• Click Manage Licenses link at the right-corner of the window.
• Click the Total Number of Users in the Managed Users column. This will open a pop-up.
• Click icon to search for the specified user
• Select the check box against the particular user
• Click OK to save the selection.

Cause

This error occurs when:

• The product fails to fetch data from Azure AD due to insufficient REST API permissions.
• There are any internal issues in Azure AD. If the required permissions are provided, Please try again.

Solution: Update REST API permissions with the following steps.

• Go to Tenant Settings at the top-right corner of the product's home page.
• Click on Update Permissions in the Rest API Access column for the required tenant.
• You will now be redirected to Microsoft 365 login. Enter the credentials of a Global Administrator account.
• Click on Accept to grant Read Service Health permissions and to update the REST API permissions successfully.

1. This account has been blocked by the administrator.

2. Contact your administrator to login to M365 Manager Plus.

This message indicates that,

1. The data for this report is currently being generated in the background for some other report opted by you.

2. Or the data is already being generated in the background by some other user.

Note: If the data generation was successful in either of the above mentioned cases, it will be updated automatically. Hence try switching to any other report and check the required report at a later time.

• Click Tenant Settings option found at the top right corner.

• Choose the correct Azure cloud environment from Azure Environment drop-down.

Cause

• This error will be shown if the service account password entered is incorrect or has expired.
• Also, if the service account was configured earlier, using the application password.

Solution

• Create a new password in the Microsoft 365 portal and update it in the product.
• If MFA has not been enabled, reset the service account password in the Microsoft 365 portal and update the password in the product.
• If MFA has been enabled, bypass MFA for the service account. Follow the steps listed here to bypass MFA.

Cause

• This error message is shown if the application secret value entered has been deleted or expired.

Solution

• Create a new application secret value and update the same in the product's tenant settings.

Steps :

• Sign in to Azure AD portal using the credentials of a Global Administrator account.
• Select Azure Active Directory from the left pane.
• Select App registrations.
• Select All applications.
• Search for the application name which is configured in the product.
• Select Certificates & secrets.
• Select Client secrets and click New client secret.



• Enter the appropriate values and Add.



• Now, follow the Steps to modify a Microsoft 365 tenant to update the secret in product.`

Cause

• This error message is shown if the Azure AD application is deleted.

Solution

• Configure a new application in the Azure portal. Follow the steps listed here to configure your application, manually.

• Update the necessary permissions in the application.
• You can check and update the permissions by navigating to Tenant Settings > Rest API Access > Update Permissions.
• If Rest API Access is Enabled, Please follow the steps mentioned here to verify and update the recommended permissions.

Note: A newly configured application might take some time to reflect the change in permissions. Please wait for some time or refresh the tenant by clicking on Tenant Settings and click on icon under the Actions column of the tenant to be refreshed

If the issue still persists, please contact m365managerplus-support@manageengine.com.

• Unable to generate reports that use the /identity/conditionalAccess/ endpoint of data collection API as it is not supported for national clouds like Azure AD for US Government and Azure AD China.

• Unable to generate SharePoint Online reports in M365 Manager Plus as your tenant does not have a SharePoint Online license. Kindly purchase a Microsoft SharePoint Online license and try again.

• This error occurs when the /reports endpoint of Microsoft Graph API is not supported for national clouds like Azure AD for US Government. M365 Manager Plus is unable to generate certain reports that use the /reports endpoint to retrieve information from Azure AD.

Error: Identifiable user information hashed in M365 Manager Plus reports.

Solution: Due to Microsoft's privacy settings, identifiable user information may appear hashed in M365 Manager Plus reports. Follow the steps below to show identifiable user information in reports.

• Login to the Microsoft 365 admin center as a Global Administrator.
• Go to Settings > Org Settings > Services.
• Select Reports from the given list.
• Uncheck Display concealed user, group, and site names in all reports.
• Click Save.

Note: Please note that the changes will automatically reflect in the product only after the next report sync.

To perform manual sync, go to Product scheduler > DefaultRestAPISync > Run now.

Error: The cache is being updated. Please try generating the report again after a few minutes.

Cause: Frequently accessed data is updated in the cache for faster report generation. This message appears due to one of the following reasons:

• You are generating a report for the first time. In this case, the cache will be updated before report generation.
• We refresh the cache regularly to keep data updated. Your report generation interfered with the cache update.

Resolution: Wait a few minutes and try again to generate the report.

The speed of report generation is increased by using the cache memory. While generating reports, cache initialization might fail if the cache folder does not have the required permissions. Follow these steps to grant required permissions to the cache folder.

• Shutdown M365 Manager Plus.
  • If the product runs as an application: Start → All Programs → M365 Manager Plus → Stop M365 Manager Plus.
  • If the product runs as a Windows service: Start → Run →Type "services.msc" → Stop ManageEngine M365 Manager Plus.
• Go to <product_installation_directory>/bin folder.
• Open Command Prompt as an administrator.
• Run setPermissions.bat.

These steps will grant the required permissions to the cache folder in <product_installation_directory>/mmp/cache. If the issue persists, please contact m365managerplus-support@manageengine.com.

ManageEngine M365 Manager Plus uses these applications in Azure AD to fetch data for report generation and other tasks:

• Office 365 SharePoint Online
• Office 365 Management APIs
• Microsoft Graph

Apart from the above mentioned applications, users would have to create an application that needs to be configured to M365 Manager Plus.

When the administrator disables access to these applications, report generation will fail and users will face this error.

To resolve this error, Azure AD application access must be enabled for all users.

Note: Only an administrator or a user with appropriate permissions can enable access.

To enable Azure AD application access:

1. Login to Azure
2. From the left pane, choose Enterprise Applications.
3. From the Application type drop-down, choose All Applications.
4. Find and select the application required for M365 Manager Plus.
5. Select Properties from the left pane.
6. Toggle to Yes next to Enable users to sign-in?

To install the latest MSOnline module:

1. Uninstall the old MSOnline module v1.0.
• Go to Control Panel > Uninstall a program.
• Search for Windows Azure Active Directory Module for Windows PowerShell and uninstall it.
2. Now, run the following command in the Command Prompt as an administrator to install latest MSOnline module in the machine where M365 Manager Plus is installed:
• Install-Module -Name MSOnline -RequiredVersion 1.1.183.81 -Force

If basic authentication is disabled, the user will not be able to run Exchange-related activities through PowerShell scripting. In such cases, reports or management tasks will fail to execute. To turn on basic authentication in WinRM, open an elevated Command Prompt and run:

If Basic = true is not found, run the below command:

Or,in elevated PowerShell, run the below command to modify the Windows registry:

For more details, please refer to this document.

Please check your internet connection.

1. The product requires an active internet connection to interact and function as desired. Please make sure that your internet connection is active and stable.
2. To allow the product to interact with Microsoft 365, add these ports and url’s to your firewall’s allowed to connect to the internet list. Failure to do so will result in certain features not working as intended.

Enable TLS 1.2

M365 Manager Plus uses .NET framework to connect to Microsoft 365 and collect the required data. Since TLS 1.0 and TLS 1.1 have been deprecated for security reasons, Microsoft 365 fails to connect with clients that use these two versions. Deprecated TLS versions will be used only if an older .NET version is used or if the older TLS versions are manually enabled. As older .NET framework won't use the latest protocol (TLS 1.2); a manual update of the registry is required.

Execute the following PowerShell script in Run as Administrator mode in the machine in which M365 Manager Plus is installed to enforce TLS 1.2:

1. Run the Office365Troubleshoot.ps1 script file

• Open PowerShell as the administrator.
• Run the command Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force -Scope process.
• Run the below script:
  <install-dir>/bin/Office365Troubleshoot.ps1

Note: <install-dir> here refers to the directory in which you have installed the M365 Manager Plus application.

• Enter the username and password of the configured Microsoft 365 account.
• If Exchange session returns a value Error Occurred, the problem is with the configured account.
  • If the problem occurs when you try to configure an Microsoft 365 tenant, try using a dedicated service account to configure M365 Manager Plus by following the steps listed here.
  • If the problem occurs at any other stage, please contact m365managerplus-support@manageengine.com with a screenshot of the error.

• Case 1: If the certificate's validity period does not match with live (your local time zone), you might receive this error from Microsoft and you won't be able to use the certificate.
• Case 2: If the certificate has been recently uploaded in the Azure portal, you might receive this error while trying to update the same in the product. In this case, try again after a few minutes to check if the issue has been resolved.

If your certificate has expired or not registered or removed from portal, add a new one using the following steps.

1. Log in to Azure portal using the Global Administrator account credentials.
2. Select Azure Active Directory from the left pane.
3. Select App registrations.
4. Search for the application using the Client ID.
5. Click Certificates & secrets from the left pane.
6. Go to Certificates and click Upload certificate. Upload your application certificate that is a .cer file.
7. Now click Tenant Settings in M365 Manager Plus and click the icon for your respective tenant.
8. In the Modify Microsoft 365 Tenant popup, click the icon for Application Details.
9. Under Application Secret and Certificate, add the Application Security ID and upload the Application Certificate that is a .pfx file.
10. If the user has an SSL certificate, the same can be used here. Otherwise, click here for the steps to create a self-signed certificate
11. Click Update.
12. Now, follow the Steps to modify a Microsoft 365 tenant to update the certificate

Note:If the issue still persists, please contact m365managerplus-support@manageengine.com.

• This can happen if the configured service account password is invalid or the account is blocked.
• Check if MFA is enabled for the account. To bypass MFA for the account, kindly read this.
• Once the above changes are made, close the pop-ups and wait for a few minutes. If the pop-up reappears, restart the product.

• This message is shown for Inactive Users, Users’ Last Logon or one of the reports under the Azure AD Logon reports category, since they need Azure AD Premium license to gather the sign-in data.
• To resolve this, make sure your tenant has at least one Azure AD Premium license.

This indicates that a subscription within the tenant has lapsed or that the administrator for this tenant has disabled the application, preventing tokens from being issued for it.

Note: Only an administrator or a user with appropriate permissions can enable access.

To enable Exchange Online:

1. Log in to Azure AD.
2. From the left pane, choose Enterprise Applications.
3. From the Application type drop-down, choose All Applications.
4. Search for "Office 365 Exchange Online."
5. Select Properties from the left pane.
6. Toggle to Yes next to the Enable users to sign-in? toggle button.
7. Click Save.

Cause:

This error occurs when the service account used to configure a tenant in M365 Manager Plus is disabled or deleted from the tenant.

Solution:

• If the service account is disabled, please enable the service account to continue using M365 Manager Plus.
• If the service account is deleted, Follow the steps below to resolve this issue.
1. Create an Microsoft 365 service account with the following roles: Exchange Admin, Global Reader, Privileged Authentication Admin, Privileged Role Admin, Teams Service Admin, and User Admin.
2. In M365 Manager Plus, click on the Configure option under the Service Account column.
3. Provide the credentials of the service account you had created.
4. Click Update.

1. Appropriate scopes must be assigned to perform this task. Click here to know the required scopes.

2. When REST API is enabled appropriate roles are required for the Azure application to perform privileged operations like Reset password, Block/Unblock users, Change authentication information, Delete user, Restore user and Hard delete user.

   • Help Desk Administrator role should be assigned to allow technicians to update details of non-administrators and other help desk administrators.

   • Privileged Authentication Administrator or Global Administrator role should be assigned to allow technicians to update details of all users (administrators and non-administrators).

   • Appropriate role must be assigned to perform this task. Click here to know the steps to assign the same.

3. Contact your administrator.

Kindly refer the below table and take necessary actions while invalid argument error is thrown when a management task is performed.

Operation Title	Roles required	Action to be done
Microsoft 365 Group Modification	Security Group Creation and Membership role	In Exchange Admin Center, please make sure that the service account is part of Organization Management role group which has Security Group Creation and Membership role.

When a new object is created, it will take some time for it to sync to Azure AD. Any management task that is to be performed on the newly created object will fail as the object will not be found. In this case, M365 Manager Plus will schedule those tasks to be executed after one minute. If that fails, it will be scheduled to be executed five minutes later. A list of these tasks can be found by clicking the Delayed Tasks button on the top-right corner of the Management tab.

Cause:

This error occurs in the Create Bulk Guest Users task, when:

• Admins in either your organization or the invited user's organization have not configured cross-tenant access settings to allow the invitation.
• Your external user is not from the same national cloud as your tenant, you will not be able to invite them to your organization. National clouds are isolated instances of Azure with their own environment and endpoints. The national clouds include Azure Global, Azure Government, and Azure China. For example, if your Entra ID tenant is in Azure Global, you cannot invite a user whose account is in Azure China or Azure Government.

Solution:

• Refer to this link to know more on how to configure cross-tenant access settings for your tenant.
• Ensure that your external user's email address is associated with a tenant in the same national cloud as your tenant. If it's not, you can create an user account for them in your tenant.

Cause

This error occurs in automation tasks that use the entries in a CSV file to import the objects for the required task and have the Select only the appended objects option checked. This occurs when the automation task could not find any new entries in the CSV file that were not processed earlier. This could be because no new entries were added, or there might be a problem reading them from the file.

Solution

• Create a new file with the new entries that complies with the instructions for CSV files and update the Location of CSV in the automation.
• To process all objects in the CSV file, uncheck the Select only the appended objects from the file option in the automation configuration.

1. An Administrator has changed the password to your Microsoft 365 account.

2. Login to Microsoft 365 Portal and reset your password to login to ManageEngine M365 Manager Plus

1. Rest API based authentication must be enabled for MFA-enabled / Federated Help Desk Technician accounts.

2. Once enabled, users with MFA-enabled / Federated Accounts will be redirected to Microsoft 365 portal for authentication to access M365 Manager Plus.

3. Click here to enable Rest API based authentication

1. The error occurs when a PSSession can not be opened successfully.

2. Make sure that you have entered the correct user name and password.

3. If the problem still persists, contact your administrator.

1. Make sure that you have entered the correct user name and password.

2. If the problem still persists, contact your administrator.

• In the Redirect URI of the application configured for M365 Manager Plus in Azure AD, add your machine name or IP address, port number followed by the paths mentioned below. (Eg: https://testmachine:8365/webclient/GrantAccess, http://localhost:8365/AADAuthCode.do) Know more
• /webclient/VerifyUser
• /webclient/GrantAccess
• /AADAuthCode.do
• /AADAppGrantSuccess.do
• Click Add URI to add the below Redirect URIs in the subsequent rows. Please note that for users with M365 Manger Plus build 4409 or higher, Redirect URIs (b) and (c) are optional.
1. https://identitymanager.manageengine.com/api/public/v1/oauth/redirect
2. https://demo.o365managerplus.com/oauth/redirect
3. https://manageengine.com/microsoft-365-management-reporting/redirect.html
• If product is accessed from AD360 or Log360 products with reverse proxy enabled update the endpoints by providing the above mentioned paths in the Redirect URI fields. The user should include the accessing URI with the above mentioned paths, like:
• For context based reverse proxy: https://<AD360/Log360 hostname>:<reverse proxy port>/<reverse proxy context>/webclient/VerifyUser
• For port based reverse proxy : https://<AD360/Log360 hostname>:<reverse proxy port>/webclient/VerifyUser.

1. Make sure that the product is running in the standby server.

2. Ensure that firewall is disabled for the port in which the product is installed.

1. The storage space of the drive in which the product is installed is insufficient to complete the migration. When you increase the storage space and restart the product, the migration will restart automatically.

1. The storage space of the drive in which the product is installed is insufficient to complete the migration. When you increase the storage space and restart the product, the migration will restart automatically.

1. If disk space is low(<1 GB), please free up some space and restart the product

2. If disk space is high(>1 GB), please contact m365securityplus-support@manageengine.com .

App Password is required to configure MFA-enabled accounts in Tenant Settings, which is not supported by the latest MSOL version. Please contact m365managerplus-support@manageengine.com.

• Log in to Microsoft 365 portal .
• Navigate to Users --> Active Users.
• In the filters drop-down box, select Sign-in Blocked.
• Check if the user account is blocked from logging in.

• Log in to the Microsoft 365 portal .
• Navigate to Users --> Active Users --> Add a User.
• Create a new user by filling the mandatory fields display name and user name.
• In the password section, select Let me create the password and enter a password for the user account.
• Uncheck the Make this user change their password when they first sign in.
• In the product licenses section, select Create user without product license
• Click Next.
• Under the Roles option, select the Admin center access and choose the required roles. (Exchange Admin is mandatory). Click here to view the list of required roles. Click Next
• Click Save.
• Use this account to configure your Microsoft 365 tenant in M365 Manager Plus.

If the problem persists, contact m365managerplus-support@manageengine.com .

1. This problem occurs when the DNS associated with the machine running M365 Manager Plus does not contain the necessary information. You need to add the DCs manually.

This error could be due to any of the following reasons:

• The DC is down.
• The product server is not available.
• A firewall has been enabled, and port 389 is closed.
• The network is busy.

This error could be due to any of the following reasons:

• The specified username or password is invalid.
• An anonymous login (where no username and password are provided) was performed.
• The IP address of the DC is specified instead of its name.

This error message will be displayed when Elasticsearch bundled with the product has stopped unexpectedly.

This may be due to any of the following reasons:

• Insufficient disk space
• Insufficient heap memory
• Firewall ports 9300 to 9400 have been blocked

Cause 1: Insufficient disk space

It is advised to have at least 1GB of free disk space for Elasticsearch to function effectively. When the size of data stored in Elasticsearch increases, it is recommended to free up storage accordingly to ensure Elasticsearch functions as expected.

Solution:

1. Log in to M365 Manager Plus and navigate to Settings > Admin > Disk Space Alerts and click the Usage Reports tab. You can see the amount of storage consumed by Elasticsearch data in the Elasticsearch field.



2. Free up more disk space for Elasticsearch to function properly.

Cause 2: Insufficient heap memory

Elasticsearch uses a file-system cache to provide faster searches. It is recommended to have at least 30% of the server's RAM free for Elasticsearch to use. This free RAM will be used to cache Elasticsearch's indices to provide better performance.

For proper functionality, 2GB of heap memory is initially assigned to Elasticsearch. When the size of data stored in Elasticsearch increases, it is recommended to assign more heap memory accordingly. At least 1GB of heap memory for every 60GB of data stored in Elasticsearch is required.

Solution:

You can assign more heap memory to Elasticsearch (1GB for every 30GB of Elasticsearch data is recommended for better performance) if it is feasible to do so.

To configure the heap memory assigned to Elasticsearch, follow the steps below.

1. Log in to M365 Manager Plus and navigate to Settings > Admin > Disk Space Alerts and click the Usage Reports tab.
2. You can see the amount of storage consumed by Elasticsearch data in the Elasticsearch field. Use the storage size to decide how much heap memory has to be allocated to Elasticsearch.



3. Shut down M365 Manager Plus.
   • If the product runs as an application, navigate to Start > All Programs > M365 Manager Plus and click Stop M365 Manager Plus.
   • If the product runs as a Windows service, navigate to Start > Run, type services.msc, right-click M365 Manager Plus from the list of services, and click Stop.
4. Navigate to <Installation_directory>\elasticsearch\config and open the es-additional-wrapper.conf file using a text editor of your choice. The default installation directory is C:\Program Files\ManageEngine\M365 Manager Plus.



Note: Make sure you back up a copy of the es-additional-wrapper.conf file before making any changes so that you can restore it if you encounter any issues while configuring the heap memory assigned to Elasticsearch.

5. The variables wrapper.java.initmemory and wrapper.java.maxmemory need to be set to the same value. In this example, the values are set to 3072, i.e., Elasticsearch's memory is set to (3072MB/1024) = 3GB.



6. Save the changes made before closing the file.
7. Restart M365 Manager Plus for the new heap memory configuration to take effect.

Note:

• Heap memory allocated to Elasticsearch shouldn't exceed 32GB, as larger heaps can cause longer garbage collection pauses, thereby slowing down the functioning of the product.
• Make sure both the values of wrapper.java.initmemory and wrapper.java.maxmemory are the same. Otherwise, the product will not start up properly.
• In the event of OutOfMemory and LowMemory errors, the Elasticsearch heap is automatically increased by 1GB.
• Increasing the heap size is not always the solution to improve performance. Apart from heap memory, other factors like storage devices and CPU used may also cause Elasticsearch to slow down. Ensure that the system requirements are met. Also note that increasing the Elasticsearch heap size should be done with careful consideration of the available resources on your machine.

Cause 3: Firewall ports 9300 to 9400 have been blocked

To allow Elasticsearch to interact with Microsoft 365 and collect data, firewall ports 9300 to 9400 are used.

Solution:

• Allow M365 Manager Plus to use firewall ports 9300 to 9400.

If these steps did not resolve your issue, please contact the support team at m365managerplus-support@manageengine.com to get it resolved.

Cause:

This error occurs in instances where Microsoft SQL Server is configured as the product database. A transaction log that records all transactions and modifications made by each operation is maintained in the database. When the log size reaches the allotted size limit, all transactions in the database will be stopped.

Solution:

To resolve this issue, enlarge the transaction log size or optimize the log file growth by following the steps mentioned in this article.

This error occurs when the certificate used for authentication firewall or proxy is not trusted by the product's Java Runtime Environment (JRE). To rectify this condition, the certificates must be added to the JRE's trusted certificate store. To locate and import the certificate, follow these steps. To add the certificate to the trust store:

• Navigate to <product_installation_directory>/jre/bin.
• Open command prompt as an administrator.
• Run the following command:
• keytool.exe -import -trustcacerts -alias "certAlias" -file "certPath" -keystore ..\lib\security\cacerts
  • certAlias - A name of your choice.
  • certPath - Path of the certificate.
• You will be prompted for a password. The default password is changeit. Provide the password and hit Enter.
• Restart the Product.

Follow the steps below to identify the certificate to import in the keystore:

1. Note down the value of CN displayed in the error message.



2. Open Manage User Certificates tool in the screen that opens.
3. Open Run → certmgr.msc. The certificate management tool will open as shown here:



4. Navigate to Trusted Root Certification Authorities in the left-pane, and click Certificates. A list of trusted certificates will display.



5. In the list of certificates, identify the CN noted down in step 1, in the Issued By column.



6. Once identified, click on the certificate to export.
• A pop-up will open as shown here:



• Navigate to the Details tab.
• Click Copy to File. A Certificate Export Wizard will open.



• Click Next.
• Select the certificate format DER encoded binary X.509 (.CER), and click Next.
• Specify the file name and path to export (for example: D:\Trusted Root.cer), and click Next.
• Click Finish. The certificate will be exported to the specified path.

If your service account is disabled for remote PowerShell execution, enable it by running the following command in PowerShell as an administrator:

Cause

• Invalid credentials.
• Expired client secret.
• App registration was deleted.

Fix

• Check the credentials of the service account that has been configured.
• Ensure that your client secret has not expired or been deleted.
• Make sure that your app registration exists.

Cause This issue occurs when necessary API permissions were not provided for the application.

Fix

• Log in to the Azure AD portal.
• Click Azure Active Directory from the left pane.
• Choose App registrations from under the Manage section.
• Select the All applications tab.
• Click on the Azure AD application of M365 Manager Plus.
• In the API permissions page, check if admin consent has been granted for the full_access_as_app permission shown in the image below.



• If the permission doesn't exist, follow the steps below:
  • In the API permissions page, click on Add a permission and select the APIs my organization uses tab.
  • Search for Office 365 Exchange Online and select the same.

  

  • Choose Application permissions and select the full_access_as_app checkbox.

    Note: The API permission full_access_as_app uses Exchange Web Services to backup and restore mailboxes.

  • Click on the Add Permissions button.

  

  • In the Configured permissions section, click on Grant admin consent for <your_tenant_name>.
  • Click Yes in the pop-up that appears.

Solution:

If you are using a 32-bit version of M365 Manager Plus, you won't be able to back up data using the add-on. Install the 64-bit version of the product to enable backup.

Steps to install the 64-bit version of M365 Manager Plus

Note: Take a backup of the M365 Manager Plus database before installing the 64-bit version to avoid loss of data.

1. Uninstall the 32-bit version of M365 Manager Plus.
2. Download and install M365 Manager Plus using this link.
3. Start the application.