Installer Azure CLI sur Windows

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.58.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.

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".

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.

Exécuter Azure CLI

Vous pouvez désormais exécuter l’interface de ligne de commande Azure avec la commande az à partir de l’invite de commandes Windows ou PowerShell.

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 :

  1. 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.

  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 Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete à votre profil PowerShell.

Dépannage

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.

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/

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 :

  1. Vérifiez votre version actuelle de la CLI et les extensions installées en exécutant az --version.
  2. 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.
  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 sera automatiquement désinstallé.
  4. 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.

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.

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 > Paramètres > Système > 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 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.