Migración de Azure PowerShell de AzureRM a Az

  • Artículo
  • Tiempo de lectura: 5 minutos

Todas las versiones del módulo AzureRM de PowerShell están obsoletas. El módulo Az de PowerShell es el módulo de PowerShell que se recomienda ahora para interactuar con Azure.

Precaución

Como los módulos de Az PowerShell ya tienen todas las funcionalidades de los de AzureRM PowerShell, incluso más, el 29 de febrero de 2024 se van a retirar estos últimos.

Para evitar interrupciones del servicio, actualice los scripts que usan los módulos de AzureRM PowerShell para que utilicen los de Az PowerShell antes del 29 de febrero de 2024. Para actualizar automáticamente los scripts, siga la guía de inicio rápido.

¿Por qué un nuevo módulo?

El cambio más importante es que, desde su introducción, PowerShell ha sido un producto multiplataforma que se basa en la biblioteca .NET Standard.

Al igual que con el lenguaje de PowerShell, estamos comprometidos a ofrecer soporte técnico de Azure en todas las plataformas. Esto significa que los módulos de Azure PowerShell necesitan actualizarse para usar .NET Standard y ser compatibles con PowerShell Core. En lugar de tomar el módulo AzureRM existente y realizar cambios complejos para incorporar esta compatibilidad, se ha creado el módulo Az.

La creación de un nuevo módulo también permitió a nuestros ingenieros aportar coherencia al diseño y la nomenclatura de los cmdlets y módulos. Ahora, todos los módulos comienzan con el prefijo Az. y todos los cmdlets utilizan la convención de nomenclatura Verb-AzNoun. Anteriormente, los nombres de los cmdlets eran más largos e incoherentes.

También se ha reducido el número de módulos: Se han combinado algunos módulos que funcionaban con los mismos servicios. Los cmdlets del plano de administración y del plano de datos del mismo servicio ahora están incluidos en un único módulo. Para aquellos que administran manualmente las dependencias y las importaciones, esta consolidación facilita las cosas.

Con estos importantes cambios, el objetivo del equipo es que el uso de Azure con los cmdlets de PowerShell sea más fácil que nunca, y en más plataformas que nunca.

Actualización al módulo Az de 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 más información sobre por qué se ha creado el módulo Az de PowerShell, consulte Presentación del nuevo módulo Az de Azure 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.

Instalación del kit de herramientas de migración de AzureRM a Az

Install-Module -Name Az.Tools.Migration

Conversión automática de los scripts

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.

Opción 3: Migrar los scripts en Visual Studio Code con la extensión de Azure PowerShell

Instalación de la extensión de Azure PowerShell para Visual Studio Code

Instale la extensión de Azure PowerShell para VSCode

Conversión manual de los scripts

  1. Cargue el script de AzureRM en VSCode.
  2. Abra la paleta de comandos Ctrl+Shift+P y seleccione Migrate Azure PowerShell script para iniciar la migración.
  3. Seleccione la versión de origen AzureRM.
  4. Siga las acciones recomendadas para cada comando o parámetro subrayado.

Pasos siguientes