Skype for Business Hybrid: Migrating from Online to On-Premises


Did you deploy Lync or Skype for Business Online before deploying Skype for Business (Lync) Server on-premises? And now you’d like to move your online user accounts to your on-premises server deployment? Here’s how!

Disclaimer: this article is a work in progress, put together from lots of very untidy notes from the field. I will improve the article as I test it in the field, and welcome any feedback and experiences.


  • Your Skype for Business users are homed in Skype for Business Online
  • You have a fully deployed and working Skype for Business Server on-premises
  • You have deployed AD Connect and are syncronising on-premises AD with Office 365 Azure AD, and are using password sync or Active Directory Federation Services (AD FS) for single sign-on
  • Your solution is being backed up – once cut over, the on-premises deployment will manage SfB Online and On-Premises sign-in requests


Management Tools

Install the following tools where you intend to run migrations from:

Office 365

Determine Office 365 Federation settings to be replicated to on-premises, keeping the following in mind:

  • Domain matching must be configured the same for your on-premises deployment and your Office 365 tenant
  • If partner discovery is enabled on the on-premises deployment, then open federation must be configured for your online tenant. If partner discovery is not enabled, then closed federation must be configured for your online tenant
  • The Blocked domains list in the on-premises deployment must exactly match the Blocked domains list for your online tenant
  • The Allowed domains list in the on-premises deployment must exactly match the Allowed domains list for your online tenant
  • Federation must be enabled for the external communications for the online tenant, which is configured by using the Skype for Business Online Control Panel




Azure AD Connect

If you installed Azure AD Connect before Skype for Business Server, chances are some of the related attributes are not configured for syncronisation. This article details the attributes that you should be syncing.

You can check attributes configured for syncronisation as follows:

  • Start the Synchronization Service Manager
  • Go to the Connectors tab and select the Connector you want to edit
  • Right click and select Properties
  • Go to the Select Attributes section:

Once added make sure you run a full sync again:


Hybrid Setup

There are two options when configuring Hybrid. In Skype for Business Server a wizard takes care of most if it for you, however there may be cases where you need to do this manually, for example if you are running Lync 2013 Server.

Option 1 – Wizard

Run the “Set up Hybrid with Skype for Business Online” wizard from the Skype for Business Control Panel:

Microsoft recommends you sign in with the admin account that was created when you signed up for Office 365, but in practice it appears any admin account will work as long as it is an domain e.g. [email protected] The reason for this is a lyncdiscover lookup to SfB Online is used when connecting – some more info here. If you have an account using your real domain, this will fail since it resolves the on-premises deployment. This user may also need to have SfB Licence, but I havent 100% confirmed this.

Once you’ve signed in, the wizard will validate your configuration and attempt to resolve any issues it finds:

Option 2 – Manual

  • Determine the Office 365 Admin URL:
    • Log into Office 365 Portal as a tenant administrator
    • Navigate to the Office 365 Admin Centre
    • Under the “Admin” category, select “Skype for Business”:
    • Check the URL presented in the address bar:
  • Determine the Office 365 Hosted Migration Service URL:
    • Using the URL found in the step above we need to construct the Migration Server URL
    • Take your URL where x is a letter specific to your tenant e.g.
    • Append the following string to the URL: /HostedMigration/hostedmigrationservice.svc.
    • The resulting URL, which is the value of the HostedMigrationOverrideUrl, should look like the following, and will be used later in PowerShell commands when migrating users –
  • Enable your tenant for Shared SIP Address Space:
  • Ensure on-premises is configured for federation
  • Recreate Federation settings (Allowed/Blocked Federated Domains) in On-premises
  • Remove default SfB Online hosting provider and recreate:


