Topic Last Modified: 2013-04-17

Verifies whether the contacts for a user (or group of users) are stored in the unified contacts store.

This cmdlet was introduced in the Cumulative Updates for Lync Server 2013: February 2013.


Debug-CsUnifiedContactStore -Identity <UserIdParameter> [-ContactDataExportFileName <String>] <COMMON PARAMETERS>
Debug-CsUnifiedContactStore -PoolFqdn <Fqdn> <COMMON PARAMETERS>
COMMON PARAMETERS: [-Force <SwitchParameter>]


Example 1

The command shown in Example 1 verifies the unified contact store status for all the users who have accounts homed on the pool

Copy Code
Debug-CsUnifiedContactStore -PoolFqdn ""

Example 2

In Example 2, the unified contact store status is verified for a single user: the user with the SIP address "".

Copy Code
Debug-CsUnifiedContactStore -Identity ""

Detailed Description

The unified contact store (introduced in Lync Server 2013 enables users to access their contact list from multiple applications, including Microsoft Lync 2013, Outlook 2013, and Outlook Web App. This access is made available by storing contact information in a single location: Microsoft Exchange Server 2013.

The Debug-CsUnifiedContactStore cmdlet enables administrators to verify whether a specific user or a specific set of users (that is, all the users with accounts homed in a particular pool) have their contact lists stored in the unified contact store. If you run the Debug-CsUnifiedContactStore cmdlet against a specific user account, the cmdlet will indicate whether that user’s contacts have been moved for the unified contact store, the number of attempts that have been made to move those contacts, and the date and time when Lync Server last tried to migrate the contact list. When called against a pool, the Debug-CsUnifiedContactStore cmdlet returns data similar to this:


UcsDisabledCount: 44

UcsAllowedCount: 129

UcsMigratingCount: 11



The Debug-CsUnifiedContactStore cmdlet, and the ContactDataExportFileName parameter, can also be used to export contact information for a user to an XML file.

To return a list of all the role-based access control (RBAC) roles that this cmdlet has been assigned to (including any custom RBAC roles that you have created), run the following command from the Windows PowerShell command-line interface prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Debug-CsUnifiedContactStore"}

Lync Server Control Panel: The functions carried out by the Debug-CsUnifiedContactStore cmdlet are not available in the Lync Server Control Panel.


Parameter Required Type Description




SIP address of an individual user whose unified contact store status is being verified. (You can specify only one user per command.) For example:

-Identity ""

When specifying the SIP address, the sip: prefix is optional. This syntax will also work:

-Identity ""




Fully qualified domain name of the Registrar pool whose unified contact store status is being verified. All user accounts homed on the specified pool will be checked. For example:

-PoolFqdn ""




File path for the XML file that will contain the contacts for the specified user when those contacts exported from the unified contact store. For example:

-ContactDataExportFileName "C:\Exports\KenMyer.xml"

Note that you must include the Identity parameter and the SIP address for the user whose contacts you want to export. If that user has not been enabled for the unified contact store, the command will terminate and no contacts will be exported.




Suppresses the display of any nonfatal error message that might occur when running the command.

Input Types

None. The Debug-CsUnifiedContactStore cmdlet does not accept pipelined data.

Return Types

The Debug-CsUnifiedContactStore cmdlet returns instances of the Microsoft.Rtc.Management.Presence.Cmdlets.GetUcsFrontEndData object.

See Also