Información general acerca del módulo PowerShell Az.Tools.Migration

El módulo Az.Tools.Migration de PowerShell facilita la transición del módulo AzureRM anterior al módulo Az más reciente, que se recomienda para la administración de Azure.

Importante

El módulo AzureRM PowerShell está en desuso desde el 29 de febrero de 2024.

Microsoft introdujo Az.Tools.Migration en respuesta a los comentarios de los clientes, especialmente en relación con el esfuerzo necesario para actualizar los scripts escritos originalmente para AzureRM. Reconociendo que muchos clientes han invertido en crear scripts complejos para entornos de Azure, Az.Tools.Migration se ha creado para simplificar y automatizar el proceso de migración, lo que reduce la carga de trabajo manual y el potencial de error durante las actualizaciones de scripts.

Uso del módulo Az.Tools.Migration

El proceso de uso Az.Tools.Migration implica varios pasos:

1. Actualización a la versión 6.13.1 de AzureRM: antes de usar Az.Tools.Migration, los usuarios deben asegurarse de que sus scripts se actualizan a la versión 6.13.1 de AzureRM , la última versión antes de la migración al módulo Az .

2. Instalación de Az.Tools.Migration: el módulo se puede instalar desde la Galería de PowerShell con el Install-Module -Name Az.Tools.Migration comando .

3. Generación de un plan de actualización: el New-AzUpgradeModulePlan cmdlet genera un plan de actualización. No cambia los scripts existentes, pero proporciona una ruta de actualización mediante la creación de un plan que detalla archivos específicos y puntos de desplazamiento que requieren actualizaciones. Este cmdlet toma parámetros como FilePath y DirectoryPath para tener como destino scripts o carpetas específicos.

4. Revisar el plan de actualización: antes de ejecutar la actualización, es fundamental revisar el plan para detectar posibles problemas que puedan evitar actualizaciones automáticas, como los comandos que usan la expansión y corregirlos manualmente si es necesario.

5. Realización de la actualización: Después de revisar y resolver cualquier problema, la actualización real se realiza mediante el cmdlet Invoke-AzUpgradeModulePlan. Este cmdlet puede modificar archivos existentes o, de forma más segura, guardar los cambios en los nuevos archivos con _az_upgraded anexados a sus nombres para conservar los scripts originales.

Para garantizar una migración sin problemas, se recomienda realizar copias de seguridad de scripts antes de realizar actualizaciones, ya que el cmdlet Invoke-AzUpgradeModulePlan puede ser destructivo si no se usa con la opción -FileEditMode SaveChangesToNewFiles.

Se recomienda a los usuarios proporcionar comentarios o notificar problemas con el proceso de migración en el repositorio de GitHub para azure-powershell-migration.