Cutting over from SfB Online to on-premises hybrid requires the that the on-premises deployment becomes authoritative. Once the redirection from on-premises to SfB Online occurs, sign-in details will be cached so the reliance on the Edge server for sign-in is not required each time the user logs in thereafter. Obviously the Edge server will be required to redirect federation requests and to communicate between on premises and SfB Online users.

  • Update external DNS records to point to your on-premises deployment (Internal records will be updated later – by initially updating only external DNS records, internal users can continue to function without interruption while hybrid mode is validated) – we will test internally later
    • Edge Server Services (SIP Access/Web Conference/ AV FQDNs) – Public A Records
    • SRV (Edge Server)
    • SRV (Edge Server)
    • External Web Services FQDN – Public A Record (reverse proxy)
    • Dialin FQDN – CNAME to Ext Web is OK (reverse proxy)
    • Meeting FQDN – CNAME to Ext Web is OK(reverse proxy)
    • LyncDiscover FQDN – CNAME to Ext Web is OK (reverse proxy)
  • Enable a test user in SfB on-premises and set the HostingProviderProxyFqdn – this step is required regardless of whether the user will remain in SfB Online or be migrated to On-Premises:
The user should now appear in the SfB Control Panel, showing as homed in Skype for Business Online:

  • Make sure the topology has replicated, in particular the Edge will need to be to-to-date
  • Synchronise AADSync/DirSync
  • Validate functionality of test user externally before moving on
  • Get a list of all users enabled for SfB Online. The following command will export this list to CSV:
  • Review CSV for deleted users (these should be removed by above command); there SIPAddress will include GUID style login, and these lines can be removed as we do not wish to migrate them
  • Using the CSV enable the remainder of your users in SfB on-premises – this step is required regardless of whether the user will remain in SfB Online or be migrated to On-Premises:
  • Use the SfB Control Panel to validate SfB Online users are visible – you should see users homed to SfBOnline as we saw earlier in the article for our test user
  • Test the process of migrating a user from SfB Online to SfB On-premises using the test account:
  • Synchronise AADSync/DirSync
  • Validate functionality of test user externally before moving on
  • Once validated we need to update Internal DNS to point all associated SfB records to on-premises:
    • SRV (FE Pool)
    • (FE Pool/Load Balancer)
    • (FE Pool)
    • DNS internal records for federation should be the same internally as externally:
      • (Access Edge) -> public IP of Access Edge
  • Validate functionality of test user internally
  • Validate another SfB Online user internally – the test user has been moved to on-premises so we want to validate a user than will remain online from the internal network now we have updated those DNS records
  • Move the SfB Online users to on-premises as required. The below example uses the same CSV output we used earlier to move ALL online users to on-premises:
  • Use the SfB Control Panel to validate SfB Online users are now homed to on-premises pool
  • To get visual status while you move all the users, log into your Office 365 Skype for Business Administration Portal and view the details. Continually refresh the page to see the value for “users synced and homed online” go down as each user becomes enabled on-premises:

To check that a user has correct values for the attributes shown in the following table, type this cmdlet:

Active Directory attribute Attribute name Correct value for Online user Correct value for on–premises users
msRTCSIP-DeploymentLocator HostingProvider SRV:
msRTCSIP-PrimaryUserAddress SIPAddress sip:[email protected] sip:[email protected]
sRTCSIP-UserEnabled Enabled True True

Post Migration

Scheduled meetings are not migrated from online to on-premises. Users will need to reschedule these meetings after being moved or use the Meeting Migration Tool.

Migrating users from on-premises to online may utilise the Meeting Migration Service.

Errors & Issues

  • Migrating a user on-premises <-> online – “Index was outside the bounds of the array when moving Online to On-prem”This is a result of not having the correct AD Attributes synced. Check the attributes are selected and a full sync has been completed since

  • Hybrid Wizard Sign-in – “Get-CsWebTicket: Failed to connect to live id servers”

Check Microsoft Online Services Sign-in Assistance is running:

Check permissions for NETWORK SERVICE are:

Read Attribute on %windir%\System32\config\systemprofile\AppData\Local

Full Control on %windir%\System32\config\systemprofile\AppData\Local\Microsoft\MSOIdentityCRL

If the permissions are not correct, resolve then recycle the LyncIntManagement IIS Application Pool to ensure it clears the MSOIDCLI state.




  1. Quick question – what if you just enabled the users on prem, rather than enable online first and then move? You would have an online account and on prem, but are there any downsides to that?


Please enter your comment!
Please enter your name here