Overview

This article covers de-provisioning users from Teams Direct Routing.deprovisioning users for Teams direct routing in the Teams Admin Center (TAC) and PowerShell. 

Deprovision Using the Teams Admin Center

These steps show you how to deprovision a single user account for Teams direct routing in the Teams Admin Center (TAC).  The TAC does not provide any feedback on a user's current direct routing status.  If you need to check the status of a user's configuration, or do any troubleshooting, you should use PowerShell. 

Sign into the Teams Admin Center (TAC):  https://admin.teams.microsoft.com 

Remove a Direct Routing Phone Number

Users > Manage Users > Click on a user's Display Name to view their settings

Next to General Information, click Edit.

Image Added

In the right-hand flyout pane, clear the assigned phone number.

Image Added

Click the Apply button at the bottom of the flyout pane.

Image Added

The user account's properties will update to show the phone number removed.

Image Added

Remove the Voice Routing & Tenant Dial Plan Policies

Select the user account's Polices tab

Image Added

Edit the Assigned Policies

Image Added

In the right-hand flyout pane, towards the bottom of the policy list, select the Global policy configuration for the following:

• Dial Plan:  Global (Org-wide default)
• Voice Routing Policy:  Global (Org-wide default)

Image Added

Click the Apply button at the bottom of the flyout pane.

Image Added

The user's policy assignments will update to show the applied changes.

Image Added

Deprovision Using PowerShell

These steps show you how to deprovision one or more user accounts from Teams direct routing using PowerShell.  Before performing these steps make sure you are connected to your Microsoft Teams services using PowerShell.  If needed, review the Teams Direct Routing - 01 - Planning and Prerequisites article for details.

Check the User's Status

The below commands can be used to view the voice properties of a user.  This can be useful for checking the status of a user before and after deprovisioning.

• Get-CsOnlineUser

# Review a list of the user's properties related to Direct Routing
Get-CsOnlineUser user@domain.com | FL Displ*, UserPri*, SipA*, EnabledIsSipEnabled, Inter*, TeamsUpgradeE*, Enterprise*, OnlineVoiceR*, TeamsCall*, TenantD*, VoiceP*, HostedVoicemail*, OnlineDial*, OnPremLineURI, LineURI

# Review all of the user's properties
Get-CsOnlineUser user@domain.com | FL *

# Export a list of all voice users and their properties to a CSV file
$CsvFilePath = "C:\Path\to\file.csv"

Get-CsOnlineUser -ResultSize Unlimited | Select Displ*, UserPri*, SipA*, EnabledIsSipEnabled, Inter*, TeamsUpgradeE*, Enterprise*, OnlineVoiceR*, TeamsCall*, TenantD*, VoiceP*, HostedVoicemail*, OnlineDial*, OnPremLineURI, LineURI | Export-Csv $CsvFilePath -nti

Here's a description of the more important properties outputted with the above Get-CsOnlineUser commands:

• Enabled IsSipEnabled - Indicates whether the user is enabled for MS Teams or Skype for Business Online.  If enabled this is showing False, then the user account is either disabled (sign-in is blocked), or it doesn't have a license that includes MS Teams or Skype for Business Onlinecannot be configured for direct routing.
• EnterpriseVoiceEnabled - Indicates whether the user has been enabled for Enterprise Voice features (aka. Teams Phone).  Enterprise voice has to be enabled for Teams Direct Routing to work.OnPremLineURI - Specifies the Evolve IP provisioned phone number assigned to the user. The phone number must be specified using the E.164 format and be prefixed with "tel:".
• LineURI - Shows the Evolve IP provisioned phone number assigned to the user based on the value of the OnPremLineURI parameter.  If this parameter has a phone number, and OnPremLineURI is blank, the user has been assigned a phone number from Microsoft.
• InterpretedUserType - This can help with troubleshooting users that are not working as expected.  Unfortunately, there's a lot of "UserTypes", and Microsoft does not have them documented.  People in the Teams community have tried creating some documentation of their own, and doing a google Google search for InterpretedUserType will turn up some results, which may help.  If not, you'll need to open a support case with Microsoft.
• TeamsUpgradeEffectiveMode - For Teams Direct Routing direct routing to work, this should show TeamsOnly.
• OnlineVoiceRoutingPolicy - If this is blank, the user is not assigned a voice routing policy.  When a user is configured for Teams Direct Routingdirect routing, this should be set to an EIP-TDR-VRP Evolve IP voice routing policy.  To view a list of voice routing policies in your tenant use the Get-CsOnlineVoiceRoutingPolicy command.
• TenantDialPlan - If this is blank, the user is assigned to the Global tenant dial plan. To view a list of dial plans in your tenant use the Get-CsTenantDialPlan command.
• TeamsCallingPolicy - If this is blank, the user is assigned to the Global calling policy. To view a list of calling policies use the Get-CsTeamsCallingPolicy command.
• TeamsCallParkPolicy - If this is blank, the user is assigned to the Global call park policy. To view a list of call park policies use the Get-CsTeamsCallParkPolicy command.
• VoicePolicy - When enabled for Direct Routing, this should show HybridVoice.  If it shows BusinessVoice, the user has been assigned a Microsoft dial plan.  If it's blank, the user has not been assigned a Teams Phone add-on license.
• HostedVoicemail - Enables a user's voice mail calls to be routed to a hosted version of Microsoft Exchange Server. It also enables Skype for Business users to directly place a call to another user's voice mail.  It is recommended to enable this for all Teams users.
• HostedVoicemailPolicy - If this shows BusinessVoice, the user's voicemail is hosted by Microsoft.  At this time Evolve IP does not plan to host voice mailboxes.  So, BusinessVoice should be the value you see.
• OnlineDialinConferencingPolicy - If this shows ServiceAllowed, the user is enabled for Microsoft's Audio Conferencing.  If this is blank, the user is not enabled for Audio Conferencing.
• OnlineDialOutPolicy - This policy defines the dial out restrictions from an audio conference.  A table of the different policies and their restrictions can be found in this Microsoft article.

