Trying to migrate from AzureRM to Az and the New-AzUpgradeModulePlan command doesn't do anything

Question

I've used this command

New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 9.3.0 -FilePath 'C:\test\templateCreateResources.ps1' -OutVariable Plan

to try to migrate from AzureRM to Az as stated in the documentation but nothing is happening.

The Az Migration module in installed.

I've checked my current AzureRM version and it's the right one.

The file contains AzureRM commandlets so there is definitely stuff to migrate in there.

I can't find what could the problem be here since there's in no error.

Answer 1

Hello BarbaraO,

Thank you for your question and for reaching out with your question today.

When migrating from AzureRM to Az, I recommend that you use the ConvertTo-Az cmdlets provided by the Az Migration module. The New-AzUpgradeModulePlan cmdlet is part of the migration process, but it doesn't automatically convert your existing AzureRM scripts to Az. The New-AzUpgradeModulePlan cmdlet is used to plan the migration process and generate a report, but it doesn't perform the actual conversion. The ConvertTo-Az cmdlets are responsible for the migration itself. You need to follow the additional steps listed below to complete the actual migration:

1. Ensure that you have the Az Migration module installed. You can install it using the following powershell command:

Install-Module -Name Az.Migration

2. Import the module into your PowerShell session:

Import-Module Az.Migration

3. Use the ConvertTo-Az cmdlets to convert your AzureRM scripts to Az. You need to provide the input file containing your AzureRM script and specify the output file for the converted script:

ConvertTo-Az -InputFile 'C:\test\templateCreateResources.ps1' -OutputFile 'C:\test\convertedScript.ps1'

This command will analyze your AzureRM script and convert AzureRM cmdlets to their equivalent Az cmdlets. It will create a new script with the converted code.

4. After the conversion, review the converted script to ensure that everything has been migrated correctly. Pay special attention to any AzureRM-specific features that may require adjustments in the converted script.
5. Execute the converted script using PowerShell. Ensure that it works as expected and performs the necessary Azure operations.

If the reply was helpful, please don’t forget to upvote or accept as answer.