Move users to Skype for Business Online

Skype for Business Server 2015

Topic Last Modified: 2016-03-04

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 -HostedMigrationOverrideUrl <URL>

The format of the URL specified for the HostedMigrationOverrideUrl parameter must be the URL to the pool where the Hosted Migration service is running, in the following format: Https://<Pool FQDN>/HostedMigration/hostedmigrationService.svc.

You can determine the URL to the Hosted Migration Service by viewing the URL for the Online Control Panel for your Office 365 tenant account.

To determine the Hosted Migration Service URL for your Office 365 tenant
  1. Login to your Office 365 tenant as an administrator.

  2. Open the Skype for Business admin center.

  3. With the Skype for Business admin center displayed, select and copy the URL in the address bar up to An example URL looks similar to the following:

  4. Replace webdir in the URL with admin, resulting in the following:

  5. Append the following string to the URL: /HostedMigration/hostedmigrationservice.svc.

    The resulting URL, which is the value of the HostedMigrationOverrideUrl, should look like the following:

You can move multiple users by using the Get-CsUsercmdlet 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 -HostedMigrationOverrideUrl <URL>

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 -HostedMigrationOverrideUrl <URL>

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