Configure Teams Phone Mobile

Article
10/14/2022
Applies to:

Microsoft Teams

For a list of operators participating in the Microsoft Teams Phone Mobile program and the countries or regions where their service is available, see Microsoft 365 Teams Phone Mobile.

This article describes how to configure Teams Phone Mobile. Before configuring Teams Phone Mobile, be sure to read Plan for Teams Phone Mobile for information about benefits, prerequisites, and licensing.

Enable an operator

You can enable, edit, and remove operators in the Teams admin center. In the left navigation pane, go to Voice > Operators.

To enable an operator:

Choose an operator that supports Teams Phone Mobile. Under the All operators tab, filter available operators by region or service to find the right operator supporting Teams Phone Mobile. Then select the operator you want to enable.
Under Operator settings, select the countries you want to enable with your selected operator.
Provide contact information. Your contact information, including your full name and email address, will be shared automatically with your operator. You can change this information later. Additionally, you'll need to provide company size, and you'll have the option to provide your phone number. Operators will use this information to contact you with more details about Teams Phone Mobile.
Accept the data transfer notice.
Select Add as my operator to save.

Set up phone numbers

If you want to add your existing company paid SIM-enabled phone numbers to Teams, contact your operator to ensure you have the eligible Teams Phone Mobile subscription, and they can upload your numbers to Teams. After your operator completes the order, you can assign those numbers to users.

To find your operator's website, see the Microsoft 365 Teams Phone Mobile directory.

You'll need to provide your tenant ID. If you don't know your tenant ID, see Find your Microsoft 365 tenant ID. You may be porting an existing desk phone number or wireline number to a wireless voice subscription if it's supported in your region and by your operator.

How you set up phone numbers depends on whether you're setting up numbers for new users, or moving existing numbers from either Microsoft Calling Plans, Operator Connect, or Direct Routing.

Acquire numbers for new Teams users.
Move numbers from Calling Plans to Teams Phone Mobile.
Move numbers from Operator Connect to Teams Phone Mobile.
Move numbers from Direct Routing to Teams Phone Mobile.

Assign numbers to emergency addresses

The emergency address is a static location associated with a number when accessible through Microsoft Teams endpoints/clients. Once you create emergency addresses in the Teams admin center, how you assign the addresses, or change them later, will depend on your operator.

To assign numbers to emergency addresses being used by Microsoft Teams endpoints, your operator will implement one of three scenarios:

The operator assigns emergency addresses to the phone numbers and allows you to change them later in the Teams admin center.
The operator doesn't assign addresses and allows you to assign emergency addresses to the phone numbers in the Teams admin center.
The operator assigns emergency addresses to the phone numbers, and doesn't allow you to change them. In this scenario, you'll need to contact your operator to make changes to phone numbers and their assigned emergency address.

When calls are made through the native dialer of the SIM-enabled smartphone, your operator may use the geographic coordinates or cell tower handling the call to approximate emergency location for assistance.

For more information on emergency calling, see Manage emergency calling and Plan and configure dynamic emergency calling.

Acquire numbers for new Teams users

To acquire numbers for new Teams users, follow these steps:

Assign a Phone System license and an Teams Phone Mobile add-on license. You can assign a Phone System license and a Teams Phone Mobile add-on license to your users from the Microsoft 365 admin center or by using PowerShell. For more information, see Assign Teams add-on licenses to users.
Users who will be assigned phone numbers acquired with Teams Phone Mobile need to be in TeamsOnly mode. If your organization is in TeamsOnly mode, then all your users are in TeamsOnly mode.

To check, in the Teams admin center, go to Teams > Teams upgrade settings. If your organization is in Islands mode, check if specific users are in TeamsOnly mode. Go to Users and select a user account. In the Account tab, under Teams upgrade, the coexistence mode should be set to TeamsOnly.
Acquire numbers. Go to your operator's website or contact them to order and acquire mobile SIM-enabled phone numbers with the Teams Phone Mobile service enabled.

After your operator completes the order, they'll upload SIM-enabled mobile numbers to your tenant. You can view the numbers and the provider in the Teams admin center by going to Voice > Phone numbers.
Assign numbers. You can assign numbers to users from the Teams admin center or by using PowerShell. For more information, see Assign numbers.

Move numbers from Calling Plans to Teams Phone Mobile

Ensure you have eligible Microsoft 365 subscriptions for Teams Phone Mobile and the Teams Phone Mobile add-on license. You need to remove the phone number to be moved for respective users.
Contact your operator to port your numbers to Teams Phone Mobile on an eligible wireless voice plan which is SIM-enabled.
After your operator completes the porting order, your operator will upload the numbers to your tenant. You can view the numbers and the provider in the Teams admin center by going to Voice > Phone numbers.
You can assign numbers to users by using the Teams admin center or by using PowerShell. For more information, see Assign numbers.

Move numbers from Operator Connect to Teams Phone Mobile

Ensure you have eligible Microsoft 365 subscriptions for Teams Phone Mobile and the Teams Phone Mobile add-on license. You need to remove the phone number to be moved for respective users. Contact your existing Operator Connect provider to remove the phone numbers from your tenant.
Contact your operator to port your numbers to Teams Phone Mobile on an eligible wireless voice plan which is SIM-enabled.
After your operator completes the porting order, your operator will upload the numbers to your tenant. You can view the numbers and the provider in the Teams admin center by going to Voice > Phone numbers.
You can assign numbers to users by using the Teams admin center or by using PowerShell. For more information, see Assign numbers.

Move numbers from Direct Routing to Teams Phone Mobile

To move numbers from Direct Routing to Teams Phone Mobile, you'll need to complete the following steps:

