Partager via

Présentation du module Az PowerShell

  • Article

Aperçu

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

Le module Az PowerShell est le remplacement d’AzureRM et est le module recommandé pour interagir avec Azure.

Avertissement

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

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

Vous pouvez utiliser le module Az PowerShell avec 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 jetons
    • 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 telles que 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
    • Peut obtenir et utiliser le jeton d’accès pour accéder aux ressources Azure
    • Applet de commande disponible pour les opérations REST avancées avec des ressources Azure

Remarque

PowerShell 7.2 ou version ultérieure est la version recommandée de PowerShell à utiliser avec le module Az PowerShell sur toutes les plateformes.

Le module Az PowerShell est basé 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 à apporter la prise en charge d’Azure à toutes les plateformes et tous les modules Az PowerShell sont des plateformes croisées.

Mettre à niveau votre environnement vers Az

Pour suivre les dernières fonctionnalités Azure de PowerShell, vous devez migrer vers le module Az. Si vous n’êtes pas prêt à installer le module Az en remplacement d’AzureRM, vous disposez de quelques options disponibles pour tester Az :

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

Pour effectuer une mise à niveau à partir d’une installation AzureRM existante :

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

Migrer des scripts existants d’AzureRM vers Az

Si vos scripts sont toujours basés sur le module AzureRM, nous avons plusieurs ressources pour vous aider à effectuer la migration :

Soutenabilité

Az est le module PowerShell le plus actuel pour Azure. Les problèmes ou les demandes de fonctionnalités peuvent être enregistrés directement sur le dépôt GitHub , ou via le support Microsoft si vous disposez d’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.

Étant donné que les modules Az PowerShell ont désormais toutes les fonctionnalités des modules PowerShell AzureRM et bien plus encore, nous avons déprécié les modules AzureRM PowerShell à compter du 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. Pour mettre à jour automatiquement vos scripts, suivez le guide de démarrage rapide .

Collecte de données

Azure PowerShell collecte les 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 afin d’identifier les problèmes courants et d’améliorer l’expérience d’Azure PowerShell. Microsoft Azure PowerShell ne collecte aucune donnée privée ou personnelle. Par exemple, les données d’utilisation permettent d’identifier les problèmes tels que les applets de commande avec une faible réussite et aident à hiérarchiser notre travail.

Bien que nous appréciions les insights que ces données fournissent, nous comprenons également que tout le monde ne veut pas envoyer des données d’utilisation. Vous pouvez désactiver la collecte de données avec l’applet de commande Disable-AzDataCollection. Vous pouvez également lire notre déclaration de confidentialité pour en savoir plus.