Compartir vía

Presentación del módulo Az PowerShell

A partir de diciembre de 2018, el módulo Az PowerShell se encuentra en versión general y ahora es el módulo de PowerShell previsto para interactuar con Azure. Az ofrece comandos más cortos, estabilidad mejorada y compatibilidad multiplataforma. Az también tiene paridad de características con AzureRM, lo que le proporciona una ruta de migración sencilla.

Con el módulo Az, Azure PowerShell ahora es compatible con PowerShell 5.1 en Windows y PowerShell Core 6.x y versiones posteriores en todas las plataformas compatibles, incluidas Windows, Linux y macOS.

Az es un nuevo módulo, por lo que la versión se ha restablecido a la versión 1.0.0.

¿Por qué un nuevo módulo?

Las actualizaciones principales pueden ser poco convenientes, por lo que es importante que le hagamos saber por qué se tomó la decisión de introducir un nuevo conjunto de módulos, con nuevos cmdlets, para interactuar con Azure desde PowerShell.

El cambio más importante y más importante es que PowerShell ha sido un producto multiplataforma desde la introducción de PowerShell, basado en la biblioteca de .NET Standard. Nos comprometemos a incorporar compatibilidad con Azure a todas las plataformas, lo que significa que los módulos de Azure PowerShell deben actualizarse para usar .NET Standard y ser compatibles con PowerShell Core. En lugar de tomar el módulo AzureRM existente e introducir cambios complejos para agregar esta compatibilidad, se creó el módulo Az.

La creación de un nuevo módulo también dio a nuestros ingenieros la oportunidad de hacer coherente el diseño y la nomenclatura de cmdlets y módulos. Ahora todos los módulos comienzan con el Az. prefijo y los cmdlets usan la forma verbo-Aznombre. Anteriormente, los nombres de los cmdlets no solo eran más largos, sino que había incoherencias en sus nombres.

El número de módulos también se ha reducido: algunos módulos que funcionaban con los mismos servicios se han combinado, y los cmdlets del plano de administración y del plano de datos ahora se han integrado en módulos únicos de sus servicios. Para aquellos que administran manualmente las dependencias y las importaciones, esto lo hace mucho más sencillo.

Al realizar estos cambios importantes que requerían la creación de un nuevo módulo de Azure PowerShell, el equipo se ha comprometido a hacerlo más fácil que nunca y en más plataformas que antes para utilizar Azure con cmdlets de PowerShell.

Actualización a Az

Para mantenerse al día con las características más recientes de Azure en PowerShell, debe migrar al módulo Az lo antes posible. Si no está listo para instalar el módulo Az como sustituto de AzureRM, tiene un par de opciones disponibles para experimentar con Az:

  • Usar un entorno de PowerShell con Azure Cloud Shell. Azure Cloud Shell es un entorno de shell basado en navegador con el módulo Az instalado y los alias de compatibilidad Enable-AzureRM habilitados.
  • Mantenga instalado el módulo AzureRM con PowerShell 5.1 para Windows, pero instale el módulo Az para PowerShell Core 6.x o posterior. PowerShell 5.1 para Windows y PowerShell Core usan colecciones independientes de módulos. Siga las instrucciones para instalar PowerShell Core y, a continuación, instale el módulo Az desde un terminal de PowerShell Core.

Para actualizar desde una instalación existente de AzureRM:

  1. Desinstalación del módulo AzureRM de Azure PowerShell
  2. instalación del módulo Az PowerShell
  3. OPCIONAL: Habilite el modo de compatibilidad para agregar alias a los cmdlets de AzureRM con Enable-AzureRMAlias mientras se familiariza con el nuevo conjunto de comandos. Consulte la sección siguiente o Inicie la migración desde AzureRM a Az para más información.

Migración de scripts existentes a Az

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 comando New-AzureRMVm anterior se ha convertido en New-AzVm. La migración es más que familiarizarse con los nuevos nombres de cmdlet; hay módulos renombrados, parámetros modificados y otros cambios importantes.

Para ayudarle con el proceso de migración de AzureRM a Az, tenemos varios recursos:

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, para que pueda usar scripts existentes con una modificación mínima mientras trabaja para realizar una migración completa a Az.

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 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.

Compatibilidad con AzureRM

Dado que los módulos de Az PowerShell ahora tienen todas las funcionalidades de los módulos de PowerShell de AzureRM y mucho más, retiraremos los módulos de PowerShell de AzureRM el 29 de febrero de 2024.

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