Installare l'interfaccia della riga di comando di Azure in Windows

L'interfaccia della riga di comando di Azure (INTERFACCIA della riga di comando) è uno strumento da riga di comando multipiattaforma che può essere installato localmente nei computer Windows. È possibile usare l'interfaccia della riga di comando di Azure per Windows per connettersi ad Azure ed eseguire comandi amministrativi nelle risorse di Azure. L'interfaccia della riga di comando di Azure per Windows può essere usata anche da un browser tramite Azure Cloud Shell o eseguita dall'interno di un contenitore Docker.

Per Windows, l'interfaccia della riga di comando di Azure viene installata tramite un pacchetto MSI o ZIP, che consente di accedere all'interfaccia della riga di comando tramite il prompt dei comandi di Windows (CMD) o PowerShell. Quando si esegue un'installazione per sottosistema Windows per 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 dell'interfaccia della riga di comando di Azure è 2.58.0. Per informazioni sulla versione più recente, vedere le note sulla versione. Per individuare la versione installata e verificare se è necessario aggiornarla, eseguire az version.

Eseguire l'installazione o l'aggiornamento

Msi e ZIP distribuibile vengono usati per installare o aggiornare l'interfaccia della riga di comando di Azure in Windows. Non è necessario disinstallare le versioni correnti prima di usare il programma di installazione MSI perché l'identità del servizio gestito aggiorna qualsiasi versione esistente.

Importante

Al termine dell'installazione, sarà necessario chiudere e riaprire qualsiasi finestra del terminale attivo per usare l'interfaccia della riga di comando di Azure.

Ultima versione

Scaricare e installare la versione più recente dell'interfaccia della riga di comando di Azure. Quando il programma di installazione chiede se può apportare modifiche al computer, selezionare la casella "Sì".

Se in precedenza è stata installata l'interfaccia della riga di comando di Azure, l'esecuzione dell'identità del servizio gestito a 32 bit o a 64 bit sovrascriverà un'installazione esistente.

Versione specifica

Se si preferisce, è possibile scaricare una versione specifica dell'interfaccia della riga di comando di Azure usando un URL.

Per scaricare il programma di installazione MSI per una versione specifica, modificare il segmento di versione nell'URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32 bit) o https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 bit).

Ad esempio, per installare l'identità del servizio gestito a 32 bit dell'interfaccia della riga di comando di Azure versione 2.51.0, l'URL sarà https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi. L'installazione a 64 bit corrispondente sarebbe https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi.

Le versioni disponibili dell'interfaccia della riga di comando di Azure sono disponibili nelle note sulla versione dell'interfaccia della riga di comando di Azure. L'identità del servizio gestito a 64 bit è disponibile dalla versione 2.51.0.

Eseguire l'interfaccia della riga di comando di Azure

È ora possibile eseguire l'interfaccia della riga di comando di Azure con il comando az dal prompt dei comandi di Windows o da PowerShell.

Abilitare il completamento tramite tabulazione in PowerShell

Il completamento tramite tabulazione, noto anche come "completer dell'interfaccia della riga di comando di Azure", fornisce il completamento sugli input per fornire suggerimenti, abilitare l'individuazione e velocizzare la voce di 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 dalla versione 2.49 dell'interfaccia della riga di comando di Azure, è possibile abilitare il completamento della scheda per l'interfaccia della riga di comando di Azure in PowerShell. Seguire questa procedura:

  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.

Risoluzione dei problemi

Ecco alcuni problemi comuni riscontrati durante l'installazione dell'interfaccia della riga di comando di Azure in Windows. Se si verifica un problema non trattato in questo articolo, segnalarlo in GitHub.

Il proxy blocca la connessione

Se non è possibile scaricare il programma di installazione MSI perché il proxy blocca la connessione, assicurarsi che il proxy sia configurato correttamente. Per Windows 10 queste impostazioni sono gestite nel riquadro Settings > Network & Internet > Proxy. Contattare l'amministratore di sistema per richiedere le impostazioni necessarie o in casi in cui il computer può essere gestito tramite configurazione o richiede una configurazione avanzata.

Importante

Queste impostazioni sono inoltre necessarie per poter accedere ai servizi di Azure con l'interfaccia della riga di comando, sia da PowerShell che dal prompt dei comandi. Per eseguire questa operazione in PowerShell, usare il comando seguente:

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

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

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

Eseguire la migrazione all'interfaccia della riga di comando di Azure a 64 bit

A partire dalla versione 2.51.0, l'interfaccia della riga di comando di Azure offre anche l'identità del servizio gestito a 64 bit consigliata per prestazioni migliori.

Seguire questa procedura per eseguire la migrazione all'interfaccia della riga di comando di Azure a 64 bit:

  1. Controllare la versione corrente dell'interfaccia della riga di comando e le estensioni installate eseguendo az --version.
  2. Le estensioni dovranno essere reinstallate. È consigliabile eseguire un backup della cartella %userprofile%\.azure\cliextensions di estensione corrente rinominandola nel caso in cui si scelga di ripristinare 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. L'identità del servizio gestito a 32 bit verrà disinstallata automaticamente.
  4. Installare le estensioni eseguendo az extension add --name <extension> --version <version>. Se non si vogliono reinstallare manualmente le estensioni, l'interfaccia della riga di comando di Azure richiederà di installare un'estensione al primo uso. Per altre informazioni sull'installazione delle estensioni, vedere Come installare le estensioni.

Se si verificano problemi dopo la migrazione, è possibile disinstallare il file MSI a 64 bit e reinstallare l'identità del servizio gestito a 32 bit. Se è stato eseguito un backup della cartella dell'estensione a 32 bit, ripristinare (rinominare) la cartella dell'estensione dopo la modifica.

Aggiornare l'interfaccia della riga di comando di Azure

A partire dalla versione 2.11.0, l'interfaccia della riga di comando di Azure 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 le versioni dell'interfaccia della riga di comando di Azure precedenti alla versione 2.11.0, eseguire l'aggiornamento reinstallando come descritto in Installare l'interfaccia della riga di comando di Azure.

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

Disinstalla

È possibile disinstallare l'interfaccia della riga di comando di Azure. Prima di eseguire la disinstallazione, usare il comando az feedback per segnalare aspetti da migliorare o correggere. L'obiettivo è realizzare un'interfaccia della riga di comando di Azure priva di bug e facile da usare. Se è stato rilevato un bug, segnalarlo in GitHub.

È possibile disinstallare l'interfaccia della riga di comando di Azure dall'elenco "App e funzionalità" di Windows. Per eseguire la disinstallazione:

Piattaforma Istruzioni
Windows 11 Avviare > Impostazioni > app > installate
Windows 10 Avviare > Impostazioni > App di sistema > e funzionalità
Windows 8 e Windows 7 Start > Pannello di controllo > Programmi > Disinstalla un programma

In questo tipo di schermata digitare interfaccia della riga di comando di Azure nella barra di ricerca dei programmi. Il programma per la disinstallazione è elencato come Interfaccia della riga di comando di Microsoft Azure 2.0. Selezionare questa applicazione, quindi selezionare il Uninstall pulsante .

Rimuovere i dati

Se non si prevede di reinstallare l'interfaccia della riga di comando di Azure, rimuovere i dati da C:\Users\<username>\.azure\msal_token_cache.bin o C:\Users\<username>\.azure\msal_token_cache.json.

Passaggi successivi

Dopo aver installato l'interfaccia della riga di comando di Azure in Windows, vedere i diversi modi per accedere.