Migrer Azure PowerShell depuis AzureRM vers Az

Avertissement

Le module AzureRM PowerShell est officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus géré ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Déterminez si vous utilisez le module AzureRM PowerShell

Utilisez la commande suivante pour déterminer si vous avez le module AzureRM PowerShell installé :

Get-Module -Name AzureRM -ListAvailable

Vous pouvez également effectuer une recherche en texte intégral dans vos scripts à la recherche du modèle *-AzureRM* pour déterminer si l’un d’eux utilise le module AzureRM PowerShell.

Mise à jour vers le module 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 module Az PowerShell.

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.

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.

La prise en charge de Enable-AzureRmAlias ne sera pas dépréciée avec la dépréciation du module AzureRM PowerShell.

Étapes suivantes