Migración de Azure PowerShell de AzureRM a Az
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo de Az PowerShell para garantizar la compatibilidad y las actualizaciones continuas.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, y el uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración de para obtener instrucciones sobre la transición al módulo 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 completa de texto en sus scripts para el patrón *-AzureRM* para determinar si alguno de ellos usa el módulo de PowerShell 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 ha desarrollado 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 obtener más información sobre por qué se creó el módulo Az PowerShell, consulte 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 nombres de cmdlet, use Az. Por ejemplo, el cmdlet antiguo New-AzureRMVm se ha convertido en New-AzVm.
Sin embargo, la migración implica más que solo 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 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 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, 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, actualícelos según la guía de migración 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.
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 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 parámetro Scope para conservar los alias de compatibilidad entre sesiones de PowerShell. Para más información, consulte la documentación de referencia de Enable-AzureRmAlias.
Importante
Aunque los nombres de cmdlet están aliasados, es posible que todavía haya parámetros nuevos (o cambiados de nombre) o se hayan modificado los valores devueltos 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.
La compatibilidad con Enable-AzureRmAlias no quedará en desuso con la descontinuación del módulo de PowerShell de AzureRM.
