Troubleshooting View-Only Configuration role assignment

When configuring the connection to on-premises Exchange server, the connection wizard checks if the provided admin account is assigned the View-Only Configuration role. If the role is missing, the Configuration step fails (Fig. 1.), as the program is not able to check whether all the necessary management roles are assigned to this account, and you get the following error:

Failed to check if role 'View-Only Configuration' is assigned to admin account.

Failed to check the roles assigned to the admin account.
Fig. 1. Failed to check the roles assigned to the admin account.

To continue with the configuration, you will be asked to provide the credentials of another account that has the View-Only Configuration role assigned (Fig. 2.). If you're not sure which users are assigned this role, you can check that manually, following this KB article. By default, an admin user who belongs to the Organization Management role group should have this role assigned. Keep in mind that this account will not be used to connect to the source or target server.

Exmigr troubleshooting View-Only Conf admin cred
Fig. 2. Providing credentials of an admin account with
the View-Only Configuration role assigned.

When you provide the correct credentials, the program will check if the admin account used for the migration is missing any other roles required for the migration process. If so, the program will attempt to assign them automatically (Fig. 3.). Click Yes to proceed.

Exmigr troubleshooting View-Only Conf assign roles
Fig. 3. Automatically assigning the missing management roles.

Info

Some of the management roles are optional if certain conditions are met. Learn more here.

If the program is unable to assign the missing roles, it means that the account provided in the Configuration step doesn't have appropriate rights to do so. To assign these roles, you will be asked to enter credentials of an admin user who is a member of the Organization Management role group (Fig. 4.). If you are certain that this user belongs to the above role group, make sure that you typed the credentials correctly.

Exmigr troubleshooting View-Only Conf admin cred2-1
Fig. 4.  Providing credentials of an account that is a member of
the Organization Management role group.

Once you provide valid UPN and password and click OK. The missing roles will be assigned, and the Configuration step will finish successfully.

Important

Note that only the credentials specified in the Admin account step are used to connect to the source or target server. Credentials provided in the Configuration step are only used once to assign the missing roles. Therefore, you will not be asked to provide the credentials of other admin users again as long as you use the same admin account for the migration process.

If you don't want the program to assign any roles automatically, you can do it manually, following the steps described in this KB article.

Problem not solved?

If you can't find the solution to your problem, try searching our Knowledge Base.

If you still need help, contact our Customer Service. We know our products inside out.

In this article

Was this information useful?