Migrer Azure PowerShell depuis AzureRM vers Az

  • Article

Toutes les versions du module AzureRM PowerShell sont obsolètes. Le module Az PowerShell est maintenant le module PowerShell qui est recommandé pour interagir avec Azure.

Attention

Étant donné que les modules Az PowerShell ont maintenant toutes les fonctionnalités des modules AzureRM PowerShell et plus encore, nous allons mettre hors service les modules AzureRM PowerShell le 29 février 2024.

Pour éviter les interruptions de service, mettez à jour vos scripts qui utilisent les modules AzureRM PowerShell pour utiliser les modules Az PowerShell avant le 29 février 2024. Pour mettre à jour automatiquement vos scripts, suivez le Guide de démarrage rapide.

Pourquoi un nouveau module ?

Le plus gros changement, et aussi le plus important, est que PowerShell, étant basé sur la bibliothèque .NET Standard, a toujours été un produit multiplateforme depuis le début.

Tout comme pour le langage PowerShell, nous nous engageons à fournir la prise en charge d’Azure sur toutes les plateformes. Notre engagement consistait à mettre à jour les modules Azure PowerShell de sorte qu’ils utilisent .NET Standard et soient compatibles avec PowerShell Core. Au lieu d’apporter des modifications complexes au module AzureRM existant en vue d’ajouter cette prise en charge, nous avons créé le module Az.

La création d’un module a également permis à nos ingénieurs de mettre en cohérence la conception, ainsi que le nommage des applets de commande et des modules. Les noms de tous les modules commencent désormais par le préfixe Az. et les applets de commande utilisent toutes la convention de nommage Verb-AzNoun. Auparavant, les noms d’applets de commande étaient plus longs et incohérents.

Le nombre de modules a également été réduit : Certains modules qui fonctionnaient avec les mêmes services ont été fusionnés. Les applets de commande de plan de gestion et de plan de données d’un même service sont désormais contenues dans un même module. Pour ceux d’entre vous qui gèrent manuellement les dépendances et les importations, cette fusion rend les choses beaucoup plus simples.

En effectuant ces importantes modifications, l’équipe s’est attachée à rendre plus facile que jamais, et sur plus de plateformes qu’auparavant, l’utilisation d’Azure avec des applets de commande PowerShell.

Mise à niveau vers Az PowerShell

Les scripts écrits pour les applets de commande AzureRM ne fonctionnent pas automatiquement avec le module Az. Pour faciliter la transition, nous avons créé un kit de migration pour passer d’AzureRM à Az. La migration vers un nouveau jeu de commandes n’est jamais facile, cependant, cet article vous aidera à bien démarrer la transition vers le module Az PowerShell. Pour savoir pourquoi le module Az PowerShell a été créé, consultez Présentation du nouveau module Azure PowerShell Az.

Les nouveaux noms de cmdlets ont été conçus pour être facile à apprendre. Plutôt que d’utiliser AzureRm ou Azure dans les noms de cmdlets, utilisez Az. Par exemple, l’ancienne applet de commande New-AzureRMVm est devenue New-AzVm. Toutefois, la migration ne consiste pas simplement à vous familiariser avec les nouveaux noms des applets de commande. Des modules et des paramètres ont été renommés, et il y a d’autres changements importants.

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 d’effectuer les étapes de migration, déterminez les versions d’AzureRM installées sur votre système. Vous pouvez ainsi vérifier que les scripts s’exécutent déjà sur la dernière version et connaître les versions d’AzureRM qui 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 disponible la plus récente d’AzureRM est 6.13.2. Si cette version n’est pas installée, il est possible que vos scripts existants nécessitent des modifications supplémentaires pour fonctionner avec le module Az. Ces modifications ne sont pas expliquées dans cet article ni dans la liste des changements cassants.

Si vos scripts ne fonctionnent pas avec AzureRM 6.13.2, mettez-les à jour conformément au Guide de migration d’AzureRM 5.x vers 6.x. Si vous utilisez une version antérieure du module AzureRM, consultez les guides de migration disponibles pour chaque version majeure.

Cette option recommandée réduit les efforts nécessaires à la migration des scripts AzureRM vers Az.

Installer le kit de migration pour passer d’AzureRM à Az

Install-Module -Name Az.Tools.Migration

Convertir automatiquement vos scripts

Le kit de migration pour passer d’AzureRM à Az vous permet de générer un plan dans le but de connaître les modifications qui seront apportées à vos scripts avant qu’elles ne le soient, et avant que le module Az PowerShell ne soit installé.

Le guide de démarrage rapide Effectuer une migration automatique des scripts PowerShell entre le module AzureRM et le module Az PowerShell vous guide tout au long du processus de mise à jour automatique de vos scripts PowerShell entre le module AzureRM et le module Az PowerShell.

Option n°2 : Utiliser le mode de compatibilité avec Enable-AzureRmAlias

Le module Az a un mode de compatibilité pour vous aider à utiliser des scripts existants quand vous faites la mise à jour vers la nouvelle syntaxe. L’applet de commande Enable-AzureRmAlias active un mode de compatibilité par le biais des alias. Ce mode vous permet d’utiliser les scripts existants avec très peu de modifications, tout en préparant votre migration complète vers Az. Par défaut, Enable-AzureRmAlias active uniquement les alias de compatibilité pour la session PowerShell active. Utilisez son paramètre Scope pour conserver les alias de compatibilité d’une session PowerShell à l’autre. Pour plus d’informations, consultez la documentation de référence sur Enable-AzureRmAlias.

Important

Même si les noms des applets de commande sont associés à des alias, il peut néanmoins y avoir de nouveaux paramètres (ou des paramètres renommés) ou des changements dans les valeurs retournées 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 cassants pour voir où vos scripts peuvent nécessiter des mises à jour.

Option 3 : Effectuer la migration de vos scripts dans Visual Studio Code avec l’extension Azure PowerShell

Installer l’extension Azure PowerShell pour Visual Studio Code

Installez l’extension Azure PowerShell pour Visual Studio Code.

Convertir vos scripts manuellement

  1. Chargez votre script AzureRM dans VSCode.
  2. Démarrez la migration en ouvrant la palette de commandes Ctrl+Shift+P, puis sélectionnez Migrate Azure PowerShell script.
  3. Sélectionnez la version de source AzureRM.
  4. Suivez les actions recommandées pour les commandes ou paramètres soulignés.

Étapes suivantes