[PS] Migrate DataProtection module to autorest v4 after <Added support for DPP vault soft delete feature> by JunKai-v · Pull Request #29122 · Azure/azure-powershell

JunKai-v · 2026-01-30T11:45:58Z

Description

Preannouncement PR: #29125

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-30T11:46:04Z

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

Copilot

Pull request overview

This PR migrates the DataProtection module from AutoRest v3 to v4, implementing support for DPP vault soft delete features. The migration involves substantial changes across help documentation, code model namespaces, and parameter signatures.

Changes:

Migrated from AutoRest v3 to v4 by removing use-extension directive in README.md
Updated model namespaces from Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api20250901 to Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models
Changed identity-related parameters in vault cmdlets (replaced -IdentityType and -IdentityUserAssignedIdentity with -EnableSystemAssignedIdentity and -UserAssignedIdentity)
Regenerated help documentation with updated type references and parameter descriptions
Updated cmdlet parameter names (e.g., -BackupInstanceName to -Name in Update-AzDataProtectionBackupInstance)
Removed deprecated -IdentityType parameter from ResourceGuard cmdlets
Added new parameter sets and identity objects for various operations

Reviewed changes

Copilot reviewed 144 out of 144 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
src/DataProtection/DataProtection.Autorest/README.md	Removed AutoRest v3 extension directive, updated variant removal patterns, added new directives
src/DataProtection/DataProtection/help/*.md	Regenerated help documentation with updated type references and corrected spellings
src/DataProtection/DataProtection.Autorest/custom/*/.ps1	Updated model namespace references throughout custom cmdlets
src/DataProtection/DataProtection.Autorest/custom/Models/*.cs	Updated namespace from Api20250901 to root Models namespace
src/DataProtection/DataProtection/Az.DataProtection.psd1	Updated module manifest metadata
src/DataProtection/DataProtection.sln	Updated project GUID
src/DataProtection/DataProtection.Autorest/Properties/AssemblyInfo.cs	Version bump from 2.8.0 to 2.9.0

Copilot

Pull request overview

Copilot reviewed 146 out of 146 changed files in this pull request and generated no new comments.

JunKai-v · 2026-02-03T02:06:00Z

/azp run

azure-pipelines · 2026-02-03T02:06:18Z

Azure Pipelines successfully started running 3 pipeline(s).

github-actions · 2026-02-03T02:54:25Z

To the author of the pull request,
This PR was labeled "Contains Breaking Change" because breaking changes have been detected by the static analysis pipeline.

According to our policy, breaking changes can only take place during major release and they must be preannounced.
Please follow our guide on the detailed steps.
Required: Please fill in the task below to facilitate our contact,you will receive notifications related to breaking changes.

JunKai-v · 2026-02-03T02:58:36Z

/azp run

azure-pipelines · 2026-02-03T02:58:52Z

Azure Pipelines successfully started running 3 pipeline(s).

JunKai-v · 2026-02-04T00:07:42Z

/azp run

azure-pipelines · 2026-02-04T00:08:01Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 156 out of 156 changed files in this pull request and generated no new comments.

…kup (Azure#29408) Co-authored-by: Selasie Mortey <smortey@microsoft.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…ls (Azure#29466)

…ke idempotent (Azure#29473) Co-authored-by: Jonathan Ruttle <jruttle@microsoft.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Yabo Hu <yabhu@microsoft.com>

Copilot

Pull request overview

Copilot reviewed 171 out of 172 changed files in this pull request and generated 10 comments.

+@{
+  GUID = '18e8a0b0-ef6f-49db-8024-676d2f12e3d8'
+  RootModule = './Az.DnsResolver.psm1'
+  ModuleVersion = '0.2.9'


+$UAMI = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userAssignedIdentityName"

-$vault = Update-AzDataProtectionBackupVault -AssignUserIdentity $UAMI -SubscriptionId "00000000-0000-0000-0000-000000000000" -VaultName "vaultName" -ResourceGroupName "resourceGroupName" -IdentityType 'SystemAssigned,UserAssigned'
+$vault = Update-AzDataProtectionBackupVault -EnableSystemAssignedIdentity -UserAssignedIdentity $UAMI -SubscriptionId "00000000-0000-0000-0000-000000000000" -VaultName "vaultName" -ResourceGroupName "resourceGroupName"



        [Parameter(ParameterSetName="TriggerExpanded", Mandatory, HelpMessage='Type of the source data store')]
-        [Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Support.SourceDataStoreType]
+        [System.String]


+"Az.DataProtection","Update-AzDataProtectionBackupVault","6","3","Unassigned_Parameter","5013","1","Update-AzDataProtectionBackupVault -EnableSystemAssignedIdentity must be assigned with a value.","-EnableSystemAssignedIdentity","Assign value for the parameter -EnableSystemAssignedIdentity."
+"Az.DataProtection","Update-AzDataProtectionBackupVault","6","3","Unassigned_Parameter","5013","1","Update-AzDataProtectionBackupVault -EnableSystemAssignedIdentity must be assigned with a value.","-EnableSystemAssignedIdentity","Assign value for the parameter -EnableSystemAssignedIdentity."


-"Az.DataProtection","Start-AzDataProtectionBackupInstanceRestore","9","4","ParameterNameAndValue\Measure-ParameterNameAndValue","5200","1","Exception calling 'FindAll' with '2' argument(s): 'Cannot index into a null array.'","'teststorageaccountRG'","Unexpected Error. Please check [Trouble Shotting for Unexpected Errors in Example Issues](***/blob/main/documentation/Debugging-StaticAnalysis-Errors.md#Troubleshotting-Example-Issues) for more details."
+"Az.DataProtection","Update-AzDataProtectionBackupVault","6","3","Unassigned_Parameter","5013","1","Update-AzDataProtectionBackupVault -EnableSystemAssignedIdentity must be assigned with a value.","-EnableSystemAssignedIdentity","Assign value for the parameter -EnableSystemAssignedIdentity."
+"Az.DataProtection","Update-AzDataProtectionBackupVault","6","3","Unassigned_Parameter","5013","1","Update-AzDataProtectionBackupVault -EnableSystemAssignedIdentity must be assigned with a value.","-EnableSystemAssignedIdentity","Assign value for the parameter -EnableSystemAssignedIdentity."
+"Az.DataProtection","Start-AzDataProtectionBackupInstanceRestore","9","4","ParameterNameAndValue\Measure-ParameterNameAndValue","5200","1","Exception calling 'FindAll' with '2' argument(s): 'Cannot index into a null array.'","'teststorageaccountRG'","Unexpected Error. Please check [Trouble Shotting for Unexpected Errors in Example Issues](***/blob/main/documentation/Debugging-StaticAnalysis-Errors.md#Troubleshotting-Example-Issues) for more details."


 ## SYNOPSIS
