Presentación del nuevo módulo Az de Azure PowerShellIntroducing the new Azure PowerShell Az module

A partir de diciembre de 2018, el módulo Az de Azure PowerShell está disponible de forma general y, ahora, es el módulo de PowerShell que se espera usar para interactuar con Azure.Starting in December 2018, the Azure PowerShell Az module is in general release and now the intended PowerShell module for interacting with Azure. Az ofrece comandos más cortos, mayor estabilidad y compatibilidad multiplataforma.Az offers shorter commands, improved stability, and cross-platform support. Az también tiene paridad de características con AzureRM, lo que le proporciona una ruta de migración sencilla.Az also has feature parity with AzureRM, giving you an easy migration path.

Con el módulo Az, ahora Azure PowerShell es compatible con PowerShell 5.1 en Windows y PowerShell Core 6.x y versiones posteriores en todas las plataformas admitidas, incluidas Windows, macOS y Linux.With the Az module, Azure PowerShell is now compatible with PowerShell 5.1 on Windows and PowerShell Core 6.x and later on all supported platforms - including Windows, macOS, and Linux.

Az es un nuevo módulo, por lo que la versión se ha restablecido a 1.0.0.Az is a new module, so the version has been reset to 1.0.0.

¿Por qué un nuevo módulo?Why a new module?

Las actualizaciones importantes pueden ser un problema, por lo que es importante que sepa por qué se tomó la decisión de introducir un nuevo conjunto de módulos, con nuevos cmdlets, para interactuar con Azure desde PowerShell.Major updates can be inconvenient, so it's important that we let you know why the decision was made to introduce a new set of modules, with new cmdlets, for interacting with Azure from PowerShell.

El cambio mayor y más importante es que PowerShell ha sido un producto multiplataforma desde la introducción de PowerShell Core 6.x, que se basa en la biblioteca .NET Standard.The biggest and most important change is that PowerShell has been a cross-platform product since the introduction of PowerShell Core 6.x, based on the .NET Standard library. Nuestro compromiso es que Azure sea compatible con todas las plataformas, lo que significa que los módulos de Azure PowerShell debían actualizarse para usar .NET Standard y ser compatibles con PowerShell Core.We're committed to bringing Azure support to all platforms, which means that the Azure PowerShell modules needed to be updated to use .NET Standard and be compatible with PowerShell Core. En lugar de tomar el módulo AzureRM existente e introducir cambios complejos para agregar esta compatibilidad, se ha creado el módulo Az.Rather than taking the existing AzureRM module and introduce complex changes to add this support, the Az module was created.

La creación de un nuevo módulo también dio a nuestros ingenieros la oportunidad de hacer coherentes el diseño y la nomenclatura de cmdlets y módulos.Creating a new module also gave our engineers the opportunity to make the design and naming of cmdlets and modules consistent. Ahora todos los módulos comienzan con el prefijo Az. y todos los cmdlets utilizan la forma verbo-Azsustantivo.All modules now start with the Az. prefix and cmdlets all use the Verb-AzNoun form. Anteriormente, los nombres de los cmdlets no solo eran más largos, sino que había incoherencias en sus nombres.Previously, cmdlet names were not only longer, there were inconsistencies in cmdlet names.

También se ha reducido el número de módulos: se han agrupado algunos módulos que trabajaban con los mismos servicios y los cmdlets del plano de administración y del plano de datos ahora se encuentran dentro de módulos únicos para sus servicios.The number of modules was also reduced: Some modules which worked with the same services have been rolled together, and management plane and data plane cmdlets are now contained all within single modules for their services. Para aquellos que administran manualmente las dependencias y las importaciones, esto facilita las cosas.For those of you who manually manage dependencies and imports, this makes things much simpler.

Al realizar estas modificaciones importantes que requieren la creación de un nuevo módulo de Azure PowerShell, el equipo se ha comprometido a que el uso de Azure con cmdlets de PowerShell sea más fácil que nunca y en más plataformas que en las que antes era posible.By making these important changes that required building a new Azure PowerShell module, the team has committed to making it easier than ever, and on more platforms than previously possible, to use Azure with PowerShell cmdlets.

Actualización a AzUpgrade to Az

