Microsoft have announced an important change to how admins will need to manage telephone numbers using the Teams Powershell module.

Microsoft plan to retire some of the cmdlets used to assign numbers to Teams users by mid April. As a result admins will no longer be able to add/remove numbers from users or resource accounts using the Set-CsUser cmdlet.

In the major update notification they have advised that the following Teams Powershell cmdlets will be fully retired:

Set-CsOnlineVoiceUser
Set-CsOnlineApplicationInstance
Set-CsOnlineVoiceApplicationInstance

These will be replaced by

Set-CsPhoneNumberAssignment, an example of this would be:

Set-CsPhoneNumberAssignment -Identity user1@contoso.com -PhoneNumber +12065551234 -PhoneNumberType CallingPlan

Remove-CsPhoneNumberAssignment, an example of this would be:

Remove-CsPhoneNumberAssignment -Identity user1@contoso.com -PhoneNumber +12065551234 -PhoneNumberType CallingPlan

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.

Phone number assignment using Teams admin centre is not impacted by this change.

These new cmdlets are already available in the latest Teams PowerShell module.

Learn more here:

Set-CsPhoneNumberAssignment
Remove-CsPhoneNumberAssignment

I hope this has been helpful and thank you for stopping by.