MC950880 - Update to Get-CsPhoneNumberAssignment

Service

Microsoft Teams

Last Updated

Jan 24, 2025

Published Dec 6, 2024

Tag

Updated message
Feature update
Admin impact

Summary

The update to Get-CsPhoneNumberAssignment cmdlet limits phone number retrieval to 1,000 numbers per query, starting January 6, 2025. Rollout begins early February and ends mid-February 2025. Exceeding this limit will result in a "Bad request." Users should adjust their requests accordingly.

More information

Updated January 24, 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 mid-February 2025 (previously late January). 

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.