Move users from on-premises to Teams


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.

When a user is moved from on premises to Teams Only, the user’s Skype for Business home is moved from on premises to online and the user is assigned TeamsUpgradePolicy with mode=TeamsOnly. After a user is moved from on-premises to TeamsOnly mode:

  • All incoming calls and chats from other users (whether sent from Skype for Business or Teams), will land in the user’s Teams client.
  • The user will be able to interoperate with other users who use Skype for Business (whether online or on premises).
  • The user will be able to communicate with users in federated organizations.
  • New meetings scheduled by that user are Teams meetings.
  • User can still join any Skype for Business meetings.
  • The user’s pre-existing meetings scheduled for the future will be migrated from on-premises to Teams.
  • Contacts that existed on-premises are available in Teams shortly after the user logs on for the first time.
  • Users cannot initiate calls or chats from Skype for Business, nor can they schedule new meetings in Skype for Business. If they attempt to open the Skype for Business client, they will be redirected to use Teams as shown below. If the Teams client is not installed, they will be directed to the web version of Teams using their browser.

    Message redirecting a user to Teams.

Before moving any users, be sure to review the prerequisites to move users to the cloud. Also be sure to review Migration and interoperability guidance for organizations using Teams together with Skype for Business.


Unified Contact Store should be disabled on the on-prem SfB account for the contact to be moved to Teams.


When moving a user from on-premises to the cloud with Move-CsUser, users are now automatically assigned TeamsOnly mode and their meetings from on-premises are automatically converted to Teams meetings, regardless of whether the -MoveToTeams switch is actually specified. (This includes migrations from Lync Server 2013, which never had the -MoveToTeams switch.) 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. This has recently been changed in preparation for retirement of Skype for Business Online.

Move a user directly from Skype for Business on premises to Teams Only

The on-premises admin tools in Skype for Business Server and Lync Server 2013 enable you to move users from on premises to TeamsOnly mode in a single step using either the Move-CsUser cmdlet in PowerShell or the Skype for Business Server Control Panel, as described below. It is no longer required to specify the -MoveToTeams switch and the behavior to move directly from on premises to Teams Only is now automatic, regardless of which version of Skype for Business Server or Lync Server is used.

You must have sufficient privileges in both the on-premises environment and the cloud service (Microsoft 365 or Office 365), 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 with the necessary administrative role.

In addition, you must ensure the user has been granted a license for Teams (in addition to Skype for Business Online). Do not disable the Skype for Business Online license.

Move to Teams using Move-CsUser

Move-CsUser is available from an on-premises Skype for Business Server Management Shell PowerShell window or from a Lync Server Management Shell PowerShell window. To move a user to TeamsOnly mode using Move-CsUser:

  • Specify the user to move using the Identity parameter.
  • Specify the -Target parameter with the value “”.
  • If you do not have one account with sufficient permissions in both on premises and the cloud service (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 “”, 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 TeamsOnly, and assumes the Microsoft 365 credential is a separate account and supplied as input for the Get-Credential prompt. The behavior is the same whether -MoveToTeams switch is specified or not.

Move-CsUser -Identity -Target -Credential $cred -HostedMigrationOverrideUrl $url


As there are different circumstances requiring different parameters, the default command for most cases is:

Move-CsUser -Identity -Target -UseOAuth -HostedMigrationOverrideUrl $url

Move to Teams using Skype for Business Server Control Panel

  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 Teams.
  4. Select the user(s), and then, from the Action dropdown above the list, choose Move selected users to Teams or Move selected users to Skype for Business Online. Either option now moves users directly to TeamsOnly.
  5. In the wizard, click Next.
  6. If prompted, sign in to Microsoft 365 with an account that ends in 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.

Notify your Skype for Business on-premises users of the upcoming move to Teams

The on-premises admin tools in Skype for Business Server 2015 with CU8, as well as in Skype for Business Server 2019, enable you to notify on-premises Skype for Business users of their upcoming move to Teams. When you enable these notifications, users will see a notification in their Skype for Business client (Win32, Mac, web, and mobile) as shown below. If users click the Try it button, the Teams client will be launched if it is installed; otherwise, users will be navigated to the web version of Teams in their browser. By default, when notifications are enabled, Win32 Skype for Business clients silently download the Teams client so that the rich client is available prior to moving the user to TeamsOnly mode; however, you can also disable this behavior. Notifications are configured using the on-premises version of TeamsUpgradePolicy, and silent download for Win32 clients is controlled via the on-premises TeamsUpgradeConfiguration cmdlet.


Some servers may need to reboot for this to work in Skype for Business 2015 with CU8.

Notification of upcoming move to Teams.

To notify on-premises users that they will soon be upgraded to Teams, create a new instance of TeamsUpgradePolicy with NotifySfBUsers=true. Then assign that policy to the users who you want to notify, either by assigning the policy directly to the user or by setting the policy at the site, pool, or global level. The following cmdlets create and grant a user-level policy:

New-CsTeamsUpgradePolicy -Identity EnableNotifications -NotifySfbUser $true
Grant-CsTeamsUpgradePolicy -Identity -PolicyName EnableNotifications

Automatic download of Teams via the Skype for Business Win32 client is controlled via the on-premises TeamsUpgradeConfiguration cmdlet with the DownloadTeams parameter. You create this configuration on a global, site, and pool level. For example, the following command creates the configuration for the site Redmond1:

New-CsTeamsUpgradeConfiguration -Identity "site:redmond1"

By default, the value of DownloadTeams is True; however, it is only honored if NotifySfbUser = True for a given user.

See also



Migration and interoperability guidance for organizations using Teams together with Skype for Business

Coexistence with Skype for Business