Move users from on-premises 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.
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.
There are two methods to move a user from on premises to Teams:
- If you are using a version earlier than Skype for Business Server 2015 CU8, the move requires two steps (which can be scripted to be done together as a single step, if desired):
- Move the user from Skype for Business Server (on premises) to Skype for Business Online.
- Once the user is homed in Skype for Business Online, assign the user TeamsUpgradePolicy with mode= TeamsOnly. To grant TeamsOnly mode, run the following cmdlet from a Skype for Business Online PowerShell window:
Grant-CsTeamsUpgradePolicy -Identity $user -PolicyName UpgradeToTeams
- If you have admin tools from Skype for Business Server 2015 CU8 or later, you can use the method above, or you can do this move in one step as described below. In addition, you can optionally provide a notification within the Skype for Business client prior to moving them to Teams Only as well as optionally have the Teams client silently downloaded by the Skype for Business client.
Move a user directly from Skype for Business on premises to Teams Only
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 move users from on premises to Teams Only mode in a single step using either the Move-CsUser cmdlet in PowerShell or the Skype for Business Server Control Panel, as described below.
Move to Teams using Move-CsUser
Move-CsUser is available from an on-premises Skype for Business Management Shell PowerShell window. The steps below and permissions required are the same as moving a user to Skype for Business Online, except that you must also specify the MoveToTeams switch and you must ensure that the user has also been granted a license for Teams (in addition to Skype for Business Online).
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 or Office 365 account with the necessary administrative role.
To move a user to Teams Only mode using Move-CsUser:
- Specify the user to move using the
- Specify the -Target parameter with the value “sipfed.online.lync.com”.
- Specify the
- If you do not have one account with sufficient permissions in both on premises and the cloud service (Microsoft 365 or Office 365), use the
-credentialparameter to supply an account with sufficient permissions in Office 365.
- If the account with permissions in Microsoft 365 or Office 365 does not end in “onmicrosoft.com”, you must specify the
-HostedMigrationOverrideUrlparameter, 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 or Office 365 credential is a separate account and supplied as input for the Get-Credential prompt.
$cred=Get-Credential $url="https://admin1a.online.lync.com/HostedMigration/hostedmigrationService.svc" Move-CsUser -Identity email@example.com -Target sipfed.online.lync.com -MoveToTeams -Credential $cred -HostedMigrationOverrideUrl $url
Move to Teams using Skype for Business Server Control Panel
- Open the Skype for Business Server Control Panel app.
- In the left navigation, choose Users.
- Use Find to locate the user(s) you would like to move to Teams.
- Select the user(s), and then, from the Action dropdown above the list, choose Move selected users to Teams.
- In the wizard, click Next.
- If prompted, sign in to Microsoft 365 or Office 365 with an account that ends in .onmicrosoft.com and has sufficient permissions.
- Click Next, and then Next one more time to move the user.
- 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 Teams Only 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
Some servers may need to reboot for this to work in Skype for Business 2015 with CU8.
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 firstname.lastname@example.org -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.