Name User Profile Property Mapping Blank After Reprovisioning

The Name property in the User Profile Service Application (also known as PreferredName) controls how a user’s friendly name will appear within the UPA (and by extension, SharePoint). By default, this property is mapped to a Synchronization Connection’s displayName attribute.

NameProperty

Changing the Name property from the displayName attribute to another attribute will cause the Name property’s mapping to disappear on a restart of the User Profile Synchronization Service (for example, during reprovisioning after a full farm backup has taken place). If the SharePoint administrator then attempts to change the Name property mapping back to the displayName attribute, the mapping will also disappear during reprovisioning.

The reasoning for this happening is that by default, SharePoint creates the Name property with the following flow using the displayName attribute:

displayNameRulesExtension

When changing the Name property to a new attribute, the flow is changed like so (in this particular case, the displayName attribute mapping was remove, and re-added, returning back to Manage User Properties in between each edit):

displayNameDirectMapping

Note the metaverse attribute is now PreferredName. Because this is a Direct mapping, it no longer correlates to the Name property in use by the UPA. Any changes to the Name property moving forward will change this new Direct mapping, rather than the proper Extension mapping. As a result, the Name property will appear to have no mapping:

NamePropertyMissing

To resolve this issue, delete and recreate the Synchronization Connection. The default mapping will be restored and will not disappear on UPSS reprovisioning. As a result, I’d recommend not adjusting the mapping of this property.

This issue was validated in SharePoint 2013 SP1.

Trevor Seward is a Microsoft Office Apps and Services MVP who specializes in SharePoint Server administration, hybrid scenarios, and SharePoint Online. He has been working with SharePoint for 16 years from SharePoint 2003 on up, managing environments with terabytes of content for 150,000+ user organizations. Trevor is an author of Deploying SharePoint 2016 and Deploying SharePoint 2019. You can find him on Twitter and in /r/sharepoint.