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 cualquier uso continuado es bajo la 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:
PowerShell
Get-Module -Name AzureRM -ListAvailable
También puede realizar una búsqueda de texto completo en sus scripts para el patrón *-AzureRM*, con el fin de determinar si alguno está utilizando el módulo AzureRM de PowerShell.
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ó la AzureRM a Az migration toolkit.
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 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.
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:
PowerShell
Get-Module -Name AzureRM -ListAvailable -All
La versión más reciente disponible de AzureRM es 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 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.
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 obtener más información, consulte la documentación de referencia Enable-AzureRmAlias .
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 confíe en habilitar alias para que se encarguen de la migración por usted. Consulte la lista completa de cambios importantes para encontrar dónde pueden requerir actualizaciones los scripts.
La compatibilidad con Enable-AzureRmAlias no será discontinuada a pesar de la depreciación del módulo de PowerShell de AzureRM.
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios de Azure PowerShell
Azure PowerShell es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:
En este módulo se explica el entorno de Azure PowerShell y el módulo Az para Windows PowerShell. También se explica cómo administrar el identificador de Entra de Microsoft mediante módulos de PowerShell.