Vue d’ensemble du module PowerShell Az.Tools.Migration

  • Article

Le module PowerShell Az.Tools.Migration facilite la transition de l’ancien module AzureRM vers le module Az plus récent qui est recommandé pour la gestion Azure.

Important

Le module PowerShell AzureRM est obsolète depuis le 29 février 2024.

Microsoft a introduit Az.Tools.Migration en réponse aux commentaires des clients, en particulier sur le travail nécessaire pour mettre à jour les scripts écrits à l’origine pour AzureRM. Conscients des efforts investis par de nombreux clients dans la création de scripts complexes pour les environnements Azure, nous avons créé Az.Tools.Migration pour simplifier et automatiser le processus de migration, réduisant ainsi la charge de travail manuelle et le risque d’erreur lors des mises à niveau des scripts.

Comment utiliser le module Az.Tools.Migration

Le processus d’utilisation d’Az.Tools.Migration implique plusieurs étapes :

  1. Mise à jour vers AzureRM version 6.13.1 : avant d’utiliser Az.Tools.Migration, les utilisateurs doivent s’assurer que leurs scripts sont mis à jour vers la dernière version d’AzureRM, à savoir la version 6.13.1, avant de procéder à la migration vers le module Az.

  2. Installation d’Az.Tools.Migration : vous pouvez installer le module à partir de PowerShell Gallery avec la commande Install-Module -Name Az.Tools.Migration.

  3. Génération d’un plan de mise à niveau : la cmdlet New-AzUpgradeModulePlan génère un plan de mise à niveau. Elle ne modifie pas les scripts existants, mais fournit un chemin de mise à niveau en créant un plan qui détaille les fichiers spécifiques et les points de décalage nécessitant des mises à jour. Cette cmdlet utilise des paramètres tels que FilePath et DirectoryPath pour cibler des scripts ou des dossiers spécifiques.

  4. Examen du plan de mise à niveau : avant d’exécuter la mise à niveau, il est indispensable de passer en revue le plan pour détecter tout problème potentiel susceptible d’empêcher les mises à niveau automatiques, notamment les commandes utilisant la projection (« splatting »), et de les corriger manuellement si nécessaire.

  5. Exécution de la mise à niveau : après avoir passé en revue et résolu les problèmes, la mise à niveau proprement dite est effectuée à l’aide de la cmdlet Invoke-AzUpgradeModulePlan. Cette cmdlet peut modifier des fichiers existants ou, de manière moins risquée, enregistrer les modifications apportées aux nouveaux fichiers en ajoutant _az_upgraded à leur nom pour préserver les scripts d’origine.

Pour garantir une migration fluide, il est recommandé de sauvegarder les scripts avant d’effectuer des mises à niveau, car la cmdlet Invoke-AzUpgradeModulePlan peut être destructrice si elle n’est pas utilisée avec l’option -FileEditMode SaveChangesToNewFiles.

Les utilisateurs sont encouragés à fournir des commentaires ou à signaler les problèmes liés au processus de migration sur le référentiel GitHub pour azure-powershell-migration.