Installer Azure CLI sur Windows

Article
08/19/2024

L’interface de ligne de commande Azure (Azure CLI) est un outil en ligne de commande multiplateforme que vous pouvez installer localement sur des ordinateurs Windows. Vous pouvez utiliser Azure CLI pour Windows pour vous connecter à Azure et exécuter des commandes d’administration sur des ressources Azure. Vous pouvez aussi l’utiliser à partir d’un navigateur par le biais d’Azure Cloud Shell ou l’exécuter à partir d’un conteneur Docker.

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

La version actuelle d’Azure CLI est 2.68.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.

Installation ou mise à jour

Les fichiers MSI et ZIP distribuables sont utilisés pour installer ou mettre à jour 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.

Important

Une fois l’installation terminée, vous devez fermer et rouvrir toutes les fenêtres de terminal actives pour pouvoir utiliser Azure CLI.

WinGet (Gestionnaire de package Windows)

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

Notes

WinGet est disponible par défaut dans les versions Windows 11 et modernes de Windows 10. Par contre, il est peut-être préférable de ne pas l’installer dans les versions antérieures de Windows. Consultez la documentation de winget pour des instructions d’installation.

winget install -e --id Microsoft.AzureCLI

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

winget install -e --id Microsoft.AzureCLI -v 2.66.0

Microsoft Installer (MSI)

Version la plus récente

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

Msi la plus récente d’Azure CLI (32 bits)

Msi la plus récente d’Azure CLI (64 bits)

Si vous avez déjà installé Azure CLI, l'exécution du MSI 32 bits ou 64 bits écrasera une installation existante.

Version spécifique

Si vous préférez, vous pouvez télécharger une version spécifique d’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 https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32 bits) ou https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 bits).

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

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

Microsoft Installer (MSI) avec PowerShell

Pour installer Azure CLI avec PowerShell, démarrez PowerShell en tant qu’administrateur 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

Cela téléchargera et installera le dernier programme d'installation 32 bits d'Azure CLI pour Windows. Si vous préférez une installation 64 bits, remplacez l'URL par https://aka.ms/installazurecliwindowsx64. Si Azure CLI est déjà installé, le programme d'installation écrasera la version existante.

Pour installer une version spécifique, remplacez l’argument -Uri par l’URL décrite dans la section suivante. Voici un exemple d'utilisation du programme d'installation 32 bits d'Azure CLI version 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

Les versions disponibles d'Azure CLI sont disponibles dans les notes de publication d'Azure CLI. 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 de la documentation Azure CLI soit écrite et testée dans un interpréteur de commandes Bash, vous pouvez également installer et exécuter Azure CLI avec 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 :

Considérations relatives à l’exécution d’Azure CLI dans un langage de script PowerShell
Utiliser des guillemets dans les paramètres Azure CLI
Comparer la syntaxe de Bash, PowerShell et Cmd.exe dans Les différences de syntaxe Azure CLI dans Bash, PowerShell et Cmd

Lors de l’exécution d’Azure CLI dans PowerShell, il existe également des différences de gestion des erreurs et la possibilité d’activer la saisie semi-automatique via la touche Tab. Pour plus d’informations, consultez ces articles :

Gestion des erreurs pour Azure CLI dans PowerShell
Activation de l'achèvement par tabulation pour l'Azure CLI dans PowerShell

ZIP Package

Important

Ce package est actuellement en préversion.

Vous pouvez utiliser le package ZIP pour installer 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 Azure CLI en exécutant <unzipped folder path>\bin\az.cmd.

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

Ouvrez le menu Démarrer et recherchez environment variables. Cliquez sur Edit the system environment variables.
Cliquez sur le bouton Environment Variables....
Dans la User varibles for <username> zone, sélectionnez Path et cliquez sur le Edit... bouton.
Cliquez sur le New bouton et ajoutez-le <unzipped folder path>\bin à la liste.
Redémarrez votre terminal. Vous devez maintenant être en mesure d’exécuter az des commandes.

Version la plus récente

Dernière version zip d’Azure CLI (64 bits)

Version spécifique

Si vous préférez, vous pouvez télécharger une version spécifique d’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 https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

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

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

Exécuter Azure CLI

Après l’installation, fermez et rouvrez toute fenêtre de terminal active. Exécutez Azure CLI avec la commande az à partir de l’invite de commandes Windows ou de PowerShell. 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 d’Azure CLI sur Windows. Si vous rencontrez un problème qui n’est pas traité ici, signalez ce problème sur GitHub.

Variable PATH non définie

La cause la plus courante de ce problème est que la fenêtre de terminal active n’a pas été redémarrée 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 serveur proxy bloque la connexion, vérifiez que votre proxy est configuré correctement. Pour Windows 10, ces paramètres sont gérés dans le volet Settings > Network & Internet > Proxy. Contactez votre administrateur système pour connaître les paramètres requis, ou les situations où votre ordinateur peut être géré par configuration ou nécessiter une configuration avancée.

Important

Ces paramètres sont également requis pour l’accès aux services Azure avec l’interface CLI, PowerShell ou l’invite de commandes. Dans PowerShell, pour ce faire, utilisez la commande suivante :

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

Pour obtenir le fichier 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 Travail derrière un proxy dans le guide de résolution des problèmes d’Azure CLI.

Des temps de réponse lent

Voir Migrer vers Azure CLI 64 bits

Activer la saisie semi-automatique via la touche Tab dans PowerShell

La saisie semi-automatique via la touche Tab, également connue comme « compléteurs Azure CLI », propose une saisie-automatique des entrées pour obtenir des indicateurs, activer la détection 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 via la touche Tab pour Azure CLI dans PowerShell. Suivez ces étapes :

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

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
}

Pour afficher toutes les options disponibles dans le menu, ajoutez Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete à votre profil PowerShell.

Mettre à jour Azure CLI

À compter de la version 2.11.0, Azure CLI fournit une commande dans l’outil pour effectuer la 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 az upgrade, consultez la page de référence des commandes. Pour les versions d’Azure CLI antérieures à 2.11.0, mettez à jour en réinstallant comme décrit dans Installer 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 Azure CLI 64 bits

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

Suivez ces étapes pour migrer vers Azure CLI 64 bits :

Vérifiez votre version actuelle de la CLI et les extensions installées en exécutant az --version.
Les extensions devront être réinstallées. Il est recommandé d'effectuer une sauvegarde du dossier d'extension actuel %userprofile%\.azure\cliextensions en le renommant au cas où vous choisiriez de revenir à 32 bits. Ce dossier est créé automatiquement lorsque vous réinstallez une extension.
Téléchargez et installez le dernier programme d'installation 64 bits comme décrit dans Installer ou mettre à jour. Le MSI 32 bits sera automatiquement désinstallé.
Installez les extensions en exécutant az extension add --name <extension> --version <version>. Si vous ne souhaitez pas réinstaller les extensions manuellement, Azure CLI vous invitera à 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 le MSI 64 bits et réinstaller le MSI 32 bits. Si vous avez effectué une sauvegarde de votre dossier d'extension 32 bits, restaurez (renommez) votre dossier d'extension après la modification.

Désinstaller l’interface

Si vous décidez de désinstaller l’interface de ligne de commande Azure, nous sommes désolés de vous voir partir. Avant de la désinstaller, utilisez la commande az feedback pour nous dire ce qui pourrait être amélioré ou révisé. Notre objectif est de rendre l’interface Azure CLI conviviale et exempte de bogues. Si vous avez rencontré un bogue, nous vous serions reconnaissants de bien vouloir signaler un problème lié à GitHub.

La désinstallation d’Azure CLI s’effectue à partir de la liste « Applications et fonctionnalités » dans Windows. Pour désinstaller :

Plateforme	Instructions
Windows 11	Démarrer > Paramètres > Applications > Applications installées
Windows 10	Démarrer > les applications d’applications > & paramètres >
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 listé sous le nom Microsoft CLI 2.0 pour Azure. Sélectionnez cette application, puis sélectionnez le bouton Uninstall.

Supprimer les données

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

Étapes suivantes

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

Se connecter avec Azure CLI

Partager via

Installer Azure CLI sur Windows

Installation ou mise à jour

WinGet (Gestionnaire de package Windows)

Microsoft Installer (MSI)

Version la plus récente

Version spécifique

Microsoft Installer (MSI) avec PowerShell

Version spécifique

Différences de syntaxe entre Bash et PowerShell

ZIP Package

Version la plus récente

Version spécifique

Exécuter Azure CLI

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

Variable PATH non définie

Le proxy bloque la connexion

Des temps de réponse lent

Activer la saisie semi-automatique via la touche Tab dans PowerShell

Mettre à jour Azure CLI

Migrer vers Azure CLI 64 bits

Désinstaller l’interface

Supprimer les données

Étapes suivantes

Ressources supplémentaires