Migrer Azure PowerShell d’AzureRM vers Azure

  • 7 minutes

Des scripts écrits pour des cmdlets AzureRM ne fonctionneront 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 chose aisée, mais il est important que de comprendre comment opérer la transition vers le module Az PowerShell.

Les nouveaux noms de cmdlets ont été conçus pour faciliter leur apprentissage. Au lieu d’utiliser AzureRm ou Azure dans les noms de cmdlets, vous utilisez Az. Par exemple, l’ancienne cmdlet New-AzureRMVm est devenue New-AzVm. Cependant, la migration ne consiste pas simplement à vous familiariser avec les nouveaux noms de cmdlets. Des modules et des paramètres ont été renommés, et il y a d’autres changements importants.

Avant d’effectuer toutes les étapes de migration, vérifiez 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 savoir quelles versions d’AzureRM doivent être désinstallées.

Pour vérifier quelles versions d’AzureRM sont installées, exécutez la commande suivante :

Get-Module -Name AzureRM -ListAvailable -All

Notes

La version disponible la plus récente d’AzureRM est 6.13.1. Si cette version n’est pas installée, vos scripts existants pourraient nécessiter des modifications supplémentaires pour fonctionner avec le module Az.

L’option recommandée pour migrer d’AzureRM vers le module Az PowerShell consiste à opérer une migration automatique. Pour cela, vous devez installer le kit de ressources de migration AzureRM vers Az en exécutant la commande suivante :

Install-Module -Name Az.Tools.Migration

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é.

Lecture supplémentaire : pour en savoir plus sur les étapes de migration automatique, consultez le Démarrage rapide : Migrer automatiquement des scripts PowerShell d’AzureRM vers le module Az PowerShell.

Vous pouvez également utiliser Microsoft Visual Studio Code pour migrer vos scripts existants. Pour ce faire, vous devez commencer par installer l’extension Azure PowerShell pour Visual Studio Code. Ensuite, vous devez procéder comme suit :

  1. Chargez votre script AzureRM dans Visual Studio Code.
  2. Ouvrez la palette de commandes en appuyant sur Ctrl+Maj+P.
  3. Sélectionnez le script Migrate Azure PowerShell.
  4. Sélectionnez la version source AzureRM.
  5. Suivez les actions recommandées pour les commandes ou paramètres soulignés.