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.

  • Set-CsUser

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

  • Set-CsOnlineVoiceUser
  • Set-CsOnlineApplicationInstance
  • Set-CsOnlineVoiceApplicationInstance

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.

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

What you need to do to prepare:

Instead of using these cmdlets for phone number assignment:

  • Set-CsUser
  • Set-CsOnlineVoiceUser
  • Set-CsOnlineApplicationInstance
  • Set-CsOnlineVoiceApplicationInstance

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:

Assign a number to a user
Set-CsPhoneNumberAssignment -Identity user@contoso.com -PhoneNumber +41441234567 -PhoneNumberType DirectRouting -EnterpriseVoiceEnabled $true -HostedVoiceMail $true
Remove number from the user
Remove-CsPhoneNumberAssignment -Identity user@contoso.com -RemoveAll

  • No labels