A little gem found in the July Lync Server 2013 Cumulative Update (KB2809243)

  • Article

We released the update yesterday and it is found here. Until now it has not been easy for an administrator to see if a given user had been migrated to UCS, but with the update we introduced the cmdlet Debug-CsUnifiedContactStore!

The cmdlet will show the UCS status for a given user or for all users on a pool. The user needs to be homed on a pool running the July update for the cmdlet to work, since it is using a new server based interface to get the status. An example of running the cmdlet is below:

Debug-CsUnifiedContactStore -Identity tu34@contoso.dk

UcsMigrationAttemptCount LastUcsMigrationAttempt SipUri           UcsMode

------------------------ ----------------------- ------           -------

                       2 3/20/2013 1:00:00 PM    tu34@contoso.dk Migrated

The cmdlet shows how many attempts have been made to migrate the user, when the last attempt was made, the SIP URI of the user and the UcsMode of the user. UcsMode can have the values:

  • Disabled – the UserServicesPolicy does not allow UCS
  • Allowed - the UserServicesPolicy allows UCS
  • Migrating – the user is being migrated
  • Migrated – the user has been migrated

You can also use it to see the general UCS status for all users on a given pool. An example of this is shown below:

Debug-CsUnifiedContactStore -PoolFqdn pool.contoso.dk

FrontEnd          : pool.contoso.dk

UcsDisabledCount  : 8

UcsAllowedCount   : 0

UcsMigratingCount : 0

UcsMigratedCount  : 2

FailedUserData    :

You can also use the cmdlet to export the UCS contacts for a migrated user by using –ContactDataExportFileName. The cmdlet will read the UCS contacts from Exchange 2013 and save them in the ZIP file used as parameter.

PS C:\> Debug-CsUnifiedContactStore -Identity tu34@contoso.dk –ContactDataExportFileName c:\ucs1.zip

UcsMigrationAttemptCount LastUcsMigrationAttempt SipUri           UcsMode

------------------------ ----------------------- ------           -------

                       2 3/20/2013 1:00:00 PM    tu34@contoso.dk Migrated

 

The ZIP file contains two files as shown in the picture below. The actual contacts are stored in an XML format in the file DocItemSet.xml.