Installare il Azure CLI in Windows

L'interfaccia Azure Command-Line è uno strumento da riga di comando multipiattaforma che può essere installato localmente nei computer Windows. È possibile usare il Azure CLI per Windows per connettersi a Azure ed eseguire comandi amministrativi nelle risorse Azure. Il Azure CLI può essere usato anche da un browser tramite il Azure Cloud Shell o eseguito dall'interno di un contenitore Docker.

Per Windows, l'Azure CLI viene installato tramite un pacchetto MSI o un pacchetto ZIP, che consente di accedere all'Azure CLI tramite PowerShell o il prompt dei comandi di Windows (cmd.exe). Quando si esegue un'installazione per Windows Subsystem for Linux (WSL), i pacchetti sono disponibili per la distribuzione linux. Per un elenco di gestori di pacchetti supportati o per sapere come eseguire manualmente l'installazione in WSL, vedere la pagina di installazione principale.

La versione corrente del Azure CLI è 2.84.0. Per informazioni sull'ultima versione, vedere le note di rilascio . Per individuare la versione installata e verificare se è necessario aggiornarla, eseguire az version.

Installare o aggiornare

Il distributore MSI e il file ZIP distribuibile vengono usati per installare o aggiornare Azure CLI su Windows. Non è necessario disinstallare le versioni attuali prima di usare l'installer MSI, perché l'MSI aggiorna qualsiasi versione esistente.

winget install --exact --id Microsoft.AzureCLI

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

$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

$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

Eseguire il Azure CLI

Dopo l'installazione, chiudere e riaprire qualsiasi finestra del terminale attivo. Eseguire il Azure CLI con il comando az da PowerShell o dal prompt dei comandi Windows.

Prima di poter eseguire Azure CLI comandi, è necessario accedere a Azure. Per accedere in modo interattivo, usare az login. Per informazioni sull'autenticazione, vedere Sign into Azure with Azure CLI.For information on authentication, see Sign into Azure with Azure CLI.

az login

Un primo passaggio comune consiste nel controllare la sottoscrizione attiva.

az account show

Risoluzione dei problemi relativi all'installazione

Ecco alcuni problemi comuni riscontrati durante l'installazione del Azure CLI in Windows. Se si verifica un problema non trattato qui, file un problema in GitHub.

Variabile PATH non impostata

La causa più comune di questo problema è il mancato riavvio della finestra del terminale attivo dopo l'installazione. Chiudere e riaprire qualsiasi finestra del terminale attiva.

Il proxy blocca la connessione

Se non è possibile scaricare il programma di installazione msi perché il proxy blocca la connessione, assicurarsi di avere configurato il proxy. Per Windows 11, queste impostazioni vengono gestite nel riquadro Settings > Network & Internet > Proxy. Contattare l'amministratore di sistema per le impostazioni necessarie o per le situazioni in cui il computer potrebbe essere gestito dalla configurazione o richiedere la configurazione avanzata.

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

Per ottenere l'MSI, il proxy deve consentire le connessioni HTTPS agli indirizzi seguenti:

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

Per altre informazioni, vedere Work behind a proxy nella guida alla risoluzione dei problemi Azure CLI.

Tempi di risposta lenti

Consultare Migrazione al 64-bit di Azure CLI

Abilitare il completamento della scheda in PowerShell

Il completamento tramite tabulazione, noto anche come "Azure CLI completatori", fornisce il completamento sugli input per fornire suggerimenti, abilitare l'individuazione e velocizzare l'inserimento degli input. I nomi dei comandi, i nomi dei gruppi di comandi, i parametri e determinati valori di parametro possono essere inseriti automaticamente nella riga di comando premendo TAB.

Il completamento tramite tabulazione è abilitato per impostazione predefinita in Azure Cloud Shell e nella maggior parte delle distribuzioni Linux. A partire da Azure CLI versione 2.49, è possibile abilitare il completamento tramite Tab per l'Azure CLI in PowerShell. Segui questi passaggi:

1. Creare o modificare il profilo archiviato nella variabile $PROFILE. Il modo più semplice consiste nell'eseguire notepad $PROFILE in PowerShell. Per altre informazioni, vedere How to create your profile (Come creare un profilo) e Profiles and execution policy (Profili e criteri di esecuzione).

2. Aggiungere il codice seguente al profilo di 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. Per visualizzare tutte le opzioni disponibili nel menu, aggiungere Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete al profilo di PowerShell.

Aggiornare il Azure CLI

A partire dalla versione 2.11.0, il Azure CLI fornisce un comando in-tool per eseguire l'aggiornamento alla versione più recente.

az upgrade

Per impostazione predefinita, questo comando aggiorna anche tutte le estensioni installate. Per altre az upgrade opzioni, vedere la pagina di riferimento del comando. Per Azure CLI versioni precedenti a 2.11.0, eseguire l'aggiornamento reinstallando come descritto in Installare il Azure CLI.

Se si usa la distribuzione ZIP, rimuovere la cartella di installazione precedente ed estrarre la nuova versione nello stesso percorso.

Eseguire la migrazione a Azure CLI a 64 bit

A partire dalla versione 2.51.0, Azure CLI fornisce anche un MSI a 64 bit, consigliato per migliori prestazioni.

Seguire questa procedura per eseguire la migrazione alla versione a 64 bit di Azure CLI:

1. Controllare la versione corrente Azure CLI e le estensioni installate eseguendo az --version.
2. Le estensioni richiedono la reinstallazione. Eseguire il backup della cartella %userprofile%\.azure\cliextensions dell'estensione corrente rinominandola nel caso in cui si decida di ripristinare la versione a 32 bit. Questa cartella viene creata automaticamente quando si reinstalla un'estensione.
3. Scaricare e installare il programma di installazione a 64 bit più recente, come descritto in Installare o aggiornare. Il pacchetto MSI a 32 bit viene disinstallato automaticamente.
4. Installare le estensioni eseguendo az extension add --name <extension> --version <version>. Se non si desidera reinstallare manualmente le estensioni, il Azure CLI richiede di installare un'estensione al primo utilizzo. Per altre informazioni sull'installazione delle estensioni, vedere Come installare le estensioni.

Se si verificano problemi dopo la migrazione, è possibile disinstallare la versione a 64 bit e reinstallare l'MSI a 32 bit. Se è stato eseguito un backup della cartella delle estensioni a 32 bit, ripristinare o rinominare la cartella dell'estensione dopo la modifica.

Disinstallare

Se decidi di disinstallare l'Azure CLI, ci dispiace vederti andare via. Prima di eseguire la disinstallazione, usare il comando az feedback per segnalare aspetti da migliorare o correggere. L'obiettivo è quello di rendere l'Azure CLI senza bug e facile da usare. Se è stato rilevato un bug, è consigliabile segnalare un problema di GitHub.

Il Azure CLI viene disinstallato dall'elenco Windows "App e funzionalità". Per eseguire la disinstallazione:

Una volta in questa schermata digitare Azure CLI nella barra di ricerca del programma. Il programma da disinstallare è elencato come Microsoft CLI 2.0 per Azure. Selezionare questa applicazione, quindi selezionare il Uninstall pulsante .

Rimuovere i dati

Se non si prevede di reinstallare Azure CLI, rimuovere i dati da C:\Users\<username>\.azure\msal_token_cache.bin o C:\Users\<username>\.azure\msal_token_cache.json.

Passaggi successivi

Ora che il Azure CLI è stato installato in Windows, è possibile ottenere informazioni sui diversi modi per accedere.