Installer Azure PowerShell sur Windows

  • Article

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

La méthode d’installation et la version PowerShell recommandées pour le module Az PowerShell sont :

  • Installer à partir de PowerShell Gallery
  • Utiliser avec PowerShell version 7 ou supérieure

Cet article explique comment installer le module Az PowerShell sur Windows à partir de PowerShell Gallery.

Prérequis

  • Exécutez la commande suivante à partir de PowerShell pour déterminer votre version de PowerShell :

    $PSVersionTable.PSVersion

  • Déterminez si vous avez le module AzureRM PowerShell installé :

    Get-Module -Name AzureRM -ListAvailable

    Important

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

  • Définissez la stratégie d’exécution de PowerShell sur Signée à distance ou Moins restrictive

    • Vérifiez la stratégie d’exécution de PowerShell :

      Get-ExecutionPolicy -List

    • Définissez la stratégie d’exécution PowerShell sur Signée à distance :

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Pour plus d’informations sur les stratégies d’exécution, consultez about_Execution_Policies.

Installation

Utilisez l’applet de commande Install-Module pour installer le module Az PowerShell :

Install-Module -Name Az -Repository PSGallery -Force

Utiliser le module Az PowerShell

Utilisez Update-Module pour effectuer une mise à jour vers la dernière version du module Az PowerShell :

Update-Module -Name Az -Force

La mise à jour du module Az PowerShell avec Update-Module ne supprime pas les anciennes versions du module Az PowerShell de votre système.

Désinstallation

Pour supprimer le module Az PowerShell, consultez Désinstaller le module Azure PowerShell.

Cet article explique comment installer le module Az PowerShell sur Windows avec un programme d’installation MSI. Le programme d’installation MSI est fourni pour les environnements dans lesquels PowerShell Gallery risque d’être bloqué par un pare-feu ou quand un programme d’installation hors connexion est nécessaire.

Important

L’option d’installation MSI peut être utilisée pour installer le module Az PowerShell et l’utiliser avec Windows PowerShell 5.1 seulement.

Prérequis

  • Exécutez la commande suivante à partir de PowerShell pour déterminer votre version de PowerShell :

    $PSVersionTable.PSVersion

  • Déterminez si vous avez installé le module AzureRM PowerShell

    Get-Module -Name AzureRM -ListAvailable

    Important

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

  • Effectuez une mise à jour vers Windows PowerShell 5.1

  • Installez .NET Framework 4.7.2 ou ultérieur

  • Définissez l’exécution de script PowerShell sur Signée à distance ou Moins restrictive

    • Vérifiez la stratégie d’exécution de PowerShell :

      Get-ExecutionPolicy -List

    • Définissez la stratégie d’exécution PowerShell sur Signée à distance :

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Pour plus d’informations sur les stratégies d’exécution, consultez about_Execution_Policies.

Installation et mise à jour

Le package MSI pour Azure PowerShell est disponible dans GitHub :

  1. Visitez github.com/Azure/azure-powershell/releases
  2. Recherchez le module Az PowerShell le plus récent. Ils sont listés par ordre chronologique sans nom. Par exemple : 9.5.0
  3. Faites défiler les notes de correctif jusqu’à la fin et cliquez sur la flèche à côté de « Ressources » pour voir les options MSI.
  4. Cliquez sur le MSI Az-Cmdlets de votre choix pour démarrer le téléchargement

Le programme d’installation supprime automatiquement les anciennes versions du module Az PowerShell qui ont été installées avec un MSI. Le package MSI installe les modules dans "${env:ProgramFiles}\WindowsPowerShell\Modules"

Se connecter

Pour commencer à gérer vos ressources Azure avec le module Az PowerShell, lancez une session PowerShell et exécutez Connect-AzAccount pour vous connecter à Azure :

Connect-AzAccount

Utilisez les informations d’identification de connexion de votre compte Azure pour vous connecter dans la fenêtre de navigateur qui s’ouvre.

Vous devez répéter cette étape pour chaque nouvelle session PowerShell que vous démarrez. Pour savoir comment conserver votre connexion Azure sur plusieurs sessions PowerShell, consultez Objets de contexte Azure PowerShell.

Résolution des problèmes

Pour obtenir des solutions aux problèmes d’installation courants liés au module Az PowerShell, consultez Résoudre les problèmes d’installation du module Az PowerShell.

Fournir des commentaires

Pour signaler un problème concernant le module Az PowerShell, consultez : Signaler 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 la gestion de vos ressources Azure avec le module Az PowerShell, consultez Bien démarrer avec Azure PowerShell.