Installare Azure CLI su Windows 11 e 10 con PowerShell o CMD

Installare Azure CLI su Windows 11 e 10: il modo più pulito

Se lavori con Azure con una certa continuità, la Azure CLI è uno di quegli strumenti che conviene avere installati bene e aggiornati, non “più o meno funzionanti”. Su Windows 11 e Windows 10 la procedura è abbastanza lineare, ma ci sono differenze pratiche tra installazione da PowerShell, da CMD e da pacchetto scaricato dal sito Microsoft. La scelta giusta dipende da quanto vuoi automatizzare, da quanto controllo ti serve e da come è configurato il PC.

© TrgtKLS • Tech, Sicurezza e Strumenti & guide per Webmaster — https://trgtkls.it — tutti i diritti riservati.

Qui sotto trovi un percorso completo: scelta del metodo, installazione, verifica, aggiornamento e risoluzione dei problemi tipici. L’obiettivo è arrivare a un’installazione verificabile, senza lasciare dubbi su PATH, permessi o versioni residue.

Quale metodo conviene usare

In pratica hai tre strade.

• Installer MSI ufficiale: è il metodo più semplice e spesso il più affidabile su workstation singole.
• Winget: utile se vuoi installare da riga di comando e mantenere una procedura ripetibile.
• Installazione manuale: da usare solo se hai esigenze particolari o se l’ambiente blocca i pacchetti standard.

Se stai lavorando su un PC personale o aziendale senza vincoli particolari, il consiglio pratico è questo: usa winget se disponibile, altrimenti scarica l’installer MSI ufficiale. In entrambi i casi, la verifica finale con az version è obbligatoria: installare non basta, bisogna confermare che la shell veda davvero il comando.

Installazione con PowerShell tramite winget

Su Windows 11 winget è spesso già presente; su Windows 10 dipende dalla versione di App Installer. Se il comando esiste, è il metodo più rapido e ripetibile.

Apri PowerShell o Windows Terminal con privilegi normali e lancia:

winget install -e --id Microsoft.AzureCLI

Il parametro -e forza la corrispondenza esatta dell’ID del pacchetto. Questo riduce il rischio di installare un pacchetto sbagliato o un alias ambiguo. Se l’operazione va a buon fine, winget scarica e installa Azure CLI senza passaggi manuali aggiuntivi.

Se il comando non viene riconosciuto, non forzare tentativi casuali: verifica prima se App Installer è installato e aggiornato dal Microsoft Store. In molte macchine è proprio quello che abilita winget.

Installazione con l’installer MSI ufficiale

È il metodo più classico e resta quello più adatto quando vuoi un’installazione “chiusa”, con meno dipendenze dall’ecosistema del Microsoft Store.

1. Vai alla pagina ufficiale di installazione di Azure CLI sul sito Microsoft e scarica il pacchetto per Windows.
2. Avvia il file .msi scaricato.
3. Segui il wizard di installazione accettando le impostazioni predefinite, salvo policy aziendali diverse.
4. Al termine apri una nuova finestra di PowerShell o CMD e verifica il comando az.

Di solito l’installer aggiunge automaticamente il percorso della CLI al PATH di sistema o dell’utente. Non dare per scontato che la sessione già aperta lo veda: chiudi e riapri la shell prima di fare test. È uno degli errori più frequenti.

Se ti interessa controllare dove è stata installata, il percorso tipico su Windows è sotto C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin. Non devi modificarlo a mano nella maggior parte dei casi, ma è utile saperlo quando devi fare troubleshooting del PATH.

Verifica immediata dopo l’installazione

La prima verifica non deve essere “apre o non apre”, ma “la shell trova il comando e la versione è coerente”. Apri una nuova finestra di PowerShell o CMD e lancia:

az version

Se tutto è corretto, vedrai un output JSON con la versione di Azure CLI e dei componenti installati. Un esito positivo tipico è la presenza di una struttura con campi come azure-cli, azure-cli-core e altre dipendenze. Non serve che i valori coincidano con una versione specifica: quello che conta è che il comando risponda e non restituisca un errore tipo 'az' is not recognized.

Puoi fare una seconda verifica rapida con:

az --help

Se questo comando mostra l’elenco dei gruppi principali, la CLI è operativa nella sessione corrente.

Installazione e uso da CMD

Azure CLI funziona anche da Prompt dei comandi, ma per l’installazione è più comodo usare PowerShell o winget. Da CMD il punto chiave è la stessa cosa: dopo l’installazione devi aprire una nuova sessione.

Se vuoi verificare da CMD, usa:

az version

Se il comando non viene trovato in CMD ma funziona in PowerShell, il problema è quasi sempre il PATH della sessione o una differenza nella cache del terminale, non l’installazione in sé.

Aggiornare Azure CLI senza disinstallare

Se hai installato Azure CLI con winget, l’aggiornamento è semplice:

winget upgrade -e --id Microsoft.AzureCLI

