Condividi tramite

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

  • Articolo

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

WinGet (Gestione pacchetti di Windows)

Usare WinGet, il gestore di pacchetti di Microsoft per Windows, per installare e gestire gli aggiornamenti di Azure CLI. Per impostazione predefinita, Winget installa l'interfaccia della riga di comando di Azure a 64 bit nei sistemi operativi a 64 bit.

Nota

WinGet è disponibile per impostazione predefinita in Windows 11 e nelle versioni moderne di Windows 10. Tuttavia, potrebbe non essere installato nelle versioni precedenti di Windows. Per istruzioni sull'installazione, vedere la documentazione di winget.

winget install -e --id Microsoft.AzureCLI

L'opzione -e consiste nel verificare che il pacchetto ufficiale dell'interfaccia della riga di comando di Azure sia installato. Questo comando installa la versione più recente per impostazione predefinita. Per specificare una versione, aggiungere un oggetto -v <version> con la versione desiderata al comando . Ecco un esempio:

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

Microsoft Installer (MSI)

Versione più recente

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

Msi più recente dell'interfaccia della riga di comando di Azure (32 bit)

Msi più recente dell'interfaccia della riga di comando di Azure (64 bit)

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.

Microsoft Installer (MSI) con PowerShell

Per installare l'interfaccia della riga di comando di Azure usando PowerShell, avviare PowerShell come amministratore ed eseguire il comando seguente:

$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

Verrà scaricato e installato il programma di installazione a 32 bit più recente dell'interfaccia della riga di comando di Azure per Windows. Se si preferisce un'installazione a 64 bit, modificare l'URL in https://aka.ms/installazurecliwindowsx64. Se l'interfaccia della riga di comando di Azure è già installata, il programma di installazione sovrascriverà la versione esistente.

Per installare una versione specifica, sostituire l'argomento -Uri con l'URL descritto nella sezione successiva. Di seguito è riportato un esempio di uso del programma di installazione a 32 bit dell'interfaccia della riga di comando di Azure versione 2.51.0 in 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

Versione specifica

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.

Differenze di sintassi tra Bash e PowerShell

Anche se la maggior parte della documentazione dell'interfaccia della riga di comando di Azure è scritta e testata in una shell Bash, è anche possibile installare ed eseguire l'interfaccia della riga di comando di Azure usando PowerShell. Esistono sottili differenze di sintassi tra Bash e PowerShell. Esaminare questi articoli per evitare errori di scripting:

Quando si esegue l'interfaccia della riga di comando di Azure in PowerShell, esistono anche differenze di gestione degli errori e la possibilità di abilitare il completamento tramite tabulazione. Vedere questi articoli per altre informazioni:

Pacchetto ZIP

Importante

Questo pacchetto è attualmente in anteprima.

È possibile usare il pacchetto ZIP per installare l'interfaccia della riga di comando di Azure in Windows. Questo pacchetto è utile quando non si dispone di privilegi amministrativi.

Decomprimere il pacchetto in una cartella, quindi usando Cmd o PowerShell, chiamare l'interfaccia della riga di comando di Azure eseguendo <unzipped folder path>\bin\az.cmd.

Per eseguire direttamente il az comando, seguire questa procedura per aggiungere l'interfaccia della riga di comando di Azure alla PATH variabile di ambiente.

  1. Aprire il menu Start e cercare environment variables. Fare clic su Edit the system environment variables.
  2. Fare clic sul pulsante Environment Variables....
  3. User varibles for <username> Nella casella selezionare Path e fare clic sul Edit... pulsante.
  4. Fare clic sul New pulsante e aggiungere l'oggetto <unzipped folder path>\bin all'elenco.
  5. Riavviare il terminale. A questo momento dovrebbe essere possibile eseguire az i comandi.

Versione più recente

Zip più recente dell'interfaccia della riga di comando di Azure (64 bit)

Versione specifica

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

Per scaricare il pacchetto ZIP per una versione specifica, modificare il segmento di versione nell'URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip.

Ad esempio, per installare il file ZIP a 64 bit dell'interfaccia della riga di comando di Azure versione 2.57.0, l'URL sarà https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip.

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. Il pacchetto ZIP è disponibile dalla versione 2.57.0. È disponibile solo a 64 bit.

Eseguire l'interfaccia della riga di comando di Azure

Dopo l'installazione, chiudere e riaprire qualsiasi finestra del terminale attivo. Esegui l'Azure CLI con il comando az dal prompt dei comandi di Windows o da PowerShell. 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 dell'interfaccia della riga di comando di Azure in Windows. Se si verifica un problema non trattato in questo articolo, segnalarlo in GitHub.

Variabile PATH non impostata

La causa più comune di questo problema è che la finestra del terminale attivo non è stata riavviata 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 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/

Per altre informazioni, vedere Lavorare dietro un proxy nella guida alla risoluzione dei problemi dell'interfaccia della riga di comando di Azure.

Tempi di risposta lenti

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

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.

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.

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.

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 Start > Settings > Apps Installed apps >
Windows 10 Start > Settings > Apps > & Features
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.

Accedere tramite l'interfaccia della riga di comando di Azure