Migrate hybrid application endpoints before decommissioning your on-premises environment

  • Article

Important

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.

This article describes how to move required hybrid application endpoints to the Microsoft cloud before decommissioning your on-premises Skype for Business environment. This is step 3 of the following steps to decommission your on-premises environment:

Migrate all required hybrid application endpoints from on-premises to online

Before you can move these endpoints to online, you must ensure you have updated DNS records to point to Microsoft 365 for all sip domains used by the endpoints. After you update DNS to point to Microsoft 365, any existing hybrid application endpoints will no longer be discoverable until you complete this step. Since this step (creating online Resource Accounts) is not possible if DNS records point to on-premises you should plan to do both steps 2 and 3 in the same maintenance window. For more information, see Disable your hybrid configuration.

  1. Retrieve and export on-premises hybrid application endpoint settings by executing the following on-premises Skype for Business Server PowerShell command:

    Get-CsHybridApplicationEndpoint|select Sipaddress, DisplayName, ApplicationID, LineUri |Export-Csv -Path "c:\backup\HybridEndpoints.csv"

  2. Create and license new Resource Accounts in Microsoft 365 to replace the existing on-premises hybrid application endpoints.

  3. Associate the new Resource Accounts with the existing hybrid application endpoints.

  4. Remove phone numbers defined in the on-premises hybrid application endpoints by executing the following on-premises Skype for Business Server PowerShell command:

    Get-CsHybridApplicationEndpoint -Filter {LineURI -ne $null} | Set-CsHybridApplicationEndpoint -LineURI ""

  5. Because it's possible that phone numbers for these accounts were managed in Microsoft 365 instead of on-premises, run the following command in Teams PowerShell:

    $endpoints = import-csv "c:\backup\HybridEndpoints.csv"
foreach ($endpoint in $endpoints)
{
if($endpoint.LineUri)
    {
        $upn = $endpoint.SipAddress.Replace("sip:","")
        $ra=Get-CsOnlineApplicationInstance | where UserPrincipalName -eq $upn 
        Set-CsOnlineApplicationInstance -Identity $ra.Objectid -OnpremPhoneNumber ""
    }
}

  6. Assign phone numbers to the new Resource Accounts created in Step 2. For more information about how to assign a phone number to a resource account, see the following article: Assign a service number.

  7. Delete the on-premises endpoints by executing the following on-premises Skype for Business Server PowerShell command:

    Get-CsHybridApplicationEndpoint | Remove-CsHybridApplicationEndpoint

You are now ready to remove your on-premises Skype for Business deployment.

See also