In alternativa, se hai usato l’MSI, puoi scaricare la nuova versione dal sito Microsoft e reinstallarla sopra quella esistente. In genere l’operazione è lineare e non richiede pulizie manuali, ma conviene verificare sempre la versione dopo l’upgrade con az version.

Da un punto di vista operativo, tenere aggiornata la CLI è importante per tre motivi: compatibilità con nuove API di Azure, correzioni di bug e aggiornamenti di sicurezza del runtime Python impacchettato nel tool. Non è un dettaglio marginale se usi la CLI in script o pipeline.

Problemi tipici e come riconoscerli

Il guasto più comune è banale ma frequente: l’installer ha completato il lavoro, ma la shell aperta prima dell’installazione non vede ancora az. In quel caso la correzione è semplice: chiudi e riapri PowerShell o CMD, poi rilancia az version.

Se invece il comando non viene riconosciuto nemmeno in una nuova sessione, controlla il PATH. Puoi ispezionarlo con:

echo %PATH%

In PowerShell puoi usare anche:

$env:PATH

Se nel percorso non compare la directory della CLI, l’installazione non ha registrato correttamente il binario oppure il profilo utente non ha ereditato la variabile. In questo caso non conviene modificare a mano senza capire prima cosa è successo: il rischio è duplicare voci o creare conflitti con altre installazioni.

Altro caso tipico: PowerShell blocca gli script o mostra avvisi di esecuzione. Azure CLI in sé non richiede policy speciali per il comando base, quindi se hai problemi in questo punto il sospetto va spostato su policy aziendali, profili utente o antivirus che interferiscono con l’esecuzione di componenti locali.

Configurazione iniziale utile dopo il primo avvio

Una volta verificato che la CLI funziona, conviene impostare subito i parametri di lavoro più usati. Il comando più comune è il login interattivo:

az login

Il flusso apre il browser o una procedura di autenticazione collegata all’account Azure. Dopo il login puoi verificare l’account attivo con:

az account show

Se lavori su più subscription, è utile controllare quale sia quella selezionata e, se necessario, impostarla esplicitamente. Questo evita errori operativi molto comuni, soprattutto quando si gestiscono ambienti diversi con nomi simili.

Per vedere l’elenco delle subscription disponibili:

az account list -o table

Il formato tabellare è più leggibile a colpo d’occhio rispetto al JSON, soprattutto durante il troubleshooting o quando devi scegliere rapidamente il contesto corretto.

Uso in script e automazione locale

Se pensi di usare Azure CLI in script PowerShell o batch, il punto fondamentale è trattarla come una dipendenza di ambiente, non come un comando “magico”. Devi sapere dove si trova, quale versione stai usando e con quale account opera.

Un controllo minimo in uno script PowerShell può essere questo:

az version | Out-Null
if ($LASTEXITCODE -ne 0) { throw "Azure CLI non disponibile"
}

È un controllo semplice, ma utile per interrompere subito l’esecuzione se il binario non è raggiungibile. In contesti più strutturati, conviene aggiungere anche il controllo della subscription corrente e del tenant, per evitare di lanciare operazioni nel contesto sbagliato.

Se usi script batch da CMD, l’idea resta la stessa: prima verifica che az sia risolvibile, poi esegui l’operazione vera. Saltare questo passaggio è una delle cause più frequenti di errori intermittenti su workstation condivise.

Disinstallazione pulita e reinstallazione

Se qualcosa si è incastrato, la strada più sicura è disinstallare e reinstallare. Da Windows puoi farlo da Impostazioni > App > App installate cercando Azure CLI. Dopo la rimozione, riavvia la shell e controlla che az non sia più presente con az version.

Se vuoi una reinstallazione più controllata, puoi anche rimuovere la voce vecchia e installare di nuovo con il metodo scelto in precedenza. In ambienti amministrati, però, è meglio verificare prima se ci sono policy o software di gestione endpoint che reinstallano automaticamente componenti approvati.

Una reinstallazione va sempre considerata a impatto basso sul sistema, ma può avere effetto sulle sessioni aperte e sui profili utente che si appoggiano alla vecchia versione. Per questo la verifica finale con nuova shell è parte integrante del processo, non un optional.

Checklist rapida di fine lavoro

1. Ho scelto il metodo di installazione più adatto al mio contesto.
2. Ho installato Azure CLI con winget o con MSI ufficiale.
3. Ho chiuso e riaperto PowerShell o CMD.
4. Ho eseguito az version e ottenuto un output JSON valido.
5. Ho verificato il login con az login e il contesto con az account show.
6. Se uso script, ho confermato che la CLI sia disponibile anche in esecuzione non interattiva.

Se uno di questi punti fallisce, il problema non è “Azure” in astratto: è quasi sempre un dettaglio di installazione, PATH, sessione aperta o contesto utente. Ed è proprio lì che conviene intervenire, prima di cercare cause più esotiche.