Leer en inglés

Compartir a través de


Migración de Azure PowerShell de AzureRM a Az

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo de Az PowerShell para garantizar la compatibilidad y las actualizaciones continuas.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, y cualquier uso continuado es bajo la discreción y riesgo del usuario. Consulte nuestros recursos de migración de para obtener instrucciones sobre la transición al módulo Az.

Determinar si usa el módulo de PowerShell de AzureRM

Use el siguiente comando para determinar si tiene instalado el módulo de PowerShell de AzureRM:

PowerShell
Get-Module -Name AzureRM -ListAvailable

También puede realizar una búsqueda de texto completo en sus scripts para el patrón *-AzureRM*, con el fin de determinar si alguno está utilizando el módulo AzureRM de PowerShell.

Actualización al módulo de Az PowerShell

Los scripts escritos para los cmdlets de AzureRM no funcionarán automáticamente con Az. Para facilitar la transición, se desarrolló la AzureRM a Az migration toolkit. No es conveniente realizar ninguna migración a un nuevo conjunto de comandos, pero este artículo le ayudará a empezar a realizar la transición al módulo Az de PowerShell. Para obtener más información sobre por qué se creó el módulo Az PowerShell, consulte Introducción al módulo Az de PowerShell.

Los nuevos nombres de cmdlet se han diseñado para ser fáciles de aprender. En lugar de usar AzureRm o Azure en nombres de cmdlet, use Az. Por ejemplo, el cmdlet antiguo New-AzureRMVm se ha convertido en New-AzVm. Sin embargo, la migración es más que familiarizarse con los nuevos nombres de cmdlet. Se han cambiado el nombre de módulos, parámetros y otros cambios importantes.

Para ver la lista completa de cambios importantes entre AzureRM y Az, consulte los cambios completos de AzureRM a Az.

Asegúrese de que los scripts existentes funcionan con la versión más reciente de AzureRM

Antes de realizar los pasos de migración, determine qué versiones de AzureRM están instaladas en el sistema. Esto le permite asegurarse de que los scripts ya se ejecutan en la versión más reciente y le permiten saber qué versiones de AzureRM deben desinstalarse.

Para determinar qué versiones de AzureRM ha instalado, ejecute el ejemplo siguiente:

PowerShell
Get-Module -Name AzureRM -ListAvailable -All

La versión más reciente disponible de AzureRM es 6.13.2. Si no tiene instalada esta versión, es posible que los scripts existentes necesiten modificaciones adicionales para trabajar con el módulo Az más allá del ámbito de lo que se describe en este artículo y en la lista de cambios importantes.

Si los scripts no funcionan con AzureRM 6.13.2, actualícelos según la guía de migración AzureRM 5.x a 6.x. Si usa una versión anterior del módulo AzureRM, hay guías de migración disponibles para cada versión principal.

Esta opción recomendada minimiza el esfuerzo necesario para migrar scripts de AzureRM a Az.

Con AzureRM to Az Migration Toolkit, puede generar un plan para determinar qué cambios se realizarán en los scripts antes de realizar modificaciones en ellos y antes de instalar el módulo Az PowerShell.

El guía de inicio rápido para migrar automáticamente scripts de PowerShell de AzureRM al módulo de Az PowerShell le guía por todo el proceso de actualización automática de sus scripts de PowerShell de AzureRM al módulo Az de PowerShell.

Opción 2: Usar el modo de compatibilidad con Enable-AzureRmAlias

El módulo Az tiene un modo de compatibilidad para ayudarle a usar scripts existentes mientras se actualiza a la nueva sintaxis. El cmdlet Enable-AzureRmAlias habilita un modo de compatibilidad a través de alias. Este modo le permite usar scripts existentes con una modificación mínima mientras trabaja para una migración completa a Az. De forma predeterminada, Enable-AzureRmAlias solo habilita los alias de compatibilidad para la sesión actual de PowerShell. Use su parámetro Scope para conservar los alias de compatibilidad entre sesiones de PowerShell. Para obtener más información, consulte la documentación de referencia Enable-AzureRmAlias .

Importante

Aunque los nombres de cmdlet están aliasados, es posible que todavía haya parámetros nuevos (o renombrados) o valores devueltos modificados para los cmdlets de Az. No confíe en habilitar alias para que se encarguen de la migración por usted. Consulte la lista completa de cambios importantes para encontrar dónde pueden requerir actualizaciones los scripts.

La compatibilidad con Enable-AzureRmAlias no será discontinuada a pesar de la depreciación del módulo de PowerShell de AzureRM.

Pasos siguientes