Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
Azure PowerShell est le nom du produit pour la collection de modules Microsoft PowerShell officiels pour la gestion des ressources Azure. Il nécessite PowerShell, un interpréteur de commandes et un langage de script.
Vous pouvez utiliser Azure PowerShell de manière interactive en exécutant des commandes à partir de PowerShell ou en créant et en exécutant des scripts composés de plusieurs commandes.
Module Az PowerShell
La version actuelle d’Azure PowerShell est le module Az PowerShell. Il s’agit du module PowerShell recommandé pour la gestion des ressources Azure avec PowerShell sur toutes les plateformes, notamment Windows, Linux et macOS. Il inclut des milliers de commandes qui contrôlent presque tous les aspects d’Azure. Le module Az PowerShell est multiplateforme.
Note
PowerShell 7 ou version ultérieure est la version recommandée de PowerShell à utiliser avec le module Az PowerShell. Il est également compatible avec Windows PowerShell 5.1.
Il existe quelques options différentes pour utiliser le module Az PowerShell :
- Azure Cloud Shell : interpréteur de commandes basé sur un navigateur qui vous permet d’exécuter des commandes Azure PowerShell sans installer quoi que ce soit sur votre ordinateur local.
- Installation locale : pour exécuter des commandes directement à partir de votre terminal, installez Azure PowerShell sur votre ordinateur local.
- Conteneur Docker : exécutez Azure PowerShell dans un conteneur Docker.
Authentication
Azure PowerShell prend en charge plusieurs méthodes d’authentification. Pour plus d’informations sur l’authentification auprès d’Azure à partir du module Az PowerShell, consultez Se connecter à Azure à partir d’Azure PowerShell.
Conception de module
Le module Az PowerShell est un module wrapper pour les modules PowerShell liés au service Azure, généralement un module par service Azure, tel que Az.Network pour les services de mise en réseau Azure et Az.Aks pour Azure Kubernetes Service.
Les applets de commande du module Az PowerShell effectuent des appels REST à l’API Azure Resource Manager. Les changements cassants dans le module Az PowerShell sont limités à deux fois par an. De nombreuses modifications cassants au niveau de l’API sont gérées dans les applets de commande pour empêcher la perception d’une modification cassante.
Le module Az PowerShell contient des applets de commande pour effectuer des opérations de plan de contrôle et de plan de données dans Azure. Vous utilisez le plan de contrôle pour gérer les ressources de votre abonnement. Vous utilisez le plan de données pour contrôler les fonctionnalités exposées par votre instance d’un type de ressource. Pour plus d’informations, consultez plan de contrôle Azure et plan de données.
Objets de sortie
Les applets de commande du module Az PowerShell produisent des objets .NET. Comme avec n’importe quelle commande PowerShell qui produit une sortie, les applets de commande du module Az PowerShell peuvent être redirigées vers l’applet Get-Member de commande pour déterminer le type d’objet généré, ainsi qu’une liste des propriétés et méthodes disponibles. Pour plus d’informations, consultez La sortie de requête d’Azure PowerShell et formater la sortie de l’applet de commande Azure PowerShell.
Module PowerShell AzPreview
Le module PowerShell AzPreview inclut tous les modules en disponibilité générale (GA) disponibles à partir du module Az PowerShell et tous les modules en préversion pour la gestion des ressources Azure. Il n’est pas recommandé d’utiliser dans les environnements de production, car les modules en préversion ne respectent pas les stratégies de modification cassants.
Le module AzPreview est toujours la même version et est publié en même temps que le module Az PowerShell.
Module PowerShell AzureRM
Bien que vous trouviez des exemples en ligne qui utilisent le module AzureRM PowerShell, il s’agit de la génération précédente d’Azure PowerShell. Elle est déconseillée, n’est plus gérée ou prise en charge, et n’est pas recommandée. Les commandes du module AzureRM PowerShell utilisent le *-AzureRM* format. Pour plus d’informations, consultez Vue d’ensemble du module AzureRM PowerShell.
Module Azure PowerShell
Vous pouvez également rencontrer une version d’Azure PowerShell nommée le module Azure PowerShell. Ce module est destiné à gérer les ressources Azure héritées qui utilisent des API Azure Service Manager (ASM). Il n’est pas recommandé de créer de nouvelles ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez Vue d’ensemble du module Gestion des services Azure PowerShell.
Modules PowerShell liés à Azure
Ces produits sont utilisés pour gérer les ressources Azure, mais ne font pas partie du produit collectif Azure PowerShell. Ils ne doivent jamais être décrits à l’aide du nom collectif « Azure PowerShell ».
- Azure Active Directory PowerShell (AzureAD)
- Azure Information Protection PowerShell
- Azure Deployment Manager PowerShell
- Travaux de base de données élastique Azure PowerShell
- Azure Service Fabric PowerShell
- Azure Stack PowerShell
- Microsoft.Graph PowerShell
- Microsoft.Graph.Entra PowerShell
- MSOnline PowerShell
Guidelines
- Utilisez toujours le nom complet du produit ou le nom de module PowerShell spécifique