Installer Azure CLI sur Windows

  • Article

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ée à l’aide d’un fichier MSI, ce qui vous donne accès à l’interface CLI via l’Invite de commande Windows (CMD) ou PowerShell. Lors de son installation sur 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 de l’interface Azure CLI est 2.49.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

Le fichier MSI distribuable est utilisé pour l’installation ou la mise à jour d’Azure CLI sur Windows. Vous n’avez pas besoin de désinstaller les versions actuelles avant d’utiliser le programme d’installation MSI, car celui-ci met à jour toute version existante.

Notes

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, cliquez sur la case « Oui ».

Dernière version d’Azure CLI

Version spécifique

Pour télécharger le programme d’installation MSI d’une version spécifique, changez le segment de version dans l’URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi et effectuez le téléchargement. Les versions disponibles sont indiquées dans les Notes de publication d’Azure CLI.

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 complétion via la touche Tab dans PowerShell

PowerShell fournit une complétion des entrées pour fournir des indicateurs, activer 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ètre peuvent être complétés en appuyant sur la touche Tab.

Notes

Azure CLI version 2.49 ou ultérieure est requis pour activer la complétion via la touche Tab pour Azure CLI sur PowerShell.

Pour activer la complétion via la touche Tab dans PowerShell, 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 ensuite 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"
    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
}

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/

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 & 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 cliquez sur 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 ses fonctionnalités et ses commandes courantes.

Prise en main de l’interface Azure CLI