[devcenter] Add breaking change deprecation messages for 2025-04-01-preview API

[am-lim]

Description

Upcoming breaking changes for 2025-04-01-preview API
Control plane PR: #27998
Data plane PR: #27999

Mandatory Checklist

• Please choose the target release of Azure PowerShell. (⚠️Target release is a different concept from API readiness. Please click below links for details.)

  • General release
  • Public preview
  • Private preview
  • Engineering build
  • No need for a release

• Check this box to confirm: I have read the Submitting Changes section of CONTRIBUTING.md and reviewed the following information:

• SHOULD update ChangeLog.md file(s) appropriately
  • Update src/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.
    • A snippet outlining the change(s) made in the PR should be written under the ## Upcoming Release header in the past tense.
  • Should not change ChangeLog.md if no new release is required, such as fixing test case only.
• SHOULD regenerate markdown help files if there is cmdlet API change. Instruction
• SHOULD have proper test coverage for changes in pull request.
• SHOULD NOT adjust version of module manually in pull request

[azure-client-tools-bot-prd]

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

[YanaXu]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[YanaXu]

Hi @am-lim, please add the ChangLog.

[github-actions]

This PR was labeled "needs-revision" because it has unresolved review comments or CI failures.
Please resolve all open review comments and make sure all CI checks are green. Refer to our guide to troubleshoot common CI failures.

[am-lim]

Hi @am-lim, please add the ChangLog.

HI @YanaXu, this is updated.

[YanaXu]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[YanaXu]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[YanaXu]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[YanaXu]

Hi @am-lim, please run autorest, build-module.ps1 and submit all changes.

[Copilot]

Pull Request Overview

This PR adds breaking change annotations for the 2025-04-01-preview Data Plane API and updates module metadata and changelogs to preannounce upcoming deprecations.

• Adds OutputBreakingChangeAttribute to several DevBox cmdlets
• Introduces ParameterBreakingChangeAttribute for the LocalAdministrator parameter
• Updates AutoRest README with root module name and extensive breaking-changes rules
• Records preannouncement in the ChangeLog

Reviewed Changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/DevCenter/DevCenterData.AutoRest/custom/Stop-AzDevCenterUserDevBox.ps1	Added placeholder breaking change attribute to output
src/DevCenter/DevCenterData.AutoRest/custom/Start-AzDevCenterUserDevBox.ps1	Same placeholder attribute added
src/DevCenter/DevCenterData.AutoRest/custom/Restart-AzDevCenterUserDevBox.ps1	Same placeholder attribute added
src/DevCenter/DevCenterData.AutoRest/custom/Repair-AzDevCenterUserDevBox.ps1	Same placeholder attribute added
src/DevCenter/DevCenterData.AutoRest/custom/Remove-AzDevCenterUserEnvironment.ps1	Same placeholder attribute added
src/DevCenter/DevCenterData.AutoRest/custom/Remove-AzDevCenterUserDevBox.ps1	Same placeholder attribute added
src/DevCenter/DevCenterData.AutoRest/custom/New-AzDevCenterUserDevBox.ps1	Added ParameterBreakingChangeAttribute for LocalAdministrator
src/DevCenter/DevCenterData.AutoRest/README.md	Added root-module-name and a large block of breaking-changes rules
src/DevCenter/DevCenter/ChangeLog.md	Logged “Added preannouncement breaking change messages.”

Comments suppressed due to low confidence (3)

src/DevCenter/DevCenterData.AutoRest/custom/New-AzDevCenterUserDevBox.ps1:122

• [nitpick] Consider adding a brief ChangeDescription argument to the ParameterBreakingChangeAttribute to explain what change is coming for the LocalAdministrator parameter.

      [Microsoft.Azure.PowerShell.Cmdlets.DevCenterdata.Runtime.ParameterBreakingChangeAttribute("LocalAdministrator", "15.0.0", "3.0.0", "2025/11/18")]

src/DevCenter/DevCenter/ChangeLog.md:21

• [nitpick] The changelog entry is vague; consider specifying which cmdlets or parameters have breaking change preannouncements for clarity.

* Added preannouncement breaking change messages.

src/DevCenter/DevCenterData.AutoRest/README.md:173

• The large YAML block of breaking-changes rules may have inconsistent indentation and quoting (e.g. replacement-cmdlet: $.replace("DevCenter", "AzDevCenterAdmin")). Verify YAML syntax and properly quote nested strings to prevent parsing errors.

  - where:

[am-lim]

Hi @am-lim, please run autorest, build-module.ps1 and submit all changes.

Hi @YanaXu, this is done, updated for both control and data plane.

[YanaXu]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[am-lim]

/azp run

Hi @YanaXu, can you run the checks again?

[YanaXu]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[YanaXu]

Could you check the right word and don't revert it?

[YanaXu]

Hi @am-lim, the PR is clear but can you check the md files? If the words in the repo is better, can you revert yor change on them?