Migrer Azure PowerShell d’AzureRM vers Az
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell pour garantir une prise en charge et des mises à jour continues.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Reportez-vous à nos ressources de migration pour obtenir des conseils sur la transition vers le module Az.
Déterminer si vous utilisez le module AzureRM PowerShell
Utilisez la commande suivante pour déterminer si le module AzureRM PowerShell est installé :
Get-Module -Name AzureRM -ListAvailable
Vous pouvez également effectuer une recherche en texte intégral de vos scripts pour le modèle *-AzureRM* pour déterminer si l’un d’eux utilise le module AzureRM PowerShell.
Mettre à niveau vers le module Az PowerShell
Les scripts écrits pour les applets de commande AzureRM ne fonctionnent pas automatiquement avec Az. Pour faciliter la transition, la AzureRM vers Az migration toolkit a été développée. Aucune migration vers un nouveau jeu de commandes n’est jamais pratique, mais cet article vous aidera à commencer à passer au module Az PowerShell. Pour en savoir plus sur la raison pour laquelle le module Az PowerShell a été créé, consultez Présentation du module Az PowerShell.
Les nouveaux noms d’applet de commande ont été conçus pour être faciles à apprendre. Au lieu d’utiliser AzureRm ou Azure dans les noms d’applets de commande, utilisez Az. Par exemple, l’ancienne applet de commande New-AzureRMVm est devenue New-AzVm.
Toutefois, la migration est plus que de se familiariser avec les nouveaux noms d’applets de commande. Il existe des modules renommés, des paramètres et d’autres modifications importantes.
Pour obtenir la liste complète des changements cassants entre AzureRM et Az, consultez les Modifications entre AzureRM et Az.
Vérifier que les scripts existants fonctionnent avec la dernière version d’AzureRM
Avant de prendre des mesures de migration, déterminez les versions d’AzureRM installées sur votre système. Cela vous permet de vous assurer que les scripts sont déjà en cours d’exécution sur la dernière version et vous indiquez quelles versions d’AzureRM doivent être désinstallées.
Pour déterminer les versions d’AzureRM que vous avez installées, exécutez l’exemple suivant :
Get-Module -Name AzureRM -ListAvailable -All
La version la plus récente disponible d’AzureRM est 6.13.2. Si cette version n'est pas installée, vos scripts existants peuvent avoir besoin de modifications supplémentaires pour fonctionner avec le module Az, au-delà de ce qui est décrit dans cet article et dans la liste des modifications majeures
Si vos scripts ne fonctionnent pas avec AzureRM 6.13.2, mettez-les à jour en fonction du guide de migration AzureRM 5.x vers 6.x. Si vous utilisez une version antérieure du module AzureRM, il existe des guides de migration disponibles pour chaque version majeure.
Option 1 (recommandé) : migrer automatiquement vos scripts PowerShell
Cette option recommandée réduit l’effort nécessaire pour migrer des scripts AzureRM vers Az.
Avec le kit de ressources de migration AzureRM vers Az, vous pouvez générer un plan pour déterminer quelles modifications seront effectuées sur vos scripts avant d’y apporter des modifications et avant d’installer le module Az PowerShell.
Le guide de démarrage rapide Migrer automatiquement des scripts PowerShell d’AzureRM vers le module Az PowerShell vous guide tout au long du processus de mise à jour automatique de vos scripts PowerShell d’AzureRM vers le module Az PowerShell.
Option 2 : Utiliser le mode de compatibilité avec Enable-AzureRmAlias
Le module Az dispose d’un mode de compatibilité pour vous aider à utiliser des scripts existants lors de la mise à jour vers la nouvelle syntaxe. L’applet de commande Enable-AzureRmAlias active un mode de compatibilité via des alias. Ce mode vous permet d’utiliser des scripts existants avec une modification minimale tout en travaillant vers une migration complète vers Az. Par défaut, Enable-AzureRmAlias active uniquement les alias de compatibilité pour la session PowerShell actuelle. Utilisez son paramètre Scope pour conserver les alias de compatibilité entre les sessions PowerShell. Pour plus d’informations, consultez la documentation de référence Enable-AzureRmAlias.
Important
Même si les noms des applets de commande sont des alias, il peut y avoir de nouveaux paramètres (nouveaux ou renommés) ou des valeurs de retour qui ont changé pour les applets de commande Az. N’imaginez pas que l’activation des alias va prendre soin de la migration pour vous. Consultez la liste complète des changements majeurs pour identifier où vos scripts pourraient nécessiter une mise à jour.
La prise en charge de Enable-AzureRmAlias ne sera pas abandonnée, même après l'obsolescence du module AzureRM PowerShell.
