Upcoming, we will be retiring the phone number assignment capabilities for Microsoft Teams users in multiple Teams PowerShell Module cmdlets:

When will this happen:

The retirement is planned to begin in early April and be complete by mid-April.

How this will affect your organization:

When this change is implemented, administrators will no longer be able to assign and remove phone numbers from users and resource accounts using the following cmdlets.

We will be fully retiring the following Teams PowerShell Module cmdlets:

Note: Instead, your administrators will need to use the new Teams PowerShell Module cmdlets: Set-CsPhoneNumberAssignment and Remove-CsPhoneNumberAssignment.

These cmdlets support assigning and removing phone numbers from Microsoft Calling Plan, Direct Routing and Operator Connect and can be used for phone number assignment to both users and resource accounts.

What you need to do to prepare:

Instead of using these cmdlets for phone number assignment:

we recommend you get familiar with and start to use the new cmdlets Set-CsPhoneNumberAssignment and Remove-CsPhoneNumberAssignment. These new cmdlets are already available in the latest Teams PowerShell module.

Learn more:



The two new cmdlets need to be tested, but I guess these are the correct ones:

Set-CsPhoneNumberAssignment -Identity user@contoso.com -PhoneNumber +41441234567 -PhoneNumberType DirectRouting -EnterpriseVoiceEnabled $true -HostedVoiceMail $true


Remove-CsPhoneNumberAssignment -Identity user@contoso.com -RemoveAll