Para disponer de las características más recientes de Azure en PowerShell, se debe migrar al módulo Az tan pronto como sea posible.To keep up with the latest Azure features in PowerShell, you should migrate to the Az module as soon as possible. Si no está listo para instalar el módulo Az como sustituto de AzureRM, tiene un par de opciones disponibles para experimentar con Az:If you're not ready to install the Az module as a replacement for AzureRM, you have a couple of options available to experiment with Az:

  • Usar un entorno de PowerShell con Azure Cloud Shell.Use a PowerShell environment with Azure Cloud Shell. Azure Cloud Shell es un entorno de shell basado en explorador que viene con el módulo Az instalado y los alias de compatibilidad Enable-AzureRM habilitados.Azure Cloud Shell is a browser-based shell environment which comes with the Az module installed and Enable-AzureRM compatibility aliases enabled.
  • Puede mantener el módulo AzureRM instalado con PowerShell 5.1 para Windows y en cambio instalar el módulo Az para PowerShell Core 6.x o posterior.Keep the AzureRM module installed with PowerShell 5.1 for Windows, but install the Az module for PowerShell Core 6.x or later. PowerShell 5.1 para Windows y PowerShell Core utilizan colecciones de módulos independientes.PowerShell 5.1 for Windows and PowerShell Core use separate collections of modules. Siga las instrucciones para instalar PowerShell Core y, a continuación, instale el módulo Az desde un terminal de PowerShell Core.Follow the instructions to install PowerShell Core and then install the Az module from a PowerShell Core terminal.

Para actualizar desde una instalación existente de AzureRM:To upgrade from an existing AzureRM install:

  1. Desinstale el módulo AzureRM de Azure PowerShellUninstall the Azure PowerShell AzureRM module
  2. Instale el módulo Az de Azure PowerShellInstall the Azure PowerShell Az module
  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.OPTIONAL: Enable compatibility mode to add aliases for AzureRM cmdlets with Enable-AzureRMAlias while you become familiar with the new command set. Consulte la sección siguiente o inicie la migración de AzureRM a Az para obtener más información.See the next section or Start migration from AzureRM to Az for more details.

Migración de los scripts existentes a AzMigrate existing scripts to Az

Los nuevos nombres de cmdlet se han diseñado para ser fáciles de aprender.The new cmdlet names have been designed to be easy to learn. En lugar de usar AzureRm o Azure en los nombres de cmdlet, use Az.Instead of using AzureRm or Azure in cmdlet names, use Az. Por ejemplo, el comando anterior New-AzureRMVm se ha convertido en New-AzVm.For example, the old command New-AzureRMVm has become New-AzVm. La migración es algo más que familiarizarse con los nuevos nombres de cmdlet, se ha cambiado el nombre de los módulos y parámetros, además de otros cambios importantes.Migration is more than just becoming familiar with the new cmdlet names, though: There are renamed modules, parameters, and other important changes.

Para ayudarle con el proceso de migración de AzureRM a Az, disponemos de diversos recursos:To help you with the process of migration from AzureRM to Az, we've got a number of resources:

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.The Az module has a compatibility mode to help you use existing scripts while you update to the new syntax. El cmdlet Enable-AzureRmAlias habilita un modo de compatibilidad mediante alias, para que pueda usar los scripts existentes con una mínima modificación, mientras se trabaja hacia una migración completa a Az.The Enable-AzureRmAlias cmdlet enables a compatibility mode through aliases, to allow you to use existing scripts with minimal modification while working towards a full migration to Az.

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.Even though the cmdlet names are aliased, there may still be new (or renamed) parameters or changed return values for the Az cmdlets. No espere que, al habilitar los alias, la migración se realice automáticamente.Don't expect enabling aliases to take care of the migration for you! Consulte la lista completa de cambios importantes para encontrar los scripts que pueden requerir actualizaciones.See the full breaking changes list to find where your scripts may require updates.

Soporte técnico continuo para AzureRMContinued support for AzureRM

AzureRM ya no recibirá nuevos cmdlets ni características.AzureRM will no longer receive new cmdlets or features. Sin embargo, el módulo AzureRM recibirá mantenimiento oficial y correcciones de errores hasta diciembre de 2020.However, the AzureRM module is still officially maintained and will get bug fixes through December 2020.