Migración de Azure PowerShell de AzureRM a Az

  • Artículo

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Determinar si usa el módulo de AzureRM PowerShell

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

Get-Module -Name AzureRM -ListAvailable

También puede realizar una búsqueda de texto completo de los scripts para el patrón *-AzureRM* si desea determinar si alguno de ellos usa el módulo de AzureRM PowerShell.

Actualización del módulo Az PowerShell

Los scripts escritos para los cmdlets de AzureRM no funcionan automáticamente con Az. Para facilitar la transición, se ha desarrollado el kit de herramientas de migración de AzureRM a Az. Migrar a un nuevo conjunto de comandos nunca resulta práctico, pero este artículo le ayudará a empezar a trabajar en la transición al nuevo módulo Az de PowerShell. Para obtener más información sobre por qué se ha creado el módulo Az PowerShell, consulta 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 los nombres de cmdlet, use Az. Por ejemplo, el antiguo comando New-AzureRMVm se ha convertido en New-AzVm. Sin embargo, la migración requiere algo más que familiarizarse con los nuevos nombres de los cmdlets. se ha cambiado el nombre de los módulos y parámetros, además de otros cambios importantes.

Para ver la lista completa de los 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 llevar a cabo los pasos de la migración, determine qué versiones de AzureRM están instaladas en el sistema. Así podrá asegurarse de que ya se están ejecutando las últimas versiones de los scripts y sabrá qué versiones de AzureRM se pueden desinstalar.

Para determinar qué versiones de AzureRM tiene instaladas, ejecute el ejemplo siguiente:

Get-Module -Name AzureRM -ListAvailable -All

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

Si los scripts no funcionan con AzureRM 6.13.2, debe actualizarlos según la Guía de migración de 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 los scripts de AzureRM a Az.

Con el kit de herramientas de migración de AzureRM a Az, 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 de PowerShell.

La guía de inicio rápido Migración automática de scripts de PowerShell de AzureRM al módulo Az de PowerShell le guía en todo el proceso de actualización automática de los scripts de PowerShell desde 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 que le ayudará a usar los scripts existentes mientras trabaja en las actualizaciones a la nueva sintaxis. El cmdlet Enable-AzureRmAlias habilita un modo de compatibilidad mediante alias. Este modo permite usar los scripts existentes con una modificación mínima mientras se trabaja con 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 las sesiones de PowerShell. Para más información, consulte la documentación de referencia de Enable-AzureRmAlias.

Importante

Aunque los nombres de cmdlet son un alias, puede haber nuevos parámetros (o con un nombre nuevo) o haber cambiado el valor de retorno de los cmdlets de Az. No espere que, al habilitar los alias, la migración se realice automáticamente. Consulte la lista completa de cambios importantes para encontrar los scripts que pueden requerir actualizaciones.

La compatibilidad con Enable-AzureRmAlias no estará en desuso con el desuso del módulo de PowerShell de AzureRM.

Pasos siguientes