Remove your on-premises Skype for Business deployment
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 remove your on-premises Skype for Business deployment. This is step 4 of the following steps to decommission your on-premises environment:
Step 2. Disable your hybrid configuration.
Step 3. Migrate hybrid application endpoints from on-premises to online
Step 4. Remove your on-premises Skype for Business deployment. (This article)
Important
The steps in this article apply only if you are using Method 2 for managing user attributes, as described here. If you are using Method 1, do not use the steps described in this article to remove your Skype for Business servers. Instead, you can re-image the servers.
To complete the steps in this article, you need privileges for both the Schema Admins group and the Enterprise Admin group. You'll need these privileges to undo the Skype for Business Server schema and forest-level changes to Active Directory Domain Services. You'll also need to be a member of the RTCUniversalServerAdmins group.
Prepare to remove the Skype for Business deployment
After you move all required user accounts to the cloud, there may still be some remaining on-premises objects such as contacts and applications that you'll need clean-up.
Use the following steps to clean these objects, and make sure you're a member of both the Local Administrator group and the RTCUniversalServerAdmins group. ExUmContacts and PersistantChatEndPoints aren't available in Skype for Business Server 2019. If you have Skype for Business Server 2019, the corresponding cmdlets in the steps below should be omitted.
To check if there are any contacts or applications associated with the Skype for Business Server on-premises deployment, run the following Skype for Business Server PowerShell cmdlets.
Get-CsMeetingRoom Get-CsCommonAreaPhone Get-CsAnalogDevice Get-CsExUmContact Get-CsDialInConferencingAccessNumber Get-CsRgsWorkflow Get-CsTrustedApplicationEndpoint Get-CsTrustedApplication Get-CsPersistentChatEndpoint Get-CsAudioTestServiceApplication Get-CsCallParkOrbit Get-CsUnassignedNumberReview the output lists from the cmdlets in Step 1. Then if objects can be removed, run the following Skype for Business Server PowerShell cmdlets:
Get-CsMeetingRoom | Disable-CsMeetingRoom Get-CsCommonAreaPhone | Remove-CsCommonAreaPhone Get-CsAnalogDevice | Remove-CsAnalogDevice Get-CsExUmContact | Remove-CsExUmContact Get-CsDialInConferencingAccessNumber | Remove-CsDialInConferencingAccessNumber Get-CsRgsWorkflow | Remove-CsRgsWorkflow Get-CsTrustedApplicationEndpoint | Remove-CsTrustedApplicationEndpoint Get-CsTrustedApplication | Remove-CsTrustedApplication -Force Get-CsPersistentChatEndpoint | Remove-CsPersistentChatEndpoint Get-CsCallParkOrbit | Remove-CsCallParkOrbit -Force Get-CsVoiceRoute | Remove-CsVoiceRoute -Force Get-CsUnassignedNumber | Remove-CsUnassignedNumber -Force
Remove your on-premises Skype for Business deployment
After completing all the preliminary steps, you can remove the Skype for Business deployment by following these steps:
Logically remove the Skype for Business Server deployment, except for a single front end, as follows:
Update your Skype for Business Server topology to have a single front-end pool:
- In Topology Builder, download a new copy and navigate to the Frontend pool.
- Right-click the pool, and then select Edit Properties.
- In Associations, uncheck Associate Edge Pool (for media components) and select OK.
- If there's more than one Frontend Pool, then remove Associations for all remaining pools.
- Select Action > Remove Deployment.
- Select Action > Publish Topology.
After publishing the topology, complete the other steps described in the wizard.
Remove Skype for Business Server conference directories by running the following Skype for Business Server PowerShell cmdlet:
Get-CsConferenceDirectory | Remove-CsConferenceDirectory -ForceFinalize the uninstall of your Skype for Business Server deployment by running the following Skype for Business Server PowerShell cmdlet:
Publish-CsTopology -FinalizeUninstallNote
If this step returns an error, please open a Microsoft support ticket to get help removing the remaining stale objects.
Remove Central Management Store Service Control Point by running the following Skype for Business Server PowerShell cmdlet:
Remove-CsConfigurationStoreLocationUndo Skype for Business Server Active Directory domain-level changes by running the following Skype for Business Server PowerShell cmdlet:
Disable-CsAdDomainUndo Skype for Business Server Active Directory forest-level changes by running the following Skype for Business Server PowerShell cmdlet:
Disable-CsAdForest