Move users between on-premises and cloud


Skype for Business Online operated by 21Vianet in China will be retired on October 1, 2023. If you haven't upgraded your Skype for Business Online users yet, 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.

Skype for Business Online, excluding the service operated by 21Vianet in China, was retired on July 31, 2021.

In an on-premises deployment of Skype for Business Server, users of Skype for Business may also use Teams, but not all Teams functionality is available to such users as long as they're configured to use the on-premises Skype for Business Server deployment. These users are said to be "homed" on-premises, and certain Teams functionality isn't available while these users are homed on-premises, for example:

  • Federated calling and chats via the user's Teams client with users in other organizations isn't available
  • Interop communication via the user's Teams client with other users in the organization who use Skype for Business client.
  • PSTN calling functionality (if the user is assigned a Phone System license).

To gain full Teams functionality, these users must be moved from Skype for Business on-premises to the cloud, at which point the user becomes TeamsOnly. The act of moving a user from on-premises to the cloud, sets the user's coexistence mode to TeamsOnly. Once users are moved to the cloud, they are TeamsOnly, which means all incoming chats and calls lands in their Teams client. For more information, see Teams coexistence with Skype for Business and Migration and interoperability guidance for organizations using Teams together with Skype for Business.

To move users from the on-premises Skype for Business Server deployment to the cloud requires the configuration of Skype for Business hybrid. Once the deployment is enabled for hybrid, you can move users from the on-premises environment to the cloud to make them TeamsOnly as described below. If necessary, you can also move TeamsOnly users back to the on-premises Skype for Business deployment.


Prerequisites to move a user to TeamsOnly mode:

  • The organization must have Microsoft Entra Connect properly configured and be syncing all relevant attributes for the user as described in Configure Microsoft Entra Connect.
  • Skype for Business hybrid must be configured, as described in Configure Skype for Business hybrid.
  • The user must be assigned a license for Teams and Skype for Business Online (Plan 2). Even after retirement of Skype for Business Online, the Skype for Business Online license is still required. In addition:
    • If the user is enabled for dial-in conferencing in on premises, the user must also have an Audio Conferencing license assigned in Teams before you move the user online. Once migrated to the cloud, the user will be provisioned for audio conferencing in the cloud.
    • If the user is enabled for Enterprise Voice in on premises, the user must have a Microsoft Teams Phone System license assigned in Teams before you move the user online. Once migrated to the cloud, the user will be provisioned for Phone System in the cloud.

As of July 31, 2022, to move users between an on-premises deployment and the cloud, you must be using the following minimum version of either Skype for Business Server or Lync Server:

On-premises product Required minimum version Required minimum build
Skype for Business Server 2019 CU6 7.0.2046.385
Skype for Business Server 2015 CU12 6.0.9319.619
Lync Server 2013 CU10 with Hotfix 7 5.0.8308.1182

Moving users

When a user is moved from on-premises to the cloud:

  • The user becomes a TeamsOnly user, which means the user:

    • Receives and initiates all chats and calls in the Teams client.
    • Schedules all meetings in Teams.
    • Can't initiate chats or calls, or schedule meetings in Skype for Business.
    • Can join Skype for Business meetings they already have or receive in the future. However, after Microsoft removes the Skype for Business Online infrastructure for a given TeamsOnly user, TeamsOnly users may only join Skype for Business meetings anonymously. Beginning October 2022, users moved from on-premises to Teams Only in hybrid organizations will no longer be provisioned with the Skype for Business Online infrastructure. If these users are invited to a Skype for Business meeting, they would need to join anonymously. For details, see Guidance for Organizations with on-premises deployments of Skype for Business Server.
  • Users become enabled for interoperability with Skype for Business users, and can also federate with other organizations.

  • Contacts from on premises are moved to Teams.

  • Existing meetings they organized that are scheduled in the future are converted to Teams meetings. Migration of meetings happens asynchronously and begins approximately 90 minutes after moving the user. To determine status of meeting migration, you can use Get-csMeetingMigrationStatus. Any content that was uploaded in advance of the meeting isn't moved.

  • Users who are assigned a Teams Phone license can access PSTN functionality once they are properly configured.

To move users to Teams, use either the Move-CsUser cmdlet or the Skype for Business Admin Control Panel, both of which are on-premises tools. These tools support the following move paths:


The behavior to move directly from on premises to Teams Only is automatic, regardless of which version of Skype for Business Server or Lync Server is used. It is no longer required to specify the -MoveToTeams switch in Move-CsUser to move users directly from on-premises to TeamsOnly. Previously if this switch was not specified, users transitioned from being homed in Skype for Business Server on-premises to Skype for Business Online, and their mode remained unchanged. Now when moving a user from on-premises to the cloud with Move-CsUser, users are automatically assigned TeamsOnly mode and their meetings from on-premises are automatically converted to Teams meetings, just as if the -MoveToTeams switch had been specified, regardless of whether the switch was actually specified.

Required administrative credentials

To move users between on-premises and the cloud, you must use an account with sufficient privileges in both the on-premises Skype for Business Server environment and in the Teams organization. You can either use one account that has all the necessary privileges, or you can use two accounts. If you use two accounts, you would access the on-premises tools using on-premises credentials, and then in those tools you would supply additional credentials for a Teams administrative account.

  • In the on-premises environment, the user performing the move must have the CSServerAdministrator, CsUserAdministrator, and RTCUniversalUserAdmins roles in Skype for Business Server.

  • In Teams, the user performing the move must be a member of at least one of the following roles:

    • Global Administrator role
    • Teams Administrator role
    • Skype for Business Administrator role.


    If you are using the Skype for Business Admin Control Panel, you will be prompted to provide credentials for a Microsoft 365 account with the appropriate roles, as noted above. You must supply an account that ends in If that is not possible, then use the Move-CsUser cmdlet.

    If you are using Move-CsUser in PowerShell, you can either use an account that ends in, or you can use any on-premises account that is synchronized into Microsoft Entra ID.

Voice configuration requirements

If users are configured for enterprise voice in on premises, you need to coordinate updating their voice configuration when you move them to online. Alternatively, you could migrate them without telephony capabilities.

  • You can update a user’s telephony provider to use a Microsoft Calling Plan. This is an option whether users will use Teams or Skype for Business clients.
  • You can continue to use your on-premises PSTN provider:
    • Voice users who will use Teams must be configured for Direct Routing. Direct Routing is only available after the user is moved from on premises to online.

For more information about telephony options in hybrid environments, including a supportability matrix, see User accounts in a hybrid environment with PSTN connectivity.

Other considerations

The policies (such as to control messaging, meeting, and calling behavior) in on-premises and online environments are independent. You may want to consider configuring any policies in the environment and assigning them to the user before you move that user from on premises to the cloud, so that they have the correct configuration as soon as they're migrated to online.

See also

Move users from on-premises to Teams

Setting up the Meeting Migration Service (MMS)

Plan Direct Routing