Manage phone numbers for users

When you set up Calling Plans, Operator Connect, or Teams Phone Mobile, you assign phone numbers to your users. In Microsoft Teams, the phone number that you assign is listed when a user clicks Calls.

This article applies to Calling Plans, Operator Connect, and Teams Phone Mobile. For information about assigning, changing, or removing a phone number from a user in a Direct Routing scenario, see Enable users for Direct Routing, voice, and voicemail.

Before you assign a number for a Calling Plan, Operator Connect, or Teams Phone Mobile user, you must get numbers for your users. For more information, see Get numbers for Calling Plan users, Set up numbers for Operator Connect users, or Set up numbers for Teams Phone Mobile users.

Note

One way to see whether a user has a license assigned is by going to the Microsoft Teams admin center > Users. If a license is assigned, it will be indicated on the page. You can also use the Microsoft 365 admin center.

Note

This note applies to customers who have a hybrid deployment with an on-premises Active Directory. If you want to assign a Calling Plan or Operator Connect phone number to a user or resource account, you must ensure that any phone number stored in the msRTCSIP-Line attribute on the user or resource account object in the on-premises Active Directory has been removed, and the change has been synchronized to Microsoft 365.

Assign a phone number to a user

When assigning a phone number to a user, make sure the phone number and the usage location of the user are of the same country/region.

To assign a number by using the Teams admin center:

  1. Open the Microsoft Teams admin center and log in with a user that is a Global admin. This is usually the account you used to sign up for Microsoft 365.

  2. In the left navigation, click Voice > Phone numbers.

  3. On the Phone numbers page, select an unassigned number in the list, and then click Edit.

  4. In the Edit pane, under Assigned to, search for the user by display name or user name, and then click Assign.

  5. To assign or change the associated emergency location, under Emergency location, search for and then select the location.

    Note

    If you are assigning numbers to Operator Connect or Operator Connect Mobile users, you may or may not be able to assign or change the associated emergency location. This functionality will depend on your Operator. Contact your Operator for more information.

  6. Depending on whether you want to send an email to the user with their phone number information, turn off or turn on Email user with telephone number information. By default, this is on.

  7. Click Save.

To assign numbers by using PowerShell, use the Set-CsPhoneNumberAssignment cmdlet as follows:

For Calling Plan numbers:

Set-CsPhoneNumberAssignment -Identity <user> -PhoneNumber <phone number> -PhoneNumberType CallingPlan

For Operator Connect numbers:

Set-CsPhoneNumberAssignment -Identity <user> -PhoneNumber <phone number> -PhoneNumberType OperatorConnect

For Teams Phone Mobile numbers:

Set-CsPhoneNumberAssignment -Identity <user> -PhoneNumber <phone number> -PhoneNumberType OperatorConnect

For example:

Set-CsPhoneNumberAssignment -Identity john@contoso.com -PhoneNumber "+14255550101" -PhoneNumberType CallingPlan
Set-CsPhoneNumberAssignment -Identity jack@contoso.com -PhoneNumber "+14255550102" -PhoneNumberType OperatorConnect

Note

Because of the latency between Microsoft 365 and Teams, it can take up to 24 hours for users to be enabled. If the phone number isn't assigned correctly after 24 hours, see Phone Number Service Center.

Note

When you assign a phone number, the EnterpriseVoiceEnabled flag is automatically set to True.

Change a phone number for a user

To change a phone number for a user by using the Teams admin center:

  1. In the left navigation, click Users, locate and double-click the user you want, click Account, and then under General information, make a note of the phone number that's assigned to the user.

  2. In the left navigation, click Voice > Phone numbers.

  3. On the Phone numbers page, select the number that you identified in step 1, and then click Edit.

  4. In the Edit pane, under Assigned to, click the X to remove the user.

  5. Click Save.

  6. On the Phone numbers page, select an unassigned number in the list, and then click Edit.

  7. In the Edit pane, under Assigned to, search for the user by display name or user name, and then click Assign.

  8. To assign or change the associated emergency location, under Emergency location, search for and then select the location.

    Note

    If you are changing numbers for Operator Connect or Teams Phone Mobile users, you may or may not be able to assign or change the associated emergency location. This functionality will depend on your Operator. Contact your Operator for more information.

  9. Click Save.

For a PowerShell example, see Set-CsPhoneNumberAssignment.

Remove a phone number from a user

To remove a phone number by using the Teams admin center:

  1. In the left navigation, click Users, locate and double-click the user you want, click Account, and then under General information, make a note of the phone number that's assigned to the user.

  2. In the left navigation, click Voice > Phone numbers.

  3. On the Phone numbers page, select the number that you identified in step 2, and then click Edit.

  4. In the Edit pane, under Assigned to, click the X to remove the user.

  5. Click Save.

For a PowerShell example, see Remove-CsPhoneNumberAssignment.

Manage phone numbers for your organization

Manage the usage of a phone number

Set-CsPhoneNumberAssignment

Plan your Teams Voice solution