Move users from on premises to Skype for Business Online

Skype for Business Server 2015

Topic Last Modified: 2018-02-12

Summary: Learn how to migrate user settings and move users to Skype for Business Online.

Before actually moving the user to Office 365, you should first confirm that the user accounts are synchronized to the cloud, and assign them a license. To do this, you use the Office 365 Admin Center.

To confirm that an on-premises user account has been synchronized with Office 365
  1. Using an tenant admin account, open the Office 365 admin center for your tenant.

  2. On the left navigation pane, click Users and then Active Users.

  3. Click Search for a User, and type the name of the user.

  4. Confirm that you see the user, and that their status is Synched with Active Directory.

    If the user is not yet synchronized, the next automatic synchronization should happen within three hours. You can also force a synchronization sooner. For more information, see Force Directory Synchronization.

To assign the license in Office 365, see Assign licenses for Office 365 for Business.

Before you start migrating users to Skype for Business Online, you should backup the user data associated with the accounts to be moved. Not all user data is moved with the user account. For information, see Backup and restoration requirements in Lync Server 2013: data.

User settings are moved with the user account. Some on-premises settings are not moved with the user account.

Before you begin to move users to Skype for Business Online, you may want to move a few pilot users to confirm that your environment is correctly configured. You can then verify that the features and services function as expected before attempting to move additional users.

To move an on-premises user to your Skype for Business Online tenant, run the following cmdlets in the Skype for Business Server Management Shell, using the administrator credentials for your Microsoft Office 365 tenant. Replace "" with the information for the user that you want to move.

Move-CsUser -Identity -Target -Credential $creds 

You can move multiple users by using the Get-CsUser cmdlet with the –Filter parameter to select the users with a specific property assigned to the user accounts, such as RegistrarPool. You can then pipe the returned users to the Move-CsUser cmdlet, as shown in the following example.

Get-CsUser -Filter {UserProperty -eq "UserPropertyValue"} | Move-CsUser -Target -Credential $creds 

You can also use the –OU parameter to retrieve all users in the specified OU, as shown in the following example.

Get-CsUser -OU "cn=hybridusers,cn=contoso.." | Move-CsUser -Target -Credentials $creds 

You can verify that the user was moved successfully in the following ways:

  • View the status of the user in the Skype for Business Online Control Panel. The visual indicator for on-premises users and online users is different.

  • Run the following cmdlet:

    Get-CsUser -Identity