Move users between on-premises and cloud

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.

In an on-premises deployment of Skype for Business Server that is enabled for hybrid, you can move users between the on-premises environment and Teams. Whether a user is located on-premises or in the cloud is known as the user’s Skype for Business home:

  • Users who are homed on premises interact with on-premises Skype for Business servers.
  • Users who are homed online may interact with the Teams service.

Teams users inherently have a Skype for Business home, whether they use Skype for Business or not. If you have on-premises Skype for Business users that are also using Teams (side by side), those users are homed on premises. Teams users with Skype for Business on premises do not have the ability to interoperate with Skype for Business users from their Teams client, nor can they communicate from Teams with users in a federated organization. Such functionality is fully available only after the user is moved from Skype for Business on-premises to online and made TeamsOnly. It’s strongly recommended that you move your users to TeamsOnly mode, which will ensure that routing of all incoming chats and calls lands in their Teams client. For more details, see Teams coexistence with Skype for Business and Migration and interoperability guidance for organizations using Teams together with Skype for Business.

Prerequisites

Prerequisites to move a user to TeamsOnly mode:

  • The organization must have Azure AD Connect properly configured and be syncing all relevant attributes for the user as described in Configure Azure AD 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, by default 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 for some reason you want to move a user to the cloud, but not use audio conferencing functionality, you can override this check by specifying the BypassAudioConferencingCheck parameter in Move-CsUser.
    • If the user is enabled for Enterprise Voice in on premises, by default the user must have a 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. If for some reason you want to move a user to the cloud but not use Phone System functionality, you can override this check by specifying the BypassEnterpriseVoiceCheckparameter in Move-CsUser.

Moving users

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

  • Teams users become enabled for interoperability with Skype for Business users, and if they are TeamsOnly they 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 migrated to online: If users are moved directly to TeamsOnly (see below), meetings are converted to Teams meetings, otherwise meetings remain Skype for Business but will be migrated so they are hosted online instead of on-premises. 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. Note that any content that was uploaded in advance of the meeting is not moved.

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:

Note

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 as well as in the Teams organization. You can either use one account that has all the necessary privileges, or you can use two accounts, in which case 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 role in Skype for Business Server.
  • In Teams, the user performing the move must meet one of the following criteria:
    • The user is a member of the Global Administrator role.

    • The user is a member of both the Teams Administrator and User Administrator roles.

    • The user is a member of both the Skype for Business Administrator and User Administrator roles.

      Important

      • 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 .onmicrosoft.com. 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 .onmicrosoft.com, or you can use any on-premises account that is synchronized into Azure AD, provided that you also specify the HostedMigrationOverrideUrl parameter in the cmdlet. The value of the hosted migration override URL is a variant of the following URL: https://adminXX.online.lync.com/HostedMigration/hostedmigrationService.svc
        In the above URL, replace the XX with either two or three characters, determined as follows:
        • In a Teams PowerShell session, run the following cmdlet:
          Get-CsTenant|ft identity
        • The resulting value will be in the following format:
          OU=<guid>,OU=OCS Tenants,DC=lyncXX001,DC=local
        • The two- or three-digit code is the XX contained in the section, DC=lyncXX001. If it’s a two-character code, it will be a digit followed by a number (such as 0a). If it’s a three-character code, it will be two letters followed by a digit (such as jp1). In all cases, you’ll see 001 immediately after the XX code.

Voice configuration requirements

If users are configured for enterprise voice in on premises, you will need to coordinate updating their voice configuration when you move them to online, or, alternatively, you could migrate them without telephony capabilities. The available options depend on whether the user will be using the Teams or Skype for Business client once they are online:

  • 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.
    • Voice users who will use the Skype for Business client after they are moved online must be configured for Skype for Business Hybrid Voice functionality.

For more details about telephony options in hybrid environments, as well as 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 are migrated to online.

See also

Move users from on-premises to Teams

Setting up the Meeting Migration Service (MMS)

Plan Direct Routing

Move-CsUser