-Validate whether update for backup instance will be successful or not
+Validate whether validate for backup instance will be successful or not


                $createVaultParams.Add("SubscriptionId", $SubscriptionId)
            }

-            # Set identity type (default to SystemAssigned if not specified)
-            if($PSBoundParameters.ContainsKey("IdentityType"))
+            # Set identity - default to SystemAssigned if not specified
+            if($PSBoundParameters.ContainsKey("EnableSystemAssignedIdentity"))
            {
-                $createVaultParams.Add("IdentityType", $IdentityType)
+                $createVaultParams.Add("EnableSystemAssignedIdentity", $EnableSystemAssignedIdentity)
            }
            else
            {
-                $createVaultParams.Add("IdentityType", "SystemAssigned")
+                $createVaultParams.Add("EnableSystemAssignedIdentity", $true)
            }


+            # Set identity - default to SystemAssigned if not specified
+            if($PSBoundParameters.ContainsKey("EnableSystemAssignedIdentity"))
            {
-                $createVaultParams.Add("IdentityType", $IdentityType)
+                $createVaultParams.Add("EnableSystemAssignedIdentity", $EnableSystemAssignedIdentity)
            }
            else
            {
-                $createVaultParams.Add("IdentityType", "SystemAssigned")
+                $createVaultParams.Add("EnableSystemAssignedIdentity", $true)
            }


