Présentation du module Az 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.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié 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.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

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

Remarque

Il est recommandé d’utiliser PowerShell 7.2 ou une version ultérieure avec le module Az PowerShell sur toutes les plateformes.

Le module Az PowerShell s’appuie sur la bibliothèque .NET Standard et fonctionne avec PowerShell 7.2 et versions ultérieures sur toutes les plateformes, notamment Windows, Linux et macOS. 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 Az PowerShell
  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.

Dans la mesure où les modules Az PowerShell proposent désormais toutes les fonctionnalités des modules AzureRM PowerShell et plus encore, les modules AzureRM PowerShell sont déconseillés depuis le 29 février 2024.

Pour éviter des interruptions de service, mettez à jour vos scripts qui utilisent les modules AzureRM PowerShell pour utiliser les modules Az PowerShell. 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.