Skip to content

Add new support for Az.Migrate module for API versioning 2026-02-01 #29333

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
anhdinh-msft wants to merge 5 commits into
base: main
Choose a base branch
from
Draft

Add new support for Az.Migrate module for API versioning 2026-02-01 #29333

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
f80f7a8
WIP, initial testing on new API version for Az.Migrate 2026-02-01
anhdinh-msft Mar 27, 2026
bf94324
more WIP
anhdinh-msft Mar 27, 2026
20d18b0
added the generated docs back
anhdinh-msft Mar 27, 2026
3c05071
remove unnecessary changes
anhdinh-msft Mar 30, 2026
95f536b
added Unit tests and E2E tests
anhdinh-msft Mar 31, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/Migrate/Migrate.Autorest/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ input-file:
- $(repo)/specification/migrate/resource-manager/Microsoft.OffAzure/stable/2020-01-01/migrate.json
- $(repo)/specification/migrateprojects/resource-manager/Microsoft.Migrate/preview/2018-09-01-preview/migrate.json
- $(repo)/specification/recoveryservicessiterecovery/resource-manager/Microsoft.RecoveryServices/SiteRecovery/stable/2025-08-01/service.json
- $(repo)/specification/recoveryservicesdatareplication/resource-manager/Microsoft.DataReplication/DataReplication/stable/2024-09-01/recoveryservicesdatareplication.json
- /azure-rest-api-specs-pr/specification/recoveryservicesdatareplication/resource-manager/Microsoft.DataReplication/DataReplication/stable/2026-02-01/recoveryservicesdatareplication.json
Copy link

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The input-file entry is now an absolute path (/azure-rest-api-specs-pr/...), which will break Autorest generation in other environments/agents. Use the repo-relative form consistent with the other entries (e.g., $(repo)/specification/.../2026-02-01/...json) so generation is portable.

Suggested change
- /azure-rest-api-specs-pr/specification/recoveryservicesdatareplication/resource-manager/Microsoft.DataReplication/DataReplication/stable/2026-02-01/recoveryservicesdatareplication.json
- $(repo)/specification/recoveryservicesdatareplication/resource-manager/Microsoft.DataReplication/DataReplication/stable/2026-02-01/recoveryservicesdatareplication.json

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Member Author

@anhdinh-msft anhdinh-msft Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Only local testing for now. Will update back to $(repo) once the new spec is checked in


module-version: 3.0.14
title: Migrate
Expand Down
2 changes: 1 addition & 1 deletion src/Migrate/Migrate.Autorest/UX/Microsoft.DataReplication/replicationFabrics.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "replicationFabrics",
"apiVersion": "2024-09-01",
"apiVersion": "2026-02-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.migrate"
},
Expand Down
2 changes: 1 addition & 1 deletion src/Migrate/Migrate.Autorest/custom/AzLocalDiskInput.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
// Licensed under the MIT License. See License.txt in the project root for license information.
using System;