+"Az.DataProtection","Edit-AzDataProtectionPolicyRetentionRuleClientObject","Edit-AzDataProtectionPolicyRetentionRuleClientObject","0","3000","The type of property 'PolicyRule' of type 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api20250901.IBackupPolicy' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule]'.","Change the type of property 'PolicyRule' back to 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule'."
+"Az.DataProtection","Edit-AzDataProtectionPolicyRetentionRuleClientObject","Edit-AzDataProtectionPolicyRetentionRuleClientObject","0","3000","The type of property 'PolicyRule' of type 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api20250901.IBackupPolicy' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule]'.","Change the type of property 'PolicyRule' back to 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule'."


@@ -132,10 +131,9 @@ Name          Location      Type                                  IdentityType
 vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned, UserAssigned
 ```

-First, create a hashtable for the User Assigned Managed Identity (UAMI) object.
-This object maps the UAMI resource ID to a new instance of UserAssignedIdentity.
+First, define the User Assigned Managed Identity (UAMI) ARM resource ID.
 Next, use the Update-AzDataProtectionBackupVault cmdlet to assign the UAMI to the backup vault while keeping the System Assigned Managed Identity.
-The -IdentityType parameter specifies that both SystemAssigned and UserAssigned identities are used.
+The -EnableSystemAssignedIdentity switch enables the system-assigned identity, and the -UserAssignedIdentity parameter specifies the user-assigned identity to associate with the vault.


…to dp-v4-new

JunKai-v · 2026-05-06T02:17:42Z

/azp run

azure-pipelines · 2026-05-06T02:17:56Z

Azure Pipelines successfully started running 3 pipeline(s).

data protection v4 migration

bf61ec1

Copilot AI review requested due to automatic review settings January 30, 2026 11:45

JunKai-v mentioned this pull request Jan 30, 2026

[PS] Migrate DataProtection module to autorest v4 #29023

Closed

6 tasks

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

Copilot AI reviewed Jan 30, 2026

View reviewed changes

JunKai-v added 2 commits February 3, 2026 08:36

breaking change issues

775cb95

update change log md

3661a14

Copilot AI review requested due to automatic review settings February 3, 2026 00:37

Copilot started reviewing on behalf of JunKai-v February 3, 2026 00:40 View session

Copilot AI reviewed Feb 3, 2026

View reviewed changes

fix spelling error

ff6bd37

JunKai-v added Contains Breaking Change This PR contains breaking change customer-reported autorest v4 migration pr migrating module from generated by autorest.powershell v3 to v4 labels Feb 3, 2026

JunKai-v mentioned this pull request Feb 3, 2026

[BC] DataProtection Breaking Change Announcement after <Added support for DPP vault soft delete feature> #29125

Merged

6 tasks

update example issues csv

54324b7

Copilot AI review requested due to automatic review settings February 4, 2026 02:02

fix no az account login issues

4b0fba1

Copilot started reviewing on behalf of JunKai-v February 4, 2026 02:04 View session

Copilot AI reviewed Feb 4, 2026

View reviewed changes

JunKai-v added 2 commits February 4, 2026 17:20

fix test cases param

367eb7a

update breaking change issues csv

189fa7e

azure-powershell-bot and others added 15 commits April 28, 2026 15:34

[skip ci] Archive d54c8ab (Azure#29470)

dec7b63

[skip ci] Archive 9e0c3eb (Azure#29471)

5546bd1

[skip ci] Archive abba7c7 (Azure#29472)

3f6c39f

[NetAppFiles] Bump to 2026-01-01 (Azure#29425)

c4e1061

[Az.DataProtection] Add auto-protection support for Blob and ADLS bac…

a60e9c3

…kup (Azure#29408) Co-authored-by: Selasie Mortey <smortey@microsoft.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

[skip ci] Archive a60e9c3 (Azure#29479)

da40f1d

Fix New-AzRoleAssignment error message to include service error detai…

c5b53f1

…ls (Azure#29466)

[Release-2026-05-05] Trim Changelog (Azure#29481)

c3d7c4e

[Resources] Fix Remove-AzDenyAssignment: honor -Confirm:$false and ma…

e51cdc6

…ke idempotent (Azure#29473) Co-authored-by: Jonathan Ruttle <jruttle@microsoft.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Yabo Hu <yabhu@microsoft.com>

[Release-2026-05-05] Trim Changelog (Azure#29482)

1958185

remove ProgressAction parameters

bdfc4ff

Bump Version for 15.6.0

b76d638

Release Az 15.6.0 (Azure#29486)

cb69a33

Merge remote-tracking branch 'upstream/main' into dp-v4-new

f7fbd99

solve conflict and rebuild

de5c9c2

Copilot AI review requested due to automatic review settings May 5, 2026 03:42

Copilot started reviewing on behalf of JunKai-v May 5, 2026 03:45 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

khang-11 changed the base branch from main to autorest-v4-breakingchange May 6, 2026 00:51

khang-11 requested review from NoriZC, audreyttt, haagha, ookoka, teresaritorto and yanzhudd as code owners May 6, 2026 00:51

JunKai-v added 2 commits May 6, 2026 09:56

Merge remote-tracking branch 'upstream/autorest-v4-breakingchange' in…

bdcb72c

…to dp-v4-new

rebuild

8564252

YanaXu removed the customer-reported label May 6, 2026

		"Az.DataProtection","Update-AzDataProtectionBackupVault","6","3","Unassigned_Parameter","5013","1","Update-AzDataProtectionBackupVault -EnableSystemAssignedIdentity must be assigned with a value.","-EnableSystemAssignedIdentity","Assign value for the parameter -EnableSystemAssignedIdentity."
		"Az.DataProtection","Update-AzDataProtectionBackupVault","6","3","Unassigned_Parameter","5013","1","Update-AzDataProtectionBackupVault -EnableSystemAssignedIdentity must be assigned with a value.","-EnableSystemAssignedIdentity","Assign value for the parameter -EnableSystemAssignedIdentity."

		"Az.DataProtection","Edit-AzDataProtectionPolicyRetentionRuleClientObject","Edit-AzDataProtectionPolicyRetentionRuleClientObject","0","3000","The type of property 'PolicyRule' of type 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api20250901.IBackupPolicy' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule]'.","Change the type of property 'PolicyRule' back to 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule'."
		"Az.DataProtection","Edit-AzDataProtectionPolicyRetentionRuleClientObject","Edit-AzDataProtectionPolicyRetentionRuleClientObject","0","3000","The type of property 'PolicyRule' of type 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api20250901.IBackupPolicy' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule]'.","Change the type of property 'PolicyRule' back to 'Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.IBasePolicyRule'."

Conversation

JunKai-v commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

JunKai-v commented Feb 3, 2026

Uh oh!

azure-pipelines Bot commented Feb 3, 2026

Uh oh!

github-actions Bot commented Feb 3, 2026

Uh oh!

JunKai-v commented Feb 3, 2026

Uh oh!

azure-pipelines Bot commented Feb 3, 2026

Uh oh!

JunKai-v commented Feb 4, 2026

Uh oh!

azure-pipelines Bot commented Feb 4, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

JunKai-v commented May 6, 2026

Uh oh!

azure-pipelines Bot commented May 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants

JunKai-v commented Jan 30, 2026 •

edited

Loading