[BC]Migrate Module Breaking Changes Announcement #29131

JiaSeng-v · 2026-02-04T00:55:37Z

Description

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-02-04T00:55:40Z

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

github-actions · 2026-02-04T01:00:39Z

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.

Copilot

Pull request overview

This pull request adds breaking change announcements to the Az.Migrate module for changes scheduled in Az v16.0.0 (May 2026). The changes add PreviewMessage attributes to multiple cmdlets to warn users about upcoming breaking changes.

Changes:

Added breaking change announcement to ChangeLog.md
Added PreviewMessage attributes to 8 cmdlets (New-AzMigrateServerReplication, New-AzMigrateProject, New-AzMigrateDiskMapping, Get-AzMigrateServerReplication, Get-AzMigrateLocalServerReplication, Get-AzMigrateLocalJob, Get-AzMigrateJob, Get-AzMigrateDiscoveredServer)
Added preview-announcement directive in AutoRest README.md for New-ReplicationProtectionContainerMapping
Updated module version to 2.11.0 and regenerated AutoRest files

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
src/Migrate/Migrate/ChangeLog.md	Added breaking change announcement entry with reference URL
src/Migrate/Migrate/Az.Migrate.psd1	Updated generated date, uncommented ScriptsToProcess and TypesToProcess, minor formatting changes
src/Migrate/Migrate.sln	Updated project GUID for AutoRest project reference
src/Migrate/Migrate.Autorest/test/README.md	Changed path separator from forward slash to backslash for Windows compatibility
src/Migrate/Migrate.Autorest/resources/README.md	Changed path separator from forward slash to backslash for Windows compatibility
src/Migrate/Migrate.Autorest/generate-info.json	Updated generation ID for new AutoRest generation
src/Migrate/Migrate.Autorest/docs/README.md	Changed path separators from forward slash to backslash for Windows compatibility
src/Migrate/Migrate.Autorest/docs/Az.Migrate.md	Updated Module GUID
src/Migrate/Migrate.Autorest/custom/README.md	Changed path separators from forward slash to backslash for Windows compatibility
src/Migrate/Migrate.Autorest/custom/New-AzMigrateServerReplication.ps1	Added PreviewMessage attribute with breaking change announcement
src/Migrate/Migrate.Autorest/custom/New-AzMigrateProject.ps1	Added PreviewMessage attribute with breaking change announcement
src/Migrate/Migrate.Autorest/custom/New-AzMigrateDiskMapping.ps1	Added PreviewMessage attribute with breaking change announcement
src/Migrate/Migrate.Autorest/custom/Get-AzMigrateServerReplication.ps1	Added PreviewMessage attribute with breaking change announcement
src/Migrate/Migrate.Autorest/custom/Get-AzMigrateLocalServerReplication.ps1	Added PreviewMessage attribute with breaking change announcement (duplicate attribute issue)
src/Migrate/Migrate.Autorest/custom/Get-AzMigrateLocalJob.ps1	Added PreviewMessage attribute with breaking change announcement (duplicate attribute issue)
src/Migrate/Migrate.Autorest/custom/Get-AzMigrateJob.ps1	Added PreviewMessage attribute with breaking change announcement
src/Migrate/Migrate.Autorest/custom/Get-AzMigrateDiscoveredServer.ps1	Added PreviewMessage attribute with breaking change announcement
src/Migrate/Migrate.Autorest/custom/Az.Migrate.custom.psm1	Changed path separators from forward slash to backslash for Windows compatibility
src/Migrate/Migrate.Autorest/README.md	Added preview-announcement directive for New-ReplicationProtectionContainerMapping cmdlet
src/Migrate/Migrate.Autorest/Properties/AssemblyInfo.cs	Updated assembly version from 2.10.1 to 2.11.0

Copilot · 2026-02-04T01:06:18Z

src/Migrate/Migrate.Autorest/custom/New-AzMigrateProject.ps1


 function New-AzMigrateProject {
+    [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessage("**********************************************************************************************`n
+  * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The grammar is incorrect. It should be "to be released in May 2026" not "to be released on May 2026". The preposition "in" is correct for months, while "on" is used for specific dates.

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 v16.0.0, to be released in May 2026. *`n

Copilot · 2026-02-04T01:06:19Z

src/Migrate/Migrate.Autorest/custom/Get-AzMigrateServerReplication.ps1

 #>
 function Get-AzMigrateServerReplication {
+    [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessage("**********************************************************************************************`n
+  * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The grammar is incorrect. It should be "to be released in May 2026" not "to be released on May 2026". The preposition "in" is correct for months, while "on" is used for specific dates.

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 v16.0.0, to be released in May 2026. *`n

Copilot · 2026-02-04T01:06:19Z

src/Migrate/Migrate.Autorest/custom/Get-AzMigrateLocalJob.ps1

 #>
 function Get-AzMigrateLocalJob {
+    [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessage("**********************************************************************************************`n
+  * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The grammar is incorrect. It should be "to be released in May 2026" not "to be released on May 2026". The preposition "in" is correct for months, while "on" is used for specific dates.

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 v16.0.0, to be released in May 2026. *`n

Copilot · 2026-02-04T01:06:19Z

src/Migrate/Migrate.Autorest/custom/Get-AzMigrateJob.ps1

 #>
 function Get-AzMigrateJob {
+    [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessage("**********************************************************************************************`n
+  * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The grammar is incorrect. It should be "to be released in May 2026" not "to be released on May 2026". The preposition "in" is correct for months, while "on" is used for specific dates.

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 v16.0.0, to be released in May 2026. *`n

Copilot · 2026-02-04T01:06:20Z

src/Migrate/Migrate.Autorest/custom/Get-AzMigrateDiscoveredServer.ps1


 function Get-AzMigrateDiscoveredServer {
+  [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessage("**********************************************************************************************`n
+  * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The grammar is incorrect. It should be "to be released in May 2026" not "to be released on May 2026". The preposition "in" is correct for months, while "on" is used for specific dates.

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 v16.0.0, to be released in May 2026. *`n

Copilot · 2026-02-04T01:06:20Z

src/Migrate/Migrate.Autorest/custom/New-AzMigrateDiskMapping.ps1

 #>
 function New-AzMigrateDiskMapping {
+    [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessage("**********************************************************************************************`n
+  * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The grammar is incorrect. It should be "to be released in May 2026" not "to be released on May 2026". The preposition "in" is correct for months, while "on" is used for specific dates.

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 v16.0.0, to be released in May 2026. *`n

Copilot · 2026-02-04T01:06:21Z

src/Migrate/Migrate.Autorest/custom/Get-AzMigrateLocalServerReplication.ps1

 #>
 function Get-AzMigrateLocalServerReplication {
+    [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessage("**********************************************************************************************`n
+  * This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *`n


The grammar is incorrect. It should be "to be released in May 2026" not "to be released on May 2026". The preposition "in" is correct for months, while "on" is used for specific dates.

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 v16.0.0, to be released in May 2026. *`n

Copilot · 2026-02-04T01:06:21Z

src/Migrate/Migrate.Autorest/custom/Get-AzMigrateLocalServerReplication.ps1

+  ***************************************************************************************************")]
    [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]


This function has two PreviewMessage attributes. The breaking change announcement attribute on lines 25-29 is duplicated with a different preview message attribute on line 30. This will likely cause conflicts. If both attributes are needed, verify that the runtime supports multiple PreviewMessage attributes, otherwise remove the duplicate or consolidate the messages.

Suggested change

***************************************************************************************************")]

[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]

***************************************************************************************************`n

`n

This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]

Copilot · 2026-02-04T01:06:21Z

src/Migrate/Migrate.Autorest/custom/Get-AzMigrateLocalJob.ps1

+  ***************************************************************************************************")]
    [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]


This function has two PreviewMessage attributes. The breaking change announcement attribute on lines 25-29 is duplicated with a different preview message attribute on line 30. This will likely cause conflicts. If both attributes are needed, verify that the runtime supports multiple PreviewMessage attributes, otherwise remove the duplicate or consolidate the messages.

Suggested change

***************************************************************************************************")]

[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]

***************************************************************************************************`n

This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]

Copilot · 2026-02-04T01:06:21Z

src/Migrate/Migrate/ChangeLog.md

        - Additional information about change #1
 -->
 ## Upcoming Release
+* Preannounced breaking changes. Please refer to https://go.microsoft.com/fwlink/?linkid=2333229


The URL in the ChangeLog.md (linkid=2333229) is different from the URL used in all the cmdlet files and the README.md directive (linkid=2333486). These URLs should be consistent. Please verify which URL is correct and update accordingly.

[BC]Migrate Module Breaking Changes Announcement

1fcac6f

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

JiaSeng-v mentioned this pull request Feb 4, 2026

Bernard migrate migrate to autorest v4 #28721

Open

6 tasks

Copilot started reviewing on behalf of JiaSeng-v February 4, 2026 00:57 View session

JiaSeng-v added Contains Breaking Change This PR contains breaking change 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 Feb 4, 2026

Copilot AI reviewed Feb 4, 2026

View reviewed changes

	* 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 v16.0.0, to be released in May 2026. *`n

		***************************************************************************************************")]
		[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]

[BC]Migrate Module Breaking Changes Announcement #29131

Are you sure you want to change the base?

[BC]Migrate Module Breaking Changes Announcement #29131

Uh oh!

Conversation

JiaSeng-v commented Feb 4, 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 Feb 4, 2026

Uh oh!

github-actions bot commented Feb 4, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 4, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

JiaSeng-v commented Feb 4, 2026 •

edited

Loading