namespace Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901
namespace Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201
{
public class AzLocalDiskInput
{
Expand Down
2 changes: 1 addition & 1 deletion src/Migrate/Migrate.Autorest/custom/AzLocalNicInput.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License. See License.txt in the project root for license information.

namespace Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901
namespace Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201
{
public class AzLocalNicInput
{
Expand Down
2 changes: 1 addition & 1 deletion src/Migrate/Migrate.Autorest/custom/Get-AzMigrateLocalJob.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ function Get-AzMigrateLocalJob {
* See all possible breaking changes at https://go.microsoft.com/fwlink/?linkid=2333486 *`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.")]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.IJobModel])]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.IJobModel])]
[CmdletBinding(DefaultParameterSetName = 'ListByName', PositionalBinding = $false)]
param(
[Parameter(ParameterSetName = 'GetById', Mandatory)]
Expand Down
2 changes: 1 addition & 1 deletion src/Migrate/Migrate.Autorest/custom/Get-AzMigrateLocalServerReplication.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ function Get-AzMigrateLocalServerReplication {
* See all possible breaking changes at https://go.microsoft.com/fwlink/?linkid=2333486 *`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.")]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.IProtectedItemModel])]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.IProtectedItemModel])]
[CmdletBinding(DefaultParameterSetName = 'ListByName', PositionalBinding = $false)]
param(
[Parameter(ParameterSetName = 'GetByItemID', Mandatory)]
Expand Down
12 changes: 6 additions & 6 deletions src/Migrate/Migrate.Autorest/custom/Initialize-AzMigrateLocalReplicationInfrastructure.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -469,12 +469,12 @@ function Initialize-AzMigrateLocalReplicationInfrastructure {
}

# Setup Policy deployment parameters
$policyProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.PolicyModelProperties]::new()
$policyProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.PolicyModelProperties]::new()
if ($instanceType -eq $AzLocalInstanceTypes.HyperVToAzLocal) {
$policyCustomProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.HyperVToAzStackHcipolicyModelCustomProperties]::new()
$policyCustomProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.HyperVToAzStackHcipolicyModelCustomProperties]::new()
}
elseif ($instanceType -eq $AzLocalInstanceTypes.VMwareToAzLocal) {
$policyCustomProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.VMwareToAzStackHcipolicyModelCustomProperties]::new()
$policyCustomProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.VMwareToAzStackHcipolicyModelCustomProperties]::new()
}
else {
throw "Instance type '$($instanceType)' is not supported. Currently, for AzLocal scenario, only HyperV and VMware as the source is supported."
Expand Down Expand Up @@ -1133,15 +1133,15 @@ function Initialize-AzMigrateLocalReplicationInfrastructure {
}

# Setup Replication Extension deployment parameters
$replicationExtensionProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.ReplicationExtensionModelProperties]::new()
$replicationExtensionProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.ReplicationExtensionModelProperties]::new()

if ($instanceType -eq $AzLocalInstanceTypes.HyperVToAzLocal) {
$replicationExtensionCustomProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.HyperVToAzStackHcireplicationExtensionModelCustomProperties]::new()
$replicationExtensionCustomProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.HyperVToAzStackHcireplicationExtensionModelCustomProperties]::new()
$replicationExtensionCustomProperties.HyperVFabricArmId = $params.SourceFabricArmId

}
elseif ($instanceType -eq $AzLocalInstanceTypes.VMwareToAzLocal) {
$replicationExtensionCustomProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.VMwareToAzStackHcireplicationExtensionModelCustomProperties]::new()
$replicationExtensionCustomProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.VMwareToAzStackHcireplicationExtensionModelCustomProperties]::new()
$replicationExtensionCustomProperties.VMwareFabricArmId = $params.SourceFabricArmId
}
else {
Expand Down
4 changes: 2 additions & 2 deletions src/Migrate/Migrate.Autorest/custom/New-AzMigrateLocalDiskMappingObject.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ https://learn.microsoft.com/powershell/module/az.migrate/new-azmigratelocaldiskm
#>
function New-AzMigrateLocalDiskMappingObject {
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.AzLocalDiskInput])]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.AzLocalDiskInput])]
[CmdletBinding(PositionalBinding = $false)]
param(
[Parameter(Mandatory)]
Expand Down Expand Up @@ -80,7 +80,7 @@ function New-AzMigrateLocalDiskMappingObject {
throw "PhysicalSectorSize must be 512 for VHD format but $PhysicalSectorSize is given."
}

$DiskObject = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.AzLocalDiskInput]::new(
$DiskObject = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.AzLocalDiskInput]::new(
$DiskID,
$isDynamicDisk,
$Size,
Expand Down
4 changes: 2 additions & 2 deletions src/Migrate/Migrate.Autorest/custom/New-AzMigrateLocalNicMappingObject.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ https://learn.microsoft.com/powershell/module/az.migrate/new-azmigratelocalnicma
#>
function New-AzMigrateLocalNicMappingObject {
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.AzLocalNicInput])]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.AzLocalNicInput])]
[CmdletBinding(PositionalBinding = $false)]
param(
[Parameter(Mandatory)]
Expand Down Expand Up @@ -70,7 +70,7 @@ function New-AzMigrateLocalNicMappingObject {
$selectionTypeForFailover = $VMNicSelection.NotSelected
}

$NicObject = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.AzLocalNicInput]::new(
$NicObject = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.AzLocalNicInput]::new(
$NicID,
$TargetVirtualSwitchId,
$TargetTestVirtualSwitchId,
Expand Down
38 changes: 27 additions & 11 deletions src/Migrate/Migrate.Autorest/custom/New-AzMigrateLocalServerReplication.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ https://learn.microsoft.com/powershell/module/az.migrate/new-azmigratelocalserve
#>
function New-AzMigrateLocalServerReplication {
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.IJobModel])]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.IJobModel])]
[CmdletBinding(DefaultParameterSetName = 'ByIdDefaultUser', PositionalBinding = $false, SupportsShouldProcess, ConfirmImpact = 'Medium')]
param(
[Parameter(ParameterSetName = 'ByIdDefaultUser', Mandatory)]
Expand Down Expand Up @@ -65,6 +65,14 @@ function New-AzMigrateLocalServerReplication {
# Specifies if RAM is dynamic or not.
${IsDynamicMemoryEnabled},

[Parameter()]
[ValidateSet("true" , "false")]
[ArgumentCompleter( { "true" , "false" })]
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]
[System.String]
# Specifies whether the VM should be migrated as an Arc VM.
${MigrateAsArcVM},

[Parameter()]
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]
[System.Int64]
Expand All @@ -73,13 +81,13 @@ function New-AzMigrateLocalServerReplication {

[Parameter(ParameterSetName = 'ByIdPowerUser', Mandatory)]
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.AzLocalDiskInput[]]
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.AzLocalDiskInput[]]
# Specifies the disks on the source server to be included for replication.
${DiskToInclude},

