[BC] DataProtection Breaking Change Announcement #29117

JunKai-v · 2026-01-30T04:23:04Z

Description

Migration PR: #29023

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 · 2026-01-30T04:23:07Z

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

Copilot

Pull request overview

This PR adds breaking change announcement warnings to DataProtection module cmdlets in preparation for an AutoRest v4 migration (referenced in PR #29023). The changes include adding PreviewMessage attributes to cmdlets, updating help documentation, incrementing the module version to 2.8.0, and regenerating AutoRest configuration files.

Changes:

Added breaking change warning messages to 18 DataProtection cmdlets via PreviewMessage attributes
Updated module version from 2.7.0 to 2.8.0 and Az.Accounts dependency from 5.3.0 to 5.3.1
Corrected spelling errors in help documentation markdown files

Reviewed changes

Copilot reviewed 36 out of 36 changed files in this pull request and generated 39 comments.

Show a summary per file

File	Description
src/DataProtection/DataProtection/help/*.md (11 files)	Spelling corrections in cmdlet help documentation
src/DataProtection/DataProtection/Az.DataProtection.psd1	Updated module version to 2.8.0, Az.Accounts dependency to 5.3.1, and uncommented ScriptsToProcess/TypesToProcess
src/DataProtection/DataProtection.sln	Regenerated solution file with updated project GUID
src/DataProtection/DataProtection.Autorest/custom/Cmdlets/*/.ps1 (18 files)	Added PreviewMessage attributes announcing breaking changes
src/DataProtection/DataProtection.Autorest/README.md	Added AutoRest directive to configure breaking change preview messages
src/DataProtection/DataProtection.Autorest/Properties/AssemblyInfo.cs	Updated assembly version to 2.8.0
src/DataProtection/DataProtection.Autorest/generate-info.json	Updated generation ID
src/DataProtection/DataProtection.Autorest/docs/Az.DataProtection.md	Updated module GUID
src/DataProtection/DataProtection.Autorest/.gitignore	Removed ignore entries for custom/*.psm1 and custom/autogen-model-cmdlets

Copilot · 2026-01-30T04:34:16Z

src/DataProtection/DataProtection/help/Edit-AzDataProtectionPolicyTagClientObject.md

 This command adds a weekly tag to given backup policy

-### Example 2: Remove Weekly tag from Backup Policy
+### Example 2: Remove Weeky tag from Backup Policy


Spelling error: "Weeky" should be "Weekly".

Suggested change

### Example 2: Remove Weeky tag from Backup Policy

### Example 2: Remove Weekly tag from Backup Policy

Copilot · 2026-01-30T04:34:17Z

...Protection.Autorest/custom/Cmdlets/Policy/Edit-AzDataProtectionPolicyTriggerClientObject.ps1

+    * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n
+    * At least one change applies to this cmdlet.                                                     *`n
+    * See all possible breaking changes at https://go.microsoft.com/fwlink/?linkid=2333486            *`n


The PreviewMessage attribute contains incorrect information. The message states the breaking change will occur in "Az v16.0.0, to be released on May 2026", but the README.md directive (line 489) indicates it should be "Az v15.0.0, to be released on November 19th 2025". There is a version number mismatch and date mismatch between the cmdlet attribute and the AutoRest configuration.

Suggested change

* This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n

* At least one change applies to this cmdlet. *`n

* See all possible breaking changes at https://go.microsoft.com/fwlink/?linkid=2333486 *`n

* This cmdlet will undergo a breaking change in Az v15.0.0, to be released on November 19th 2025. *`n

* At least one change applies to this cmdlet. *`n

* See all possible breaking changes at https://go.microsoft.com/fwlink/?linkid=2333486 *`n

Copilot · 2026-01-30T04:34:17Z

...taProtection/DataProtection.Autorest/custom/Cmdlets/Platform/Job/Get-AzDataProtectionJob.ps1

    [CmdletBinding(PositionalBinding=$false)]
    [Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Description('Gets or lists jobs in a backup vault')]
+    [Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Runtime.PreviewMessage("**********************************************************************************************`n
+    * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The PreviewMessage attribute contains incorrect information. The message states the breaking change will occur in "Az v16.0.0, to be released on May 2026", but the README.md directive (line 489) indicates it should be "Az v15.0.0, to be released on November 19th 2025". There is a version number mismatch and date mismatch between the cmdlet attribute and the AutoRest configuration.

Suggested change

* This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n

* This cmdlet will undergo a breaking change in Az v15.0.0, to be released on November 19th 2025. *`n

Copilot · 2026-01-30T04:34:17Z

src/DataProtection/DataProtection/help/Update-AzDataProtectionBackupVault.md


-This command is used to change CmkIdentityType from SystemAssigned to UserAssigned.
-CmkIdentityId is a required parameter.
+This command is used to change CmkIdentityType from SystemAssigned to UserAssgined.


Spelling error: "UserAssgined" should be "UserAssigned".

Copilot · 2026-01-30T04:34:18Z

src/DataProtection/DataProtection/help/Start-AzDataProtectionBackupInstanceRestore.md


 The first, second commands fetch the instance and recovery point for the instance.
-The third and fourth command initializes the target container id and target storage account ARM id.
+The third and fourthcommand initializes the target container id and target storage account ARM id.


Spacing error: "fourthcommand" should be "fourth command" (missing space).

Copilot · 2026-01-30T04:34:26Z

src/DataProtection/DataProtection.Autorest/.gitignore

 internal
 exports
 tools
-custom/*.psm1
-custom/autogen-model-cmdlets
 test/*-TestResults.xml
 license.txt
 /*.ps1


The removal of these two gitignore entries may have unintended consequences. The entries "custom/*.psm1" and "custom/autogen-model-cmdlets" were previously ignored but are now tracked. If these paths should remain untracked (e.g., because they contain generated or temporary files), this change should be reverted. Please verify whether these paths should be tracked in version control.

Copilot · 2026-01-30T04:34:26Z

src/DataProtection/DataProtection/help/Find-AzDataProtectionRestorableTimeRange.md

 Fetch the backup instance.
 Fetch valid time ranges for Backup Instance $instance[0].
-Display RestorableTimeRange, note that this can be multiple discrete ranges.
+Dispaly RestorableTimeRange, note that this can be multiple dicrete ranges.


Spelling error: "dicrete" should be "discrete".

Suggested change

Dispaly RestorableTimeRange, note that this can be multiple dicrete ranges.

Display RestorableTimeRange, note that this can be multiple discrete ranges.

Copilot · 2026-01-30T04:34:26Z

...tection/DataProtection.Autorest/custom/Cmdlets/Policy/Get-AzDataProtectionPolicyTemplate.ps1

    [CmdletBinding(PositionalBinding=$false)]
    [Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Description('Gets default policy template for a selected datasource type.')]
+    [Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Runtime.PreviewMessage("**********************************************************************************************`n
+    * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The PreviewMessage attribute contains incorrect information. The message states the breaking change will occur in "Az v16.0.0, to be released on May 2026", but the README.md directive (line 489) indicates it should be "Az v15.0.0, to be released on November 19th 2025". There is a version number mismatch and date mismatch between the cmdlet attribute and the AutoRest configuration.

Suggested change

* This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n

* This cmdlet will undergo a breaking change in Az v15.0.0, to be released on November 19th 2025. *`n

Copilot · 2026-01-30T04:34:26Z

...on/DataProtection.Autorest/custom/Cmdlets/Platform/Vault/New-AzDataProtectionBackupVault.ps1

    [CmdletBinding(PositionalBinding=$false, SupportsShouldProcess)]
    [Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Description('Creates or updates a BackupVault resource belonging to a resource group.')]
+    [Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Runtime.PreviewMessage("**********************************************************************************************`n
+    * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The PreviewMessage attribute contains incorrect information. The message states the breaking change will occur in "Az v16.0.0, to be released on May 2026", but the README.md directive (line 489) indicates it should be "Az v15.0.0, to be released on November 19th 2025". There is a version number mismatch and date mismatch between the cmdlet attribute and the AutoRest configuration.

Suggested change

* This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n

* This cmdlet will undergo a breaking change in Az v15.0.0, to be released on November 19th 2025. *`n

Copilot · 2026-01-30T04:34:27Z

src/DataProtection/DataProtection/help/Undo-AzDataProtectionBackupInstanceDeletion.md

 ```

-The first command is used to fetch the backup instances which are in soft deleted for a give backup vault.
+The first comamnd is used to fetch the backup instances which are in soft deleted for a give backup vault.


Spelling error: "comamnd" should be "command".

isra-fel · 2026-01-30T04:38:28Z

/azp run

azure-pipelines · 2026-01-30T04:38:34Z

Azure Pipelines will not run the associated pipelines, because the pull request was updated after the run command was issued. Review the pull request again and issue a new run command.

JunKai-v · 2026-02-03T04:34:27Z

replaced by #29125

DataProtection breaking change announcement

6858315

Copilot AI review requested due to automatic review settings January 30, 2026 04:23

JunKai-v marked this pull request as draft January 30, 2026 04:24

Copilot started reviewing on behalf of JunKai-v January 30, 2026 04:25 View session

JunKai-v added Breaking Change Preannounce This PR adds preannouncement about upcoming breaking change autorest v4 migration pr migrating module from generated by autorest.powershell v3 to v4 labels Jan 30, 2026

JunKai-v mentioned this pull request Jan 30, 2026

[PS] Migrate DataProtection module to autorest v4 #29023

Closed

6 tasks

Copilot AI reviewed Jan 30, 2026

View reviewed changes

Merge branch 'main' into dataprotection-BC

286ff47

JunKai-v mentioned this pull request Jan 30, 2026

[PS] Migrate DataProtection module to autorest v4 after <Added support for DPP vault soft delete feature> #29122

Draft

6 tasks

JunKai-v closed this Feb 3, 2026

JunKai-v deleted the dataprotection-BC branch February 3, 2026 04:37

	### Example 2: Remove Weeky tag from Backup Policy
	### Example 2: Remove Weekly tag from Backup Policy

	* This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n
	* This cmdlet will undergo a breaking change in Az v15.0.0, to be released on November 19th 2025. *`n

	Dispaly RestorableTimeRange, note that this can be multiple dicrete ranges.
	Display RestorableTimeRange, note that this can be multiple discrete ranges.

[BC] DataProtection Breaking Change Announcement #29117

[BC] DataProtection Breaking Change Announcement #29117

Uh oh!

Conversation

JunKai-v commented Jan 30, 2026

Description

Mandatory Checklist

Uh oh!

azure-client-tools-bot-prd bot commented Jan 30, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

isra-fel commented Jan 30, 2026

Uh oh!

azure-pipelines bot commented Jan 30, 2026

Uh oh!

JunKai-v commented Feb 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants