Migración de Azure PowerShell de AzureRM a 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:

Get-Module -Name AzureRM -ListAvailable

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

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ó el kit de herramientas de migración de AzureRM a Az . 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 más información sobre por qué se creó el módulo Az PowerShell, consulte Introducción al módulo Az 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 New-AzureRMVm anterior 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:

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

Opción 1 (recomendada): migre automáticamente los scripts de PowerShell.

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 quickstart de migración automática de scripts de PowerShell de AzureRM al módulo Az PowerShell le guía a través de todo el proceso de actualizar automáticamente sus scripts de PowerShell de AzureRM al módulo Az 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 Scope parámetro para conservar los alias de compatibilidad entre sesiones de PowerShell. Para obtener más información, consulte la documentación de referencia de Enable-AzureRmAlias.

Enable-AzureRmAlias no perderá compatibilidad con la retirada del soporte para el módulo de PowerShell de AzureRM.

Pasos siguientes

• Migración automática de scripts de PowerShell
• Presentación del módulo Az PowerShell
• Cambios entre AzureRM y Az
• Instalación del módulo de Az PowerShell
• Desinstalación de AzureRM