Enable users for Direct Routing

Publisher

Microsoft

URL

https://learn.microsoft.com/en-us/microsoftteams/direct-routing-enable-users

Published

2026-08-21

Updated

unknown

Accessed

2026-09-21

HTTP status

200

License

Microsoft Learn terms of use; no-redistribution; short excerpts and locators only

Source notes citing this source

• An online-managed Direct Routing number is assigned with Set-CsPhoneNumberAssignment -PhoneNumberType DirectRouting, which also enables Enterprise Voice for the user. in context
• Uploading Direct Routing numbers to Microsoft's inventory is optional, since assigning a number uploads it automatically; a PowerShell upload request supports up to 10,000 numbers. in context
• An SBC can send a Direct Routing call straight to a Teams user's voicemail, without notifying the user, by adding opaque=app:voicemail to the Request-URI. in context
• Before Direct Routing numbers are ported to another Teams PSTN option, they must be unassigned from users and released from Microsoft's number inventory with New-CsOnlineTelephoneNumberReleaseOrder. in context
• Direct Routing requires users to be in Teams Only mode so that incoming calls land in the Teams client. in context
• For online-managed numbers, Set-CsPhoneNumberAssignment with -PhoneNumberType DirectRouting assigns the number and automatically enables the user for Enterprise Voice; the Teams admin center equivalent is Users > Manage users > Account > General information with phone number type Direct Routing. in context
• Microsoft recommends, but does not require, full E.164 numbers; numbers may carry ;ext= extensions that are used to find the user when a base number matches several users, and the INVITE must then include the full number with extension. in context
• A call arriving over Direct Routing is sent straight to the Teams user's voicemail, without notifying the user, when opaque=app:voicemail is attached to the Request-URI. in context
• Before porting Direct Routing numbers to another Teams PSTN connectivity option, the numbers must be unassigned from users and then released from Microsoft's number inventory with New-CsOnlineTelephoneNumberReleaseOrder. in context
• Microsoft's order for enabling a Direct Routing user is: create the user and assign a Teams Phone license, ensure the user is homed online, configure the phone number and enable enterprise voice, configure sending calls directly to voicemail, and assign Teams Only mode. in context
• Direct Routing requires users to be in Teams Only mode so that incoming calls land in the Teams client; this is done by assigning the UpgradeToTeams instance of TeamsUpgradePolicy. in context
• After a Direct Routing user is licensed, Cloud Voicemail configuration for the user is automatic and needs no other configuration. in context
• When Direct Routing numbers are later ported to another PSTN connectivity option they must first be unassigned and then released from Microsoft's inventory with New-CsOnlineTelephoneNumberReleaseOrder before the port event. in context
• Cloud Voicemail configuration for a Direct Routing user is automatic and requires no other configuration once the licence and number are in place. in context
• Microsoft recommends, but does not require, that a Direct Routing phone number is configured as a full E.164 number with country code. in context
• Phone numbers can be configured with extensions so several users share one base number, and for the lookup to succeed the INVITE must contain the full number with the extension, for example sip:+14255388701;ext=1001. in context
• Direct Routing requires the user to be homed online, which is checked by confirming RegistrarPool has a value in the infra.lync.com domain; where OnPremLineUri is populated the number was assigned on-premises and must be cleared with Set-CsUser -LineUri $null in the Skype for Business Management Shell and synchronised before the number is configured online. in context
• A Direct Routing number is assigned with Set-CsPhoneNumberAssignment using -PhoneNumber and -PhoneNumberType DirectRouting, and that command automatically enables the user for Enterprise Voice. in context
• Uploading Direct Routing numbers into Microsoft's telephone number management inventory is optional, and assigning a number to a user automatically uploads it if it is not already there. in context
• Direct Routing numbers are uploaded in bulk with New-CsOnlineDirectRoutingTelephoneNumberUploadOrder using -FileContent, each request supports up to 10,000 telephone numbers, and the upload is asynchronous. in context
• Direct Routing requires users to be in Teams Only mode so that incoming calls land in the Teams client, which is done by assigning the UpgradeToTeams instance of TeamsUpgradePolicy. in context
• Attaching opaque=app:voicemail to the Request-URI sends a Direct Routing call straight to the user's voicemail without ringing the Teams client. in context
• Microsoft's steps to enable a user for Teams Direct Routing are: create the user in Microsoft 365 and assign a Teams Phone licence, ensure the user is homed online, configure the phone number and enable enterprise voice, configure direct-to-voicemail, and assign Teams Only mode. in context
• Microsoft offers two ways to create Direct Routing users (create in on-premises Active Directory and sync to the cloud, or create directly in the Microsoft 365 admin center), and recommends choosing only one to avoid routing issues. in context
• For users migrating from Skype for Business Server, a populated OnPremLineUri means the number was assigned on-premises and synced to Microsoft 365; it must be cleared on-premises and synced before the number can be managed online. in context
• When the number is managed online, Set-CsPhoneNumberAssignment -Identity <user> -PhoneNumber <number> -PhoneNumberType DirectRouting assigns the number and automatically enables Enterprise Voice, and the admin center equivalent is Users > Manage users > Account > Assign phone number with type Direct Routing. in context
• Direct Routing requires users to be in Teams Only mode, set by assigning the UpgradeToTeams instance of TeamsUpgradePolicy, so incoming calls land in the Teams client. in context
• Direct Routing requires the user to be homed online, which shows as a RegistrarPool value in the infra.lync.com domain in Get-CsOnlineUser output. in context
• A Direct Routing number is assigned with Set-CsPhoneNumberAssignment -PhoneNumber <number> -PhoneNumberType DirectRouting, which also enables Enterprise Voice; Microsoft recommends full E.164 format. in context
• When users share a base number with unique extensions, the INVITE to Direct Routing must carry the full number with ;ext= for the user lookup to succeed. in context
• Direct Routing requires users to be in Teams Only mode (UpgradeToTeams TeamsUpgradePolicy) so incoming calls land in the Teams client. in context
• An SBC can send a Direct Routing call straight to a user's voicemail by appending opaque=app:voicemail to the Request-URI; the user gets no call notification. in context
• A Direct Routing number is assigned to a Teams user with Set-CsPhoneNumberAssignment -PhoneNumber <number> -PhoneNumberType DirectRouting, which also enables Enterprise Voice. in context
• Direct Routing requires users to be in Teams Only mode for incoming calls to land in the Teams client. in context

Cite this source record

APA

WarmTransfer. (2026, August 21). Enable users for Direct Routing. WarmTransfer. https://warmtransfer.net/knowledge/sources/ms-learn-dr-enable-users

BibTeX

@misc{warmtransfer-ms-learn-dr-enable-users,
  title  = {Enable users for Direct Routing},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/sources/ms-learn-dr-enable-users},
  note   = {Microsoft, accessed 2026-09-21}
}