[Parameter(ParameterSetName = 'ByIdPowerUser', Mandatory)]
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.AzLocalNicInput[]]
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.AzLocalNicInput[]]
# Specifies the NICs on the source server to be included for replication.
${NicToInclude},

Expand Down Expand Up @@ -185,6 +193,10 @@ function New-AzMigrateLocalServerReplication {
if ($HasIsDynamicMemoryEnabled) {
$isDynamicRamEnabled = [System.Convert]::ToBoolean($IsDynamicMemoryEnabled)
}
$HasMigrateAsArcVM = $PSBoundParameters.ContainsKey('MigrateAsArcVM')
if ($HasMigrateAsArcVM) {
$migrateAsArcVMEnabled = [System.Convert]::ToBoolean($MigrateAsArcVM)
}
$HasTargetVMRam = $PSBoundParameters.ContainsKey('TargetVMRam')
$HasTargetVirtualSwitchId = $PSBoundParameters.ContainsKey('TargetVirtualSwitchId')
$HasTargetTestVirtualSwitchId = $PSBoundParameters.ContainsKey('TargetTestVirtualSwitchId')
Expand All @@ -198,6 +210,7 @@ function New-AzMigrateLocalServerReplication {
$null = $PSBoundParameters.Remove('TargetVirtualSwitchId')
$null = $PSBoundParameters.Remove('TargetTestVirtualSwitchId')
$null = $PSBoundParameters.Remove('IsDynamicMemoryEnabled')
$null = $PSBoundParameters.Remove('MigrateAsArcVM')
$null = $PSBoundParameters.Remove('TargetVMRam')
$null = $PSBoundParameters.Remove('DiskToInclude')
$null = $PSBoundParameters.Remove('NicToInclude')
Expand Down Expand Up @@ -633,16 +646,16 @@ function New-AzMigrateLocalServerReplication {
}

# Construct create protected item request object
$protectedItemProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.ProtectedItemModelProperties]::new()
$protectedItemProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.ProtectedItemModelProperties]::new()
$protectedItemProperties.PolicyName = $policyName
$protectedItemProperties.ReplicationExtensionName = $replicationExtensionName

if ($SiteType -eq $SiteTypes.HyperVSites) {
$customProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.HyperVToAzStackHCIProtectedItemModelCustomProperties]::new()
$customProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.HyperVToAzStackHciprotectedItemModelCustomProperties]::new()
$isSourceDynamicMemoryEnabled = $machine.IsDynamicMemoryEnabled
}
elseif ($SiteType -eq $SiteTypes.VMwareSites) {
$customProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.VMwareToAzStackHCIProtectedItemModelCustomProperties]::new()
$customProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.VMwareToAzStackHciprotectedItemModelCustomProperties]::new()
$isSourceDynamicMemoryEnabled = $false
}

Expand All @@ -658,6 +671,9 @@ function New-AzMigrateLocalServerReplication {
$customProperties.TargetResourceGroupId = $TargetResourceGroupId
$customProperties.TargetVMName = $TargetVMName
$customProperties.IsDynamicRam = if ($HasIsDynamicMemoryEnabled) { $isDynamicRamEnabled } else { $isSourceDynamicMemoryEnabled }
if ($HasMigrateAsArcVM) {
$customProperties.MigrateAsArcVM = $migrateAsArcVMEnabled
}

# Determine target VM Hyper-V Generation
if ($SiteType -eq $SiteTypes.HyperVSites) {
Expand Down Expand Up @@ -710,7 +726,7 @@ function New-AzMigrateLocalServerReplication {
}

# Construct default dynamic memory config
$memoryConfig = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.ProtectedItemDynamicMemoryConfig]::new()
$memoryConfig = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.ProtectedItemDynamicMemoryConfig]::new()
$memoryConfig.MinimumMemoryInMegaByte = [System.Math]::Min($customProperties.TargetMemoryInMegaByte, $RAMConfig.DefaultMinDynamicMemoryInMB)
$memoryConfig.MaximumMemoryInMegaByte = [System.Math]::Max($customProperties.TargetMemoryInMegaByte, $RAMConfig.DefaultMaxDynamicMemoryInMB)
$memoryConfig.TargetMemoryBufferPercentage = $RAMConfig.DefaultTargetMemoryBufferPercentage
Expand Down Expand Up @@ -835,12 +851,12 @@ function New-AzMigrateLocalServerReplication {
}

if ($SiteType -eq $SiteTypes.HyperVSites) {
$customProperties.DisksToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.HyperVToAzStackHCIDiskInput[]]$disks
$customProperties.NicsToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.HyperVToAzStackHCINicInput[]]$nics
$customProperties.DisksToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.HyperVToAzStackHcidiskInput[]]$disks
$customProperties.NicsToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.HyperVToAzStackHcinicInput[]]$nics
}
elseif ($SiteType -eq $SiteTypes.VMwareSites) {
$customProperties.DisksToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.VMwareToAzStackHCIDiskInput[]]$disks
$customProperties.NicsToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.VMwareToAzStackHCINicInput[]]$nics
$customProperties.DisksToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.VMwareToAzStackHcidiskInput[]]$disks
$customProperties.NicsToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.VMwareToAzStackHcinicInput[]]$nics
}

$protectedItemProperties.CustomProperty = $customProperties
Expand Down
2 changes: 1 addition & 1 deletion src/Migrate/Migrate.Autorest/custom/Remove-AzMigrateLocalServerReplication.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ https://learn.microsoft.com/powershell/module/az.migrate/remove-azmigratelocalse
#>
function Remove-AzMigrateLocalServerReplication {
[Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.PreviewMessageAttribute("This cmdlet is based on a preview API version and may experience breaking changes in future releases.")]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20240901.IJobModel])]
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20260201.IJobModel])]
[CmdletBinding(DefaultParameterSetName = 'ByID', PositionalBinding = $false, SupportsShouldProcess, ConfirmImpact='Medium')]
param(
[Parameter(ParameterSetName = 'ByID', Mandatory)]
Expand Down
Loading
Loading