Skip to content

Commit 6796012

Browse files
Revise troubleshooting steps for email synchronization
Updated the documentation for troubleshooting email synchronization issues in Dataverse, clarifying symptoms, causes, and resolutions.
1 parent ab8e28e commit 6796012

1 file changed

Lines changed: 18 additions & 19 deletions

File tree

support/power-platform/dataverse/email-exchange-synchronization/Test-And-Enable-Fails-For-Unrecognized-EmailAddress

Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -13,41 +13,40 @@ ms.author: debrau
1313

1414
When attempting to perform Test and Enable on a mailbox in Dataverse, users may encounter the following error message:
1515

16-
>Test and Enable failed because no user was found with the email address "<[email protected]>" in the Microsoft 365 tenant associated with this mailbox's Email Server Profile. Verify the user exists in the Microsoft 365 tenant and that the email address is set as a UPN, SMTP or Mail address on the intended user. If you are connecting to mailbox in a separate Microsoft 365 tenant, verify you have configured a Cross Tenant Email Server Profile.
16+
>Test and Enable failed because no user was found with the email address "<[email protected]>" in the Microsoft 365 tenant associated with this mailbox's Email Server Profile. Verify the user exists in [...]
1717

1818
## Cause
1919

2020
This error typically occurs when:
2121

22-
- The specified email address does not exist in the Microsoft 365 tenant linked to the mailbox's Email Server Profile.
23-
- The email address is not properly configured as a User Principal Name (UPN), SMTP address, or Mail address on the user object.-
24-
- The mailbox belongs to a different Microsoft 365 tenant, and a Cross Tenant Email Server Profile has not been configured.
22+
- The specified email address does not exist in the Microsoft 365 tenant linked to the mailbox's Email Server Profile.
23+
- The email address is not properly configured as a User Principal Name (UPN), SMTP address, or Mail address on the user object.
24+
- The mailbox belongs to a different Microsoft 365 tenant, and a Cross Tenant Email Server Profile has not been configured.
2525

26-
##Resolution
26+
## Resolution
2727

28-
Step 1: Validate User Existence and Email Address Configuration
28+
**Step 1: Validate User Existence and Email Address Configuration**
2929

3030
An administrator should verify that the user exists in the correct Microsoft 365 tenant and that the email address is properly configured.
3131

3232
To validate UPN, SMTP, or Mail address:
33-
1. Sign in to the Microsoft 365 Admin Center.
34-
2. Navigate to Users > Active Users.
35-
3. Search for the user using the email address in question.
36-
4. Open the user profile and confirm the user has at least one email address matching the email address in the Dataverse mailbox record:
3733

38-
o User Principal Name (UPN) or Username matches the email address.
34+
1. Sign in to the Microsoft 365 Admin Center.
35+
2. Navigate to **Users > Active Users**.
36+
3. Search for the user using the email address in question.
37+
4. Open the user profile and confirm the user has at least one email address matching the email address in the Dataverse mailbox record:
38+
- User Principal Name (UPN) or Username matches the email address.
39+
- In the **Mail** tab, click **Edit Exchange properties**. In **Manage mailboxes**, open the mailbox. On the **General** tab, confirm the **User ID** or the **Email addresses** properties contain the email address.
40+
- **Note:** If a matching address is found in the **Email addresses**, click **Manage email address types** to confirm the address type is “SMTP”.
3941

40-
o In the Mail tab, click Edit Exchange properties. In Manage mailboxes, open the mailbox. On the General tab, confirm the User ID or the Email addresses properties contain the email address.
42+
If the user exists in the same tenant as your Dataverse instance but does not have a matching UPN, SMTP, or Mail email address, update the Dataverse mailbox record to a valid email address for the user.
4143

42-
Note: If a matching address is found in the Email addresses, click “Manage email address types” to confirm the address type is “SMTP”.
44+
If the user does not exist in the same tenant as your Dataverse instance, proceed to **Step 2**.
4345

44-
If the user exists in the same tenant as your Dataverse instance but does not have a matching UPN, SMTP, or Mail email address then update the Dataverse mailbox record to a valid email address for the user.
46+
**Step 2: Configure Cross Tenant Email Server Profile**
4547

46-
If the user does not exist in the same tenant as your Dataverse instance, proceed to Step 2.
47-
48-
Step 2: Configure Cross Tenant Email Server Profile
4948
If the mailbox resides in a different Microsoft 365 tenant, you must configure a Cross Tenant Email Server Profile.
5049

51-
Refer to the below documentation:
50+
Refer to the following documentation:
5251

53-
https://learn.microsoft.com/entra/identity/multi-tenant-organizations/cross-tenant-synchronization-configure?pivots=same-cloud-synchronization
52+
[Configure cross-tenant synchronization](https://learn.microsoft.com/entra/identity/multi-tenant-organizations/cross-tenant-synchronization-configure?pivots=same-cloud-synchronization)

0 commit comments

Comments
 (0)