Determine if the existing Direct Routing numbers are assigned online or on-premises.
Migrate the numbers from Direct Routing to Teams Phone Mobile.
Remove the online voice routing policy associated with your user.
Acquire phone numbers.
Assign phone numbers.

These steps are described in greater detail in the following sections.

Determine if the existing Direct Routing numbers are assigned online or on-premises.

How you remove your existing Direct Routing numbers depends on whether the number is assigned on-premises or online.

First, check that the user is assigned a Direct Routing number by running the following Teams PowerShell command. NumberType should be DirectRouting:
```
Get-CsPhoneNumberAssignment -AssignedPstnTargetId <user> 
```
Determine if the number is assigned online or on-premises by running the following Teams PowerShell command:
```
Get-CsOnlineUser -Identity <user> | fl RegistrarPool, OnPremLineURI, LineURI 
```
If OnPremLineUri is populated with an E.164 phone number, the phone number was assigned on-premises and synchronized to Microsoft 365.

Migrate the numbers from Direct Routing to Teams Phone Mobile

To migrate numbers, follow the steps below.

Important

During migration, the phone number will be out of service. Coordinate with your Teams Phone Mobile operator before you begin the migration.

To migrate existing Direct Routing numbers assigned online to Teams Phone Mobile, contact your operator. To find your operator's website, see Microsoft 365 Teams Phone Mobile directory. On the agreed date and time, your operator will migrate your numbers from Direct Routing to Teams Phone Mobile. This may involve removing the phone number being migrated from your tenant and add it again as a new phone number associated with Teams Phone Mobile.
To migrate Direct Routing numbers assigned on-premises to Teams Phone Mobile, run the following Skype for Business Server PowerShell command:
```
Set-CsUser -Identity <user> -LineURI $null 
```
To check if the on-premises number was removed and the changes have been synced from on-premises to Microsoft 365, run the following Teams PowerShell command:
```
Get-CsOnlineUser -Identity <user> | fl RegistrarPool, OnPremLineURI, LineURI 
```

After the changes have synced to Microsoft 365 online directory, the expected output is:

ConsoleCopy
RegistrarPool                        : pool.infra.lync.com
OnPremLineURI                        : 
LineURI

To check if the phone number was removed, run the following Teams PowerShell command:

Get-CsOnlineUser -Identity <user> | fl LineUri

Note

The amount of time it takes for the removal to take effect depends on your configuration. Removing the phone number may take up to 10 minutes, in rare cases, it can take up to 24 hours.

Remove the online voice routing policy associated with your user

After the number is unassigned, remove the online voice routing policy associated with your user by running the following Teams PowerShell command:

Grant-CsOnlineVoiceRoutingPolicy -Identity <user> -PolicyName $Null

Acquire phone numbers

Contact your operator to port your numbers to Teams Phone Mobile on an eligible wireless voice plan which is SIM-enabled.

After your operator completes the order, they'll upload numbers to your tenant. You can view the numbers and the provider in the Teams admin center by going to Voice > Phone numbers.

Assign phone numbers

You can assign Teams Phone Mobile numbers to users by using the Teams admin center or by using PowerShell. For more information, see Assign numbers.

Manage your operators

From the My operators tab, you can view your operators and their status, and make the following changes to your selections:

Manage operator services by country
Suspend an operator
Remove an operator

Note

Before removing an operator from your organization or from a country, you must remove all phone numbers assigned to users in the organization or country and contact the operator to release the numbers.

Release numbers

To release phone numbers from the Teams admin center, go to the Phone numbers page and select a number.

If the phone number isn't assigned to a user, select Release.
If the phone number is assigned to a user, you'll need to unassign the number. Select Edit, then Remove user. After you save your changes, select Release.

Manage user incoming calling policies

You can manage a user's incoming calling policies by using the Teams admin center or by using PowerShell. By default, incoming calls for Teams Phone Mobile users will ring the Teams app first on the user's SIM-enabled mobile device.

If a user's incoming calling preference is set to the Teams app, all incoming calls will ring the Teams app on the SIM-enabled smartphone and any other Teams endpoints on other devices simultaneously.
If a user's incoming calling preference is set to the native dialer, all incoming calls ring the native dialer on the SIM-enabled smartphone and simultaneously rings all other Teams endpoints on other devices.

Use the Teams admin center

To manage a user's incoming calling policies by using the Teams admin center:

Under the voice tab, select Mobility Policies.
To add a new mobile policy, click Add.
Select a name, add a description of the policy, and choose one of the following from the Select a mobile dialer dropdown option:
- Microsoft Teams to ring the Teams app on the SIM-enabled smartphone first.
- Native Dialer to ring the Native Dialer on the SIM-enabled smartphone first.
Assign the policies to users. See Assign policies.

Use PowerShell

Connect to your tenant: Connect-MicrosoftTeams.
Create policies for incoming calls to ring either the Native dialer or the Teams app first. (You can choose the policy name; this example uses TeamsFirst and NativeFirst.)
```
New-CsTeamsMobilityPolicy -identity TeamsFirst -MobileDialerPreference Teams 
New-CsTeamsMobilityPolicy -identity NativeFirst -MobileDialerPreference Native 
```

Grant policies to users:

Grant-CsTeamsMobilityPolicy NativeFirst -Identity user@xyz.onmicrosoft.com
Grant-CsTeamsMobilityPolicy TeamsFirst -Identity user@xyz.onmicrosoft.com

Check user policies:

get-CsUserpolicyassignment -identity user@xyz.onmicrosoft.com

Check all mobility policy options:
```
Get-CsTeamsMobilityPolicy
```