Présentation du module Az Azure PowerShell

  • Article

Vue d’ensemble

Le module Az PowerShell est un ensemble d’applets de commande qui permettent de gérer les ressources Azure directement dans PowerShell. PowerShell fournit des fonctionnalités d’automatisation puissantes qui peuvent être utilisées pour gérer vos ressources Azure, par exemple dans le contexte d’un pipeline CI/CD.

Le module Az PowerShell remplace le module AzureRM, et il est désormais 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.

Vous pouvez utiliser le module Az PowerShell à l’aide de l’une des méthodes suivantes :

Fonctionnalités

Le module Az PowerShell présente les avantages suivants :

  • Sécurité et stabilité
    • Chiffrement du cache de jeton
    • Prévention des attaques de type « Man-in-the-middle »
    • Prise en charge de l’authentification avec ADFS 2019
    • Authentification par nom d’utilisateur et mot de passe dans PowerShell 7
    • Prise en charge des fonctionnalités comme l’évaluation continue de l’accès
  • Prise en charge de tous les services Azure
    • Tous les services Azure en disponibilité générale ont un module PowerShell pris en charge correspondant
    • Plusieurs correctifs de bogues et mises à niveau de version d’API depuis AzureRM
  • Nouvelles fonctionnalités
    • Prise en charge dans Cloud Shell et prise en charge multiplateforme
    • Possibilité d’obtenir et d’utiliser un jeton d’accès pour accéder aux ressources Azure
    • Applet de commande disponible pour les opérations REST avancées avec les ressources Azure

Notes

PowerShell 7.0.6 LTS, PowerShell 7.1.3 ou ultérieur sont les versions recommandées de PowerShell pour être utilisées avec le module PowerShell Azure Az sur toutes les plateformes.

Le module Az PowerShell est basé sur la bibliothèque .NET Standard, et il fonctionne avec PowerShell 7 et versions ultérieures sur toutes les plateformes, notamment Windows, macOS et Linux. Il est également compatible avec Windows PowerShell 5.1.

Nous nous engageons à fournir une prise en charge Azure pour toutes les plateformes. L’intégralité des modules Az PowerShell sont multiplateformes.

Mettre à niveau votre environnement vers Az

Pour bénéficier des dernières fonctionnalités d’Azure dans PowerShell, vous devez effectuer une migration vers le module Az. Si vous n’êtes pas prêt à installer le module Az en remplacement d’AzureRM, vous disposez de deux des options pour faire des essais avec Az :

  • Utilisez un environnement PowerShell avec Azure Cloud Shell. Azure Cloud Shell est un environnement d’interpréteur de commandes basé sur un navigateur, qui est fourni avec le module Az installé et les alias de compatibilité Enable-AzureRM activés.
  • Conservez le module AzureRM qui est installé dans Windows PowerShell 5.1, et installez le module Az dans PowerShell 7 et versions ultérieures. Windows PowerShell 5.1 et PowerShell 7 (et versions ultérieures) utilisent des collections de modules distinctes. Suivez les instructions pour installer la dernière version de PowerShell, puis installez le module Az à partir de PowerShell 7 ou version ultérieure.

Pour mettre à niveau à partir d’une installation existante d’AzureRM :

  1. Désinstaller le module Azure PowerShell Azure RM
  2. Installer le module Azure PowerShell Az
  3. FACULTATIF : Activez le mode de compatibilité afin d’ajouter des alias pour les applets de commande AzureRM avec Enable-AzureRMAlias pendant la période où vous vous familiarisez avec le nouveau jeu de commandes. Pour plus d’informations, consultez la section suivante ou Démarrer la migration d’AzureRM vers Az.

Effectuer la migration des scripts existants d’AzureRM vers Az

Si vos scripts sont encore basés sur le module AzureRM, nous disposons de plusieurs ressources pour vous aider lors de la migration :

Prise en charge

Az est le module PowerShell le plus récent pour Azure. Vous pouvez signaler les problèmes et effectuer des demandes de fonctionnalités directement dans le dépôt GitHub ou via le support Microsoft si vous avez un contrat de support. Les demandes de fonctionnalités sont implémentées dans la dernière version d’Az. Les problèmes critiques sont implémentés dans les deux dernières versions d’Az.

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

Collecte de données

Azure PowerShell collecte des données de télémétrie par défaut. Microsoft agrège les données collectées pour identifier les modèles d’utilisation, identifier les problèmes courants et améliorer l’expérience Azure PowerShell. Microsoft Azure PowerShell ne collecte aucune donnée privée ou personnelle. Par exemple, les données d’utilisation permettent d’identifier des problèmes, tels que des applets de commande dont le niveau de réussite est faible, et nous aident à hiérarchiser notre travail.

Même si les informations que nous obtenons via ces données nous sont très utiles, nous comprenons tout à fait que tout le monde ne souhaite pas envoyer ses données d’utilisation. Vous pouvez désactiver la collecte de données à l’aide de l’applet de commande Disable-AzDataCollection. Vous pouvez également lire notre déclaration de confidentialité pour en savoir plus à ce sujet.