The below commands can be used to view just the voice properties of one or more users.

• Get-CsOnlineVoiceUser

# View a user's voice properties 
Get-CsOnlineVoiceUser user@domain.com 

# View a list of all users
Get-CsOnlineVoiceUser | FT Name, Number, Location, PstnConnectivity, UsageLocation, EnterpriseVoiceEnabled

# View a list of all users and their Enterprise Voice status 
Get-CsOnlineVoiceUser -EnterpriseVoiceStatus All | FT Name, Number, EnterpriseVoiceEnabled

# View a list of users who have phone numbers assigned
Get-CsOnlineVoiceUser -NumberAssigned | FT Name, Number, EnterpriseVoiceEnabled

# View a list of users who don't have a number assigned
Get-CsOnlineVoiceUser -NumberNotAssigned | FT Name, Number, EnterpriseVoiceEnabled

# Export a list of all voice users and their properties to a CSV file
$CsvFilePath = "C:\Path\to\file.csv"

Get-CsOnlineVoiceUser | Export-Csv $CsvFilePath -nti

The Get-CsOnlineVoiceUser command contains the following properties:

• Name - The name of the user account.
• Id - The user account's Azure AD object ID.
• SipDomain - The user account's SIP domain.
• DataCenter - Shows where the user account is homed in Microsoft's services.
• TenantId - Shows the Azure AD tenant ID
• Number - Shows the provisioned phone number assigned to the user. 
• Location - Shows the LIS location ID associated with the user account.  Location IDs can be found using the Get-CsOnlineLisLocation command.
• PstnConnectivity - A value of OnPremises represents direct routing.
• UsageLocation - The user account's usage location set in the M365 admin center.
• EnterpriseVoiceEnabled - Indicates whether the user has been enabled for Enterprise Voice features (aka. Teams Phone).  Enterprise voice has to be enabled for Teams Direct Routing to work.

Deprovision a Single User

The following will deprovision a single user from direct routing, and disable their Enterprise Voice features.  When you're done, you can then remove the Teams Phone add-on license from the user account.  This change will not affect any Audio Conferencing features.

• Grant-CsOnlineVoiceRoutingPolicy
• Grant-CsTenantDialPlan
• SetRemove-CsUserCsPhoneNumberAssignment

Deprovision the User from Direct Routing.  Make sure you modify line 2 to include the user's UPN.

# Define the user's UPN
$UPN = "user@domain.com"

# This will deprovision the user's account for Direct Routing
# and set their account to use the global voice routing policy

Grant-CsOnlineVoiceRoutingPolicy -Identity $UPN -PolicyName $null
Grant-CsTenantDialPlan -Identity $UPN -PolicyName $null 
SetRemove-CsUserCsPhoneNumberAssignment -Identity $UPN -OnPremLineUri $null -EnterpriseVoiceEnabled $False
RemoveAll 

Deprovision All Users

The following will deprovision all users that are currently configured with Direct Routing using an Evolve IP voice routing policy, and also disables their Enterprise Voice features.  When you're done, you can remove the Teams Phone add-on license from the user accounts.  This change will not affect any Audio Conferencing features.

• Get-CsOnlineVoiceRoutingPolicyCsOnlineUser
• Get-CsOnlineUserCsOnlineVoiceRoutingPolicy
• Grant-CsOnlineVoiceRoutingPolicy
• Grant-CsTenantDialPlan
• SetRemove-CsUserCsPhoneNumberAssignment

Get all users assigned to an EIP voice routing policy.

# Search string to find the EIP voice routing policies 
$VrPolicyName = "EvolveIP"

# Get all users assigned to an Evolve IP voice routing policy
$UserData = Get-CsOnlineUser -ResultSize Unlimited | Where { $_.OnlineVoiceRoutingPolicy -like "*$($VrPolicyName)*"}

# Show a list of the users assigned to an EIP voice routing policy
$UserData | FT DisplayName, UserPrincipalName, OnlineVoiceRoutingPolicy, OnPremLineUri

# Show the number of users assigned to an EIP voice routing policy
$UserData.UserPrincipalName.Count

Deprovision the list of users, and disable their Enterprise Voice features.

# This will loop through each user
ForEach ($User in $UserData) {

  # These commands will deprovision the user's account for direct routing
  # and set their account to the global voice routing policy

  Grant-CsOnlineVoiceRoutingPolicy -Identity $User.UserPrincipalName -PolicyName $null
  Grant-CsTenantDialPlan -Identity $User.UserPrincipalName -PolicyName $null
  SetRemove-CsUserCsPhoneNumberAssignment -Identity $User.UserPrincipalName -OnPremLineUri $null -EnterpriseVoiceEnabled $False

}RemoveAll
}