Topic Last Modified: 2011-05-02

You can move users to the new Microsoft Lync Server 2010 deployment by using either Lync Server Control Panel or Lync Server Management Shell. You must meet some requirements to ensure a smooth transition to Lync Server 2010. For details about prerequisites to completing the procedures in this topic, see Configure Clients for Migration.

Important:
You cannot use the Active Directory Users and Computers snap-in or the Microsoft Office Communications Server 2007 R2 administrative tools to move users from your legacy environment to Lync Server 2010.
Important:
The Move-CsLegacyUser cmdlet requires that user names are properly formed and do not have leading or trailing spaces. You cannot move a user account using the Move-CsLegacyUser cmdlet if it contains leading or trailing spaces.

When you move a user to a Lync Server 2010 pool, the data for the user is moved to the back-end database that is associated with the new pool.

Important:
This includes the active meetings created by the legacy user. For example, if a legacy user has configured a my meeting conference, that conference will still be available in the new Lync Server 2010 pool, after the user has been moved. The details to access that meeting will still be the same conference URL and conference ID. The only difference is that the conference is now hosted in the Lync Server 2010 pool, and not in Office Communications Server 2007 R2 pool.
Note:
Homing users on Lync Server 2010 does not require that you deploy upgraded clients at the same time. New functionality will be available to users only when they have upgraded to the new client software.

Post Migration Task

After you move users, verify the conferencing policy that is assigned to them. To ensure that meetings organized by users homed on Lync Server 2010 work seamlessly with federated users who are homed on Office Communications Server 2007 R2, the conferencing policy assigned to the migrated users should allow anonymous participants. Conferencing policies that allow anonymous participants have Allow participants to invite anonymous users selected in Lync Server 2010 Control Panel and have AllowAnonymousParticipantsInMeetings set to True in the output from the Get-CsConferencingPolicy cmdlet in the Lync Server Management Shell. For details about configuring conferencing policy by using Lync Server Management Shell, see Set-CsConferencingPolicy in the Lync Server Management Shell documentation.

Example of Users Before Migration

The following figure shows users enabled for Office Communications Server 2007 R2 in the Office Communications Server 2007 R2 administrative tools. These users will be moved to Lync Server 2010 using the Lync Server Control Panel or Lync Server Management Shell.

Users enabled for Communications Server 2007 R2

The following figure provides a view of these same users in Lync Server Control Panel. The Registrar pool column entry for each user is set to Legacy, which indicates that these users are still homed on Office Communications Server 2007 R2 and have not been moved to Lync Server 2010.

Lync Server Control Panel Search for Users

To move users by using the Lync Server 2010 Control Panel

  1. Log on to the computer with an account that is a member of the RTCUniversalUserAdmins group or a member of the CsUserAdministrators administrative role.

  2. Open a browser window, and then enter the Admin URL to open the Lync Server Control Panel. For details about the different methods you can use to start Lync Server Control Panel, see Open Lync Server Administrative Tools.

  3. Click Users, click Add Filter, build the following query Legacy user Equal to True, and then click Find.

  4. In the search results, select a user. Here, we’ve selected Chen Yang.

    Lync Server Control Panel Move selected users

    Note:
    Notice that the Registrar pool column shows <Legacy>. This means that the user you have selected is homed on Office Communications Server 2007 R2.
  5. Click Action and then click Move selected users to pool.

    Important:
    If Move selected users to pool is not available, ensure the account is a member of the CSAdministrator or CSUserAdministrator group.
  6. In Move Users, select the Destination registrar pool, which is your Lync Server 2010 pool, and then click OK.

  7. Verify that the Registrar pool column for the user now contains the Lync Server 2010 pool, which indicates that the user has been successfully moved.

To move users by using the Lync Server Management Shell

  1. Log on to the computer with an account that is a member of the RTCUniversalUserAdmins group or a member of the CsUserAdministrators administrative role.

  2. Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2010, and then click Lync Server Management Shell.

  3. At the command line, type the following:

    Copy Code
    Move-CsLegacyUser -Identity "user name" -Target "pool_name"
    

    For example:

    Copy Code
    Move-CsLegacyUser -Identity "Kate Jordan" -Target "lync-se.contoso.net"
    

  4. At the command line, type the following:

    Copy Code
    Get-CsUser "user name" 
    

    The RegistrarPool identity in the following figure now points to the pool you specified as “pool_name” in the previous step. The presence of this identity confirms that the user has been successfully moved.

    Windows PowerShell Move Users

    Important:
    The Move-CsLegacyUser cmdlet may fail with the following error:

    Move-CsLegacyUser : SetMoveResourceData failed because the user is not provisioned. At line:1 char:18 + Move-CsLegacyUser <<<<  -Identity "jeff@contoso.net" -Target "lync-se.contoso.net" + CategoryInfo : InvalidOperation: (CN=Jeff Ander...contoso,DC=net:OCSADUser) [Move-CsLegacyUser], MoveUserException + FullyQualifiedErrorId : MoveLegacyUserError,Microsoft.Rtc.Management.AD.Cmdlets.MoveOcsLegacyUserCmdlet

    If you experience this error, see the topic Verify User Replication has Completed for resolution.

    For details about other errors that may occur when you move users and how to resolve them, see http://go.microsoft.com/fwlink/?linked=3052&kbid=2441886.