Partager via

Installer le Azure CLI sur Windows

L’interface de Azure Command-Line (CLI) est un outil en ligne de commande multiplateforme qui peut être installé localement sur Windows ordinateurs. Vous pouvez utiliser le Azure CLI pour Windows pour vous connecter à Azure et exécuter des commandes d’administration sur des ressources Azure. Le Azure CLI peut également être utilisé à partir d’un navigateur via le Azure Cloud Shell ou exécuté à partir d’un conteneur Docker.

Pour Windows, le Azure CLI est installé via un package MSI ou ZIP, ce qui vous donne accès au Azure CLI via PowerShell ou à l’invite de commandes Windows (cmd.exe). Lorsque vous effectuez une installation pour Sous-système Windows pour Linux (WSL), les packages sont disponibles pour votre distribution Linux. Consultez la page d’installation principale pour obtenir la liste des gestionnaires de paquets pris en charge ou pour savoir comment installer manuellement sous WSL (le sous-système Windows pour Linux).

La version actuelle du Azure CLI est 2.84.0. Pour plus d’informations sur la version la plus récente, consultez les Notes de publication. Pour connaître la version que vous avez installée et savoir si elle nécessite d’être mise à jour, exécutez az version.

Installer ou mettre à jour

Les fichiers MSI et ZIP distribuables sont utilisés pour installer ou mettre à jour le Azure CLI sur Windows. Vous n'avez pas besoin de désinstaller les versions actuelles avant d'utiliser le programme d'installation MSI car le MSI met à jour toute version existante.

Importante

Une fois l’installation terminée, vous devez close et rouvrir toute fenêtre de terminal active pour utiliser le Azure CLI.

WinGet (Windows Gestionnaire de package)

Utilisez WinGet, gestionnaire de package microsoft pour Windows, pour installer et gérer les mises à jour pour Azure CLI. Par défaut, Winget installe les Azure CLI 64 bits sur les systèmes d’exploitation 64 bits.

Remarque

WinGet est disponible par défaut dans les versions Windows 11 et modernes de Windows 10. Toutefois, il se peut qu’il ne soit pas installé dans les versions antérieures de Windows. Consultez la documentation de winget pour des instructions d’installation.

winget install --exact --id Microsoft.AzureCLI

L’option --exact consiste à vérifier que le package de Azure CLI officiel est installé. Cette commande installe la dernière version par défaut. Pour spécifier une version, ajoutez a avec la version souhaitée à la commande. Voici un exemple :

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

Microsoft Installer (MSI)

Version la plus récente

Téléchargez et installez la dernière version du Azure CLI. Lorsque le programme d'installation vous demande s'il peut apporter des modifications à votre ordinateur, cochez la case "Oui".

Msi la plus ancienne du Azure CLI (32 bits)

Le MSI le plus récent de l'Azure CLI (64 bits)

Si vous avez déjà installé le Azure CLI, l’exécution de l’interface MSI 32 bits ou 64 bits remplace une installation existante.

Version spécifique

Si vous préférez, vous pouvez télécharger une version spécifique du Azure CLI à l’aide d’une URL.

Pour télécharger le programme d’installation MSI pour une version spécifique, modifiez le segment de version dans l’URL (32 bits) ou (64 bits).

Par exemple, pour installer le MSI 32 bits de Azure CLI version 2.51.0, votre URL est https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. L'installation 64 bits correspondante serait .

Les versions Azure CLI disponibles sont disponibles dans Azure CLI notes de publication. Le MSI 64 bits est disponible à partir de la version 2.51.0.

Microsoft Installer (MSI) avec PowerShell

Pour installer le Azure CLI à l’aide de PowerShell, démarrez PowerShell aadministrateur et exécutez la commande suivante :

$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi
Start-Process msiexec.exe -Wait -ArgumentList '/I', 'AzureCLI.msi', '/quiet'
Remove-Item .\AzureCLI.msi

Cette opération télécharge et installe le dernier programme d’installation 32 bits de l’Azure CLI pour Windows. Si vous préférez une installation 64 bits, remplacez l'URL par . Si la Azure CLI est déjà installée, le programme d’installation remplace la version existante.

Pour installer une version spécifique, remplacez l’argument par l’URL décrite dans la section suivante. Voici un exemple d’utilisation du programme d’installation 32 bits de la version Azure CLI 2.51.0 dans PowerShell :

$ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi
Start-Process msiexec.exe -Wait -ArgumentList '/I', 'AzureCLI.msi', '/quiet'
Remove-Item .\AzureCLI.msi

Version spécifique

Pour télécharger le programme d’installation MSI pour une version spécifique, modifiez le segment de version dans l’URL (32 bits) ou (64 bits).

Par exemple, pour installer le MSI 32 bits de Azure CLI version 2.51.0, votre URL est https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. L'installation 64 bits correspondante serait .

Les versions Azure CLI disponibles sont disponibles dans Azure CLI notes de publication. Le MSI 64 bits est disponible à partir de la version 2.51.0.

Différences de syntaxe entre Bash et PowerShell

Bien que la plupart Azure CLI documentation soit écrite et testée dans un interpréteur de commandes Bash, vous pouvez également installer et exécuter le Azure CLI à l’aide de PowerShell. Il y a des différences de syntaxe subtiles entre Bash et PowerShell. Passez en revue ces articles pour éviter les erreurs de script :

Lors de l’exécution de l’Azure CLI dans PowerShell, il y a également des différences dans la gestion des erreurs et la possibilité d’activer l’auto-complétion. Pour plus d’informations, consultez ces articles :

Paquet ZIP

Importante

Ce package est actuellement en préversion.

Vous pouvez utiliser le package ZIP pour installer le Azure CLI sur Windows. Ce package est utile lorsque vous n’avez pas de privilèges d’administration.

Décompressez le package dans un dossier, puis en utilisant Cmd ou PowerShell, appelez le Azure CLI en exécutant <unzipped folder path>\bin\az.cmd.

Si vous souhaitez exécuter directement la commande az, suivez les étapes ci-dessous pour ajouter le Azure CLI à votre variable d’environnement PATH.

  1. Ouvrez le menu Démarrer et recherchez . Cliquez sur .
  2. Cliquez sur le bouton .
  3. Dans la zone, sélectionnez et cliquez sur le bouton.
  4. Cliquez sur le bouton et ajoutez-le à la liste.
  5. Redémarrez votre terminal. Vous devriez maintenant être en mesure d'exécuter les commandes .

Version la plus récente

Dernier fichier ZIP de l'Azure CLI (64 bits)

Version spécifique

Si vous préférez, vous pouvez télécharger une version spécifique du Azure CLI à l’aide d’une URL.

Pour télécharger le package ZIP pour une version spécifique, modifiez le segment de version dans l’URL .

Par exemple, pour installer le fichier ZIP 64 bits de Azure CLI version 2.57.0, votre URL est https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

Les versions Azure CLI disponibles sont disponibles dans Azure CLI notes de publication. Le package ZIP est disponible à partir de la version 2.57.0. Seule la version 64 bits est disponible.

Exécutez le Azure CLI

Après l’installation, fermez et rouvrez toute fenêtre de terminal active. Exécutez le Azure CLI avec la commande az à partir de PowerShell ou de l’invite de commandes Windows.

Avant de pouvoir exécuter des commandes Azure CLI, vous devez vous connecter à Azure. Pour vous connecter de manière interactive, utilisez . Pour plus d’informations sur l’authentification, consultez Sign into Azure avec Azure CLI.

az login

Une première étape courante consiste à vérifier votre abonnement actif.

az account show

Résolution des problèmes liés à l’installation

Voici quelques problèmes courants rencontrés lors de l’installation du Azure CLI sur Windows. Si vous rencontrez un problème non abordé ici, fichier un problème sur GitHub.

Variable PATH non définie

La cause la plus courante de ce problème n’est pas le redémarrage de la fenêtre de terminal active après l’installation. Fermez et rouvrez toute fenêtre de terminal active.

Le proxy bloque la connexion

Si vous ne pouvez pas télécharger le programme d’installation MSI, car votre proxy bloque la connexion, vérifiez que votre proxy est configuré. Pour Windows 11, ces paramètres sont gérés dans le volet Settings > Network & Internet > Proxy. Contactez votre administrateur système pour les paramètres requis, ou pour les situations où votre machine peut être gérée par la configuration ou nécessite une configuration avancée.

Importante

Ces paramètres sont également nécessaires pour pouvoir accéder aux services Azure avec le Azure CLI, à partir de PowerShell ou de l’invite de commandes. Dans PowerShell, vous effectuez cette configuration avec la commande suivante :

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Pour obtenir la msi, votre proxy doit autoriser les connexions HTTPS aux adresses suivantes :

  • https://aka.ms/
  • https://azcliprod.blob.core.windows.net/

Pour plus d’informations, consultez Work behind a proxy dans le guide de résolution des problèmes Azure CLI.

Des temps de réponse lent

Consultez Migrer vers Azure CLI 64 bits

Activer la saisie semi-automatique des onglets dans PowerShell

La complétion par tabulation, également appelée « compléteurs Azure CLI », fournit une complétion sur les entrées pour donner des indications, faciliter la découverte et accélérer la saisie. Les noms de commandes, les noms de groupes de commandes, les paramètres et certaines valeurs de paramètres peuvent être automatiquement saisis dans la ligne de commande en appuyant sur la touche Tab.

La saisie semi-automatique via la touche Tab est activée par défaut dans Azure Cloud Shell et dans la plupart des distributions Linux. À partir de la version 2.49 d'Azure CLI, vous pouvez activer la saisie semi-automatique pour Azure CLI dans PowerShell. Suivez ces étapes :

  1. Créez ou modifiez le profil stocké dans la variable . Le plus simple consiste à exécuter dans PowerShell. Pour plus d’informations, consultez Création de votre profil et Profils et stratégie d’exécution.

  2. Ajoutez le code suivant à votre profil PowerShell :

    Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
    $completion_file = New-TemporaryFile
    $env:ARGCOMPLETE_USE_TEMPFILES = 1
    $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
    $env:COMP_LINE = $wordToComplete
    $env:COMP_POINT = $cursorPosition
    $env:_ARGCOMPLETE = 1
    $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
    $env:_ARGCOMPLETE_IFS = "`n"
    $env:_ARGCOMPLETE_SHELL = 'powershell'
    az 2>&1 | Out-Null
    Get-Content $completion_file | Sort-Object | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
    }
    Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
}

  3. Pour afficher toutes les options disponibles dans le menu, ajoutez à votre profil PowerShell.

Mettre à jour le Azure CLI

À compter de la version 2.11.0, le Azure CLI fournit une commande dans l’outil pour effectuer une mise à jour vers la dernière version.

az upgrade

Cette commande met également à jour toutes les extensions installées par défaut. Pour plus d’options , consultez la page de référence des commandes. Pour les versions Azure CLI antérieures à 2.11.0, mettez à jour en réinstallant comme décrit dans Installer le Azure CLI.

Si vous utilisez la distribution ZIP, supprimez l’ancien dossier d’installation et extrayez la nouvelle version au même emplacement.

Migrer vers l'Azure CLI 64 bits

À partir de la version 2.51.0, Azure CLI fournit également une msi 64 bits, qui est recommandée pour de meilleures performances.

Procédez comme suit pour migrer vers la version 64 bits de Azure CLI :

  1. Vérifiez votre version Azure CLI actuelle et les extensions installées en exécutant az --version.
  2. Les extensions nécessitent une réinstallation. Sauvegardez le dossier d’extension actuel en le renommant au cas où vous décidez de revenir à la version 32 bits. Ce dossier est créé automatiquement lorsque vous réinstallez une extension.
  3. Téléchargez et installez le dernier programme d’installation 64 bits, comme décrit dans Installer ou mettre à jour. Le MSI 32 bits est automatiquement désinstallé.
  4. Installez les extensions en exécutant . Si vous ne souhaitez pas réinstaller manuellement les extensions, la Azure CLI vous invite à installer une extension lors de la première utilisation. Pour plus d'informations sur l'installation des extensions, consultez Comment installer des extensions.

Si vous rencontrez des problèmes après la migration, vous pouvez désinstaller la version 64 bits et réinstaller le MSI 32 bits. Si vous avez effectué une sauvegarde de votre dossier d’extensions 32 bits, restaurez ou renommez votre dossier d’extension après la modification.

Désinstaller

Si vous décidez de désinstaller le Azure CLI, nous sommes désolés de vous voir aller. Avant de la désinstaller, utilisez la commande pour nous dire ce qui pourrait être amélioré ou révisé. Notre objectif est de rendre les Azure CLI sans bogues et conviviales. Si vous avez trouvé un bogue, nous l'apprécierions si vous fichier un problème de GitHub.

Vous désinstallez les Azure CLI de la liste Windows « Applications et fonctionnalités ». Pour désinstaller :

Plate-forme Les instructions
Windows 11 Démarrer Paramètres Applications Applications installées
Windows 10 Démarrer Paramètres Applications Applications et fonctionnalités
Windows 8 et Windows 7 Démarrer > Panneau de configuration > Programmes > Désinstaller un programme

Une fois sur cet écran, tapez Azure CLI dans la barre de recherche du programme. Le programme à désinstaller est répertorié comme Microsoft CLI 2.0 pour Azure. Sélectionnez cette application, puis sélectionnez le bouton .

Supprimer les données

Si vous ne prévoyez pas de réinstaller Azure CLI, supprimez ses données de C:\Users\<username>\.azure\msal_token_cache.bin ou C:\Users\<username>\.azure\msal_token_cache.json.

Étapes suivantes

Maintenant que vous avez installé le Azure CLI sur Windows, découvrez les différentes façons de vous connecter.

Sign in with Azure CLI

  • Last updated on