MC950880 - Update to Get-CsPhoneNumberAssignment

Service

Microsoft Teams

Last Updated

Feb 20, 2025

Published Dec 6, 2024

Tag

Updated message
Feature update
Admin impact

Summary

The Get-CsPhoneNumberAssignment cmdlet page size limit will be updated to a maximum of 1,000 numbers per query. The rollout will begin in early February 2025 and complete by late February 2025. Requests exceeding this limit will result in a "Bad request" starting January 6, 2025.

More information

Updated February 20, 2025: We have updated the rollout timeline below. Thank you for your patience.

To maintain the best performance and reliability of our service, we are updating the page size limit for the phone number retrieval API (Get-CsPhoneNumberAssignment cmdlet) to a maximum of 1,000 numbers per query.

When this will happen:

General Availability (Worldwide, GCC): We will begin rolling out early February 2025 (previously mid-January) and expect to complete by late February 2025 (previously mid-February). 

How this will affect your organization:

From January 6, 2025, any request with -Top parameter exceeding 1,000 will result in a "Bad request." Please ensure that your Get-CsPhoneNumberAssignment requests do not surpass this limit. If the intended operation is to export your numbers, please use https://learn.microsoft.com/en-us/powershell/module/teams/export-csacquiredphonenumber?view=teams-ps

What you need to do to prepare:

Please ensure that your Get-CsPhoneNumberAssignment requests do not surpass this limit.