Installer le module PowerShell Azure Az

Cet article explique comment installer le module PowerShell Azure Az à partir de PowerShell Gallery. Ces instructions s’appliquent aux plateformes Windows, Linux et macOS.

Le module PowerShell Azure Az est préinstallé dans Azure Cloud Shell et dans les images Docker.

Le module PowerShell Azure Az est un module cumulatif. Son installation télécharge tous les modules Az PowerShell en disponibilité générale et permet d’utiliser leurs applets de commande.

Spécifications

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.

Azure PowerShell ne présente aucune spécification supplémentaire quand il est exécuté sur PowerShell 7.0.6 LTS et PowerShell 7.1.3 ou ultérieur.

Pour vérifier votre version de PowerShell, exécutez la commande suivante à partir d’une session PowerShell :

$PSVersionTable.PSVersion

La stratégie d’exécution de script PowerShell doit être définie sur Signée à distance ou Moins restrictive. Get-ExecutionPolicy -List peut être utilisée pour déterminer la stratégie d’exécution actuelle. Pour plus d’informations, consultez about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Installation

L’utilisation de l’applet de commande Install-Module est la méthode d’installation par défaut pour le module PowerShell Az. Installez le module Az pour l’utilisateur actuel uniquement. Il s’agit de la portée d’installation recommandée. Cette méthode fonctionne de la même façon sur les plateformes Windows, Linux et macOS. Exécutez la commande suivante à partir d’une session PowerShell :

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Autres options d’installation

Même si PowerShell 7.0.6 LTS et PowerShell 7.1.3 ou ultérieur sont les versions recommandées de PowerShell et que Install-Module est l’option d’installation recommandée, il existe d’autres options d’installation si besoin.

Installation sur Windows PowerShell

Important

Si le module AzureRM PowerShell est installé, consultez Coexistence d’Az et d’AzureRM avant de poursuivre.

Le module PowerShell Azure Az est également pris en charge pour être utilisé avec PowerShell 5.1 sur Windows. Pour utiliser le module PowerShell Azure Az dans PowerShell 5.1 sur Windows :

  1. Effectuez une mise à jour vers Windows PowerShell 5.1. Si vous êtes sur Windows 10 version 1607 ou ultérieure, PowerShell 5.1 est déjà installé.
  2. Installez .NET Framework 4.7.2 ou ultérieur.
  3. Veillez à disposer de la dernière version de PowerShellGet. Exécutez Install-Module -Name PowerShellGet -Force.

Installation hors connexion

Dans certains environnements, il n’est pas possible de se connecter à PowerShell Gallery. Dans ce cas, vous pouvez installer le module Az de PowerShell hors connexion à l’aide de l’une des méthodes suivantes :

  • Téléchargez le MSI d’Azure PowerShell. N’oubliez pas que le programme d’installation MSI ne fonctionne que pour PowerShell 5.1 sur Windows.
  • Téléchargez les modules à un autre emplacement de votre réseau, puis utilisez ce dernier comme source d’installation. Cette méthode vous permet de mettre en cache les modules PowerShell sur un serveur ou partage de fichiers unique à déployer avec PowerShellGet sur tout système déconnecté. Découvrez comment configurer un dépôt local et l’installer sur des systèmes déconnectés en consultant Utilisation de dépôts PowerShellGet locaux.
  • Enregistrez le module avec Save-module dans un partage de fichiers, ou enregistrez-le dans une autre source et copiez-le manuellement sur d’autres ordinateurs.

Se connecter

Pour commencer à utiliser Azure PowerShell, connectez-vous à l’aide de vos informations d’identification Azure.

Connect-AzAccount

Après avoir exécuté cette commande, une nouvelle fenêtre de navigateur apparaît à partir de laquelle vous pouvez vous connecter à votre compte Azure.

Mise à jour du module Azure PowerShell

Pour mettre à jour un module PowerShell, vous devez utiliser la même méthode que celle utilisée pour installer le module. Par exemple, si vous avez utilisé Install-Module au départ, vous devez utiliser Update-Module pour obtenir la version la plus récente. Si vous avez utilisé le package MSI, vous devez télécharger et installer le nouveau package MSI.

Les applets de commande PowerShellGet ne peuvent pas mettre à jour les modules qui ont été installés à partir d’un package MSI. Les packages MSI ne mettent pas à jour les modules qui ont été installés avec PowerShellGet. Si vous rencontrez des problèmes lors de la mise à jour avec PowerShellGet, vous devez réinstaller plutôt que de mettre à jour. Procédez de la même manière pour la réinstallation que pour l’installation. Veillez à utiliser le paramètre Force avec Install-Module lors de la réinstallation.

Contrairement aux installations basées sur MSI, l’installation ou la mise à jour avec PowerShellGet ne supprime pas les versions antérieures qui peuvent se trouver sur votre système.

Notes

La désinstallation peut être compliquée si plusieurs versions du module Az PowerShell sont installées. En raison de cette complexité, nous prenons uniquement en charge la désinstallation de toutes les versions du module Az PowerShell installées.

Pour supprimer toutes les versions du module Az PowerShell de votre système, consultez Désinstaller le module Azure PowerShell. Pour plus d’informations sur les installations basées sur MSI, consultez Installer Azure PowerShell avec un fichier MSI.

Dépannage

Résolvez les problèmes d’installation du module Azure Az PowerShell.

Fournir des commentaires

Si vous rencontrez un bogue dans le module PowerShell Azure Az, signalez un problème sur GitHub. Pour fournir des commentaires à partir d’une session PowerShell, utilisez l’applet de commande Send-Feedback.

Étapes suivantes

Pour en savoir plus sur les modules PowerShell Azure Az et leurs fonctionnalités, consultez Bien démarrer avec Azure PowerShell. Si vous êtes familiarisé avec Azure PowerShell et devez effectuer une migration depuis AzureRM, consultez l’article sur la migration d’AzureRM vers Az.