Move users from on premises to Skype for Business Online

Important

Skype for Business Online will be retired on July 31, 2021. If you haven't upgraded your Skype for Business Online users to Microsoft Teams before that date, they will be automatically scheduled for an assisted upgrade. If you want to upgrade your organization to Teams yourself, we strongly recommend that you begin planning your upgrade path today. Remember that a successful upgrade aligns technical and user readiness, so be sure to leverage our upgrade guidance as you navigate your journey to Teams.

After you move a user from on-premises to Skype for Business Online, the user interacts with Skype for Business Online for its functionality. Any contacts that existed on-premises will be available in Skype for Business Online, and any existing meetings the user organized for the future are updated to so the links point to Skype for Business Online. If the user is enabled for Audio Conferencing, the meetings will also include dial-in coordinates. To move users from an on-premises environment to Skype for Business Online, use either the Move-CsUser cmdlet or the Skype for Business Server Control Panel, both of which are on-premises tools.

Before moving any users, be sure to review the prerequisites to move users to the cloud.

Note

In preparation for the upcoming retirement of Skype for Business Online, Microsoft has simplified how organizations move to Teams. When moving users from on-premises to the cloud, users are now automatically assigned TeamsOnly mode and their meetings from on-premises are automtically converted to Teams meetings, just as if the -MoveToTeams switch had been specified, regardless of whether the switch was actually specified. Prior to retirement of Skype for Business Online, organizations that require moving users from on-premises to Skype for Business Online can achieve this in two steps by updating the user's mode after the user is moved to TeamsOnly. However in the near future, it will no longer be possible to assign a mode other than TeamsOnly to users homed in the cloud.

Move users with Move-CsUser

Move-CsUser is available from an on-premises Skype for Business Management Shell PowerShell window. You must have sufficient privileges in both the on-premises environment as well as in the Microsoft 365 organization as described in Required administrative credentials. You can either use a single account that has privileges in both environments, or you can start an on-premises Skype for Business Server Management Shell window with on-premises credentials, and use the -Credential parameter to specify credentials for a Microsoft 365 account with the necessary administrative role.

To move a user to online using Move-CsUser:

  • Specify the user to move using the Identity parameter.
  • Specify the -Target parameter with the value “sipfed.online.lync.com”.
  • If you do not have one account with sufficient permissions in both on premises and Microsoft 365, use the -credential parameter to supply an account with sufficient permissions in Microsoft 365.
  • If the account with permissions in Microsoft 365 does not end in “.onmicrosoft.com”, then you must specify the -HostedMigrationOverrideUrl parameter, with the correct value as described in Required administrative credentials.

The following cmdlet sequence can be used to move a user to Skype for Business Online and assigns the tenant default mode to the user. It assumes the Microsoft 365 credential is a separate account and supplied as input for the Get-Credential prompt.

# From an on-premises Skype for Business Server or Lync Server 2013 management shell window, run:
 
$cred=Get-Credential
$url="https://admin1a.online.lync.com/HostedMigration/hostedmigrationService.svc"
Move-CsUser -Identity username@contoso.com -Target sipfed.online.lync.com -Credential $cred -HostedMigrationOverrideUrl $url
 
# And then from a Teams PowerShell window, remove TeamsOnly mode by running: 
Grant-CsTeamsUpgradePolicy -Identity username@contoso.com -PolicyName $null

If the administrator account is MFA (Multi-Factor Authentication) enabled, do not specify the -Credential parameter. The administrator will be prompted for credentials.

Move users with Skype for Business Server Control Panel and Teams Admin Center

  1. Open the Skype for Business Server Control Panel app.
  2. In the left navigation, choose Users.
  3. Use Find to locate the user(s) you would like to move to Skype for Business Online.
  4. Select the user(s), and then, from the Action dropdown above the list, choose Move selected users to Skype for Business Online or Move selected users to Teams. Either option will initially move the user to TeamsOnly mode but after the move you can assign another mode.
  5. In the wizard, click Next.
  6. If prompted, sign in to Microsoft 365 with an account that ends in .onmicrosoft.com and has sufficient permissions.
  7. Click Next, and then Next one more time to move the user.
  8. Note that status messages regarding success or failure are provided at the top of the main Control Panel app, not in the wizard.
  9. Open the Teams Admin Center and select "Users" in the left hand navigation.
  10. Click on the desired user in the listview.
  11. Click the Edit in the section that says Teams upgrade.
  12. In the right-hand flyout, select the desired coexistence mode and click Apply.

See also

Move-CsUser