Come installare Azure CLI: guida pratica all’installazione, all’autenticazione e all’utilizzo

Gestire l’infrastruttura cloud significava passare ore a cliccare tra portali web e menu infiniti. Dopo mesi di frustrazione con i processi manuali, scoprire Azure CLI ha cambiato completamente il mio approccio alla gestione delle risorse cloud. Questa non è l’ennesima guida all’installazione: è la tua roadmap per padroneggiare lo strumento multipiattaforma più potente di Microsoft per l’amministrazione di Azure.

> Inizia con Azure Cloud Shell per un accesso immediato senza la complessità dell’installazione.

La Azure CLI offre un’esperienza coerente e potente per gestire le risorse Azure su tutti i principali sistemi operativi.

Che cos’è Azure CLI?

Azure CLI è il modo più diretto per controllare le tue risorse cloud. Sostituisce i limiti del browser con un’interfaccia potente e scriptabile che dialoga direttamente con le API core di Azure. Questo ti dà la possibilità di automatizzare su larga scala, con comandi coerenti e affidabili su qualsiasi sistema operativo.

Ciò che amo della CLI è come mi consente di esplorare i servizi mentre imparo e poi catturare quegli stessi passaggi in uno script quando sono pronto a costruire davvero. Il segreto non è memorizzare i comandi, az find o i flag --help per chiedere aiuto in modo efficace.

Azure CLI sfrutta il modello Azure Resource Manager, offrendo accesso coerente a tutti i servizi Azure tramite una struttura di comandi unificata. Questa scelta architetturale significa che, sia che tu stia gestendo macchine virtuali, account di archiviazione o configurazioni di rete complesse, lavori con la stessa API sottostante che alimenta l’Azure Portal.

Tutti i comandi di Azure CLI sono unificati tramite Azure Resource Manager (ARM), lo stesso motore che alimenta l’Azure Portal.

Azure CLI vs Azure Portal

Avendo gestito centinaia di deployment Azure tramite entrambe le interfacce, la CLI diventa indispensabile per:

• Automazione e scalabilità: gli script possono gestire dozzine di risorse simultaneamente, cosa impossibile con interazioni manuali nel Portal
• Integrazione con il controllo versione: i comandi per l’infrastruttura diventano codice, tracciato e revisionato come qualsiasi altro artefatto software  
• Coerenza multipiattaforma: gli stessi comandi funzionano in modo identico su Windows, Linux e macOS
• Velocità ed efficienza: gli amministratori esperti possono eseguire operazioni complesse in secondi anziché minuti

Come installare Azure CLI

Il primo passo è installare Azure CLI, ma qui ho visto molte persone inciampare. Il metodo giusto per un Mac personale è completamente diverso da quello che serve a una grande azienda con PC Windows bloccati. Vediamo le opzioni così puoi farlo bene al primo tentativo ed evitare di combattere con versioni incompatibili o con amministratori IT frustrati. 

Installazione su piattaforme diverse

Metodi di installazione su Windows

Gli utenti Windows hanno più percorsi di installazione, ciascuno adatto a diversi requisiti organizzativi:

WinGet Package Manager (consigliato per sviluppatori individuali):

winget install -e --id Microsoft.AzureCLIOfferto da

Il comando sopra usa il moderno gestore pacchetti di Windows per aggiornamenti automatici e installazioni pulite.

MSI Installer (ideale per deployment enterprise):

Scarica l’MSI più recente dalla pagina ufficiale di download di Azure CLI e segui la procedura guidata. Questo metodo offre il massimo controllo su directory di installazione e integrazione di sistema.

Installazione MSI via PowerShell (ideale per setup automatizzati):

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; rm .\AzureCLI.msiOfferto da

Questo script PowerShell scarica, installa e ripulisce automaticamente il pacchetto MSI.

> Usa WinGet per le macchine di sviluppo e gli installer MSI per gli ambienti di produzione

Installazione su Linux e WSL

Le distribuzioni Linux richiedono gestori pacchetti diversi: conoscere la tua distribuzione specifica evita errori di installazione comuni:

Ubuntu/Debian (apt):

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bashOfferto da

Questo script di installazione configura automaticamente il repository di pacchetti Microsoft e installa Azure CLI.

Red Hat Enterprise Linux/CentOS Stream (dnf):

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo dnf install -y https://packages.microsoft.com/config/rhel/9/packages-microsoft-prod.rpm
sudo dnf install azure-cliOfferto da

Questi comandi importano la chiave di firma Microsoft e configurano il repository prima dell’installazione.

Script di installazione universale:

curl -L https://aka.ms/InstallAzureCli | bashOfferto da

Questo script rileva la tua distribuzione e usa automaticamente il gestore pacchetti appropriato.

Installazione su macOS

Gli utenti macOS beneficiano della gestione pacchetti di Homebrew:

brew update && brew install azure-cliOfferto da

Questo comando aggiorna gli elenchi dei pacchetti Homebrew e installa la versione più recente di Azure CLI.

Per i sistemi senza Homebrew:

curl -L https://aka.ms/InstallAzureCli | bashOfferto da

Approccio con container Docker

Eseguire Azure CLI in container Docker fornisce isolamento completo:

docker run -it mcr.microsoft.com/azure-cli:latestOfferto da

Questo comando avvia un container interattivo con Azure CLI preinstallata e configurata.

Azure Cloud Shell: opzione senza installazione

Azure Cloud Shell fornisce accesso immediato alla CLI senza alcuna installazione locale. Questo ambiente basato su browser è preconfigurato con l’ultima versione di Azure CLI e include strumenti aggiuntivi come terraform, kubectl e vari editor di testo.

Verifica versioni e aggiornamenti

Una volta installata, verifica la configurazione con informazioni complete sulla versione:

az versionOfferto da

Questo comando restituisce un JSON dettagliato con versione di Azure CLI, componenti core ed estensioni installate.

Capire questo output aiuta a risolvere problemi di compatibilità e assicura che i tuoi script puntino alle versioni corrette della CLI. Microsoft pubblica note di rilascio dettagliate che documentano breaking change e nuove funzionalità.

> Controlla sempre la compatibilità delle estensioni quando aggiorni le versioni di Azure CLI.

Autenticazione con Azure CLI

L’autenticazione costituisce le fondamenta di sicurezza della tua esperienza con Azure CLI, con recenti modifiche alle policy che stanno ridefinendo il modo in cui le organizzazioni gestiscono le credenziali. Le strategie moderne devono bilanciare requisiti di sicurezza ed efficienza operativa, soprattutto mentre Microsoft applica standard di autenticazione più rigorosi su tutti i servizi Azure.

Metodi di autenticazione

Accesso automatico con Azure Cloud Shell

Cloud Shell esegue automaticamente l’autenticazione usando la tua sessione corrente dell’Azure Portal. Questa integrazione senza attriti elimina la complessità dell’autenticazione per gli usi interattivi, rendendola perfetta per apprendimento e attività amministrative spot.

Login interattivo

L’approccio standard usa il device code flow:

az loginOfferto da

Questo comando apre il browser predefinito per l’autenticazione con Microsoft Entra ID con gestione MFA automatica.

Per ambienti senza interfaccia grafica:

az login --use-device-codeOfferto da

Questo comando mostra un device code per autenticarti su https://microsoft.com/devicelogin da qualsiasi dispositivo connesso a Internet.

Autenticazione con identità gestita

Le risorse Azure si autenticano usando le managed identity:

az login --identityOfferto da

Questo metodo elimina l’onere di gestione delle credenziali per le applicazioni in esecuzione all’interno di Azure.

Autenticazione con service principal

Approccio legacy basato su credenziali (ora non conforme senza workload identity federation):

Questo metodo basato su password è il principale interessato dall’applicazione MFA di settembre 2025. Gli script che lo usano probabilmente falliranno e devono essere aggiornati.

az login --service-principal --username <app-id> --password <password> --tenant <tenant-id>Offerto da

Questo comando autentica usando credenziali applicative per scenari automatizzati.

Affrontare l’applicazione MFA di ottobre 2025

Dal 1° ottobre 2025 sarà attiva l’applicazione obbligatoria della Multi-Factor Authentication (MFA) di Microsoft. Se usi service principal con autenticazione basata su password, i tuoi script di automazione falliranno dopo tale data. È il cambiamento più critico per l’automazione con Azure CLI degli ultimi anni.

Questo aggiornamento di sicurezza cambia radicalmente l’approccio delle organizzazioni all’automazione con Azure CLI. Impatta i pattern di autenticazione con service principal e richiede la migrazione a workload identity per molti scenari automatizzati.

> La tua automazione è a rischio. Dai priorità alla migrazione alla workload identity federation ora per evitare interruzioni del servizio il 1° ottobre.

Il tuo piano d’azione in quattro passaggi per sistemare l’automazione in errore e rispettare i nuovi requisiti MFA.

Gestione delle sottoscrizioni

Gli ambienti di produzione spesso richiedono una gestione esplicita delle sottoscrizioni:

az account list --output table
az account set --subscription "Your Subscription Name"Offerto da

Questi comandi elencano le sottoscrizioni disponibili e impostano quella predefinita per i comandi successivi.

Token di accesso

Gli scenari avanzati richiedono la gestione diretta dei token di accesso:

az account get-access-tokenOfferto da

Questo comando restituisce token di accesso con dettagli di scadenza per l’uso programmatico.

Primi passi con i comandi di Azure CLI

La padronanza dei comandi inizia comprendendo la filosofia organizzativa della CLI e i meccanismi di discovery. Piuttosto che memorizzare centinaia di comandi, la chiave è imparare a navigare in modo efficiente nel vasto ecosistema di servizi Azure tramite il sistema di help intelligente della CLI.

Trovare i comandi

Le funzionalità di discoverability di Azure CLI riducono significativamente la curva di apprendimento:

az find "virtual machine"Offerto da

La ricerca basata su AI individua i comandi rilevanti con esempi d’uso.

Per i dettagli di un comando specifico:

az vm create --helpOfferto da

Questo comando di help mostra parametri, sottogruppi ed esempi pratici per consultazione immediata.

Usa "az find" per ottenere suggerimenti basati su AI e scoprire il comando esatto di cui hai bisogno.

Struttura dei comandi

Azure CLI segue una struttura gerarchica coerente: az <group> <subgroup> <command> [parameters]

Esempio di creazione di una macchina virtuale:

az vm create --resource-group myResourceGroup --name myVM --image UbuntuLTS --admin-username azureuser --generate-ssh-keysOfferto da

Questo comando crea una macchina virtuale con parametri di configurazione specificati.

Argomenti globali

Diversi argomenti funzionano in tutti i comandi:

- --output o -o: controlla il formato di output (json, table, yaml, jsonc, tsv)

- --query: filtra i risultati usando la sintassi JMESPath

- --verbose: fornisce informazioni dettagliate di esecuzione

- --debug: mostra dettagli completi delle richieste/risposte HTTP

> Usa --output table per risultati leggibili e --output json per l’elaborazione negli script

Modalità interattiva e funzioni di produttività

La modalità interattiva trasforma l’esperienza a riga di comando grazie all’assistenza intelligente e alla guida contestuale. Questo approccio colma il divario tra imparare nuovi comandi ed eseguirli con sicurezza, fornendo convalida e suggerimenti in tempo reale che accelerano sia la scoperta sia l’esecuzione.

Modalità interattiva di Azure CLI

La modalità interattiva offre un’esperienza a riga di comando migliorata:

az interactiveOfferto da

Questo comando avvia la modalità interattiva con completamento dei comandi, suggerimenti sui parametri e help contestuale.

La modalità interattiva di Azure CLI offre suggerimenti intelligenti, trasformando comandi complessi in un’esperienza guidata.

Completamento con Tab

Produttività avanzata tramite integrazione con la shell:

Bash:

echo 'source /etc/bash_completion.d/azure-cli' >> ~/.bashrcOfferto da

Questo comando abilita il completamento con Tab per i comandi di Azure CLI in Bash.

PowerShell:

Register-ArgumentCompleter -Native -CommandName az -ScriptBlock { ... }Offerto da

Questa configurazione PowerShell abilita il completamento con Tab per i comandi di Azure CLI.

Integrazione con VS Code

L’estensione Azure CLI per Visual Studio Code fornisce evidenziazione della sintassi, IntelliSense e terminale integrato.

Uso di Azure CLI per la gestione delle risorse

Ora che hai installato e configurato la CLI, è il momento di metterla al lavoro. Qui passiamo dalla teoria alla pratica e iniziamo a gestire risorse Azure reali. Andremo oltre i singoli comandi e vedremo i pattern che userai ogni giorno per creare, connettere e gestire la tua infrastruttura cloud.

Operazioni sui Resource Group

I resource group servono come contenitori logici per le risorse Azure:

az group create --name myResourceGroup --location eastus
az group list --output table
az group delete --name myResourceGroup --yes --no-waitOfferto da

Questi comandi creano, elencano ed eliminano resource group con elaborazione asincrona.

Creazione di risorse comuni

Creazione di una macchina virtuale:

az vm create \
  --resource-group myResourceGroup \
  --name myVM \
  --image UbuntuLTS \
  --size Standard_B2s \
  --admin-username azureuser \
  --generate-ssh-keysOfferto da

Questo comando crea una VM Linux con autenticazione tramite chiavi SSH.

Creazione di un account di archiviazione:

az storage account create \
  --name mystorageaccount \
  --resource-group myResourceGroup \
  --location eastus \
  --sku Standard_LRS \
  --kind StorageV2Offerto da

Questo comando crea un account di archiviazione v2 generico con replica locale (LRS).

Query e formattazione dell’output

Le query JMESPath filtrano e trasformano gli output dei comandi:

az vm list --query "[].{Name:name, PowerState:powerState}" --output table
az vm list --query "[?location=='eastus'].name" --output tsvOfferto da

Queste query JMESPath estraggono campi specifici e filtrano i risultati in base a criteri.

> Padroneggia le query JMESPath per estrarre esattamente i dati di cui hai bisogno da risposte JSON complesse.

Automazione con Azure CLI

L’automazione trasforma i singoli comandi in workflow ripetibili e affidabili che vanno oltre le operazioni manuali. La vera magia avviene quando smetti di pensare ai comandi CLI come a task isolati e inizi a integrarli in sistemi che gestiscono tutto, dal provisioning al disaster recovery.

Ricordo la prima volta che ho automatizzato il refresh settimanale dell’ambiente di sviluppo. Quello che prima richiedeva tre ore di clic e attese manuali è diventato uno script da 15 minuti che potevo lanciare mentre prendevo un caffè. Quello script ha fatto risparmiare al nostro team decine di ore ogni mese ed eliminato gli inevitabili errori umani dei processi manuali.

> Inizia in piccolo con l’automazione: automatizza prima i task giornalieri più ripetitivi, poi estendi a workflow infrastrutturali completi

Best practice per gli script

Template di script robusto con gestione errori e logging:

#!/bin/bash
set -euo pipefail  # Exit on errors, undefined variables, pipe failures

RESOURCE_GROUP="automation-rg"
LOCATION="eastus"
VM_NAME="automated-vm"

log() {
    echo "[$(date +'%Y-%m-%d %H:%M:%S')] $1"
}

cleanup() {
    log "Cleaning up resources due to script failure"
    az group delete --name "$RESOURCE_GROUP" --yes --no-wait 2>/dev/null || true
}

trap cleanup ERR

log "Starting Azure resource provisioning"

if ! az group show --name "$RESOURCE_GROUP" &>/dev/null; then
    log "Creating resource group: $RESOURCE_GROUP"
    az group create --name "$RESOURCE_GROUP" --location "$LOCATION"
fi

VM_RESULT=$(az vm create \
    --resource-group "$RESOURCE_GROUP" \
    --name "$VM_NAME" \
    --image UbuntuLTS \
    --generate-ssh-keys \
    --output json)

PUBLIC_IP=$(echo "$VM_RESULT" | jq -r '.publicIpAddress')
log "VM created successfully. Public IP: $PUBLIC_IP"Offerto da

Questo template implementa gestione errori, logging e meccanismi di cleanup completi.

Sicurezza per l’automazione

Non inserire mai credenziali in chiaro negli script. Usa l’autenticazione basata su certificato quando possibile:

# Certificate-based authentication (recommended)
export ARM_CLIENT_ID="your-client-id"
export ARM_CERTIFICATE_PATH="/path/to/certificate.pem"
export ARM_TENANT_ID="your-tenant-id"

az login --service-principal -u "$ARM_CLIENT_ID" --certificate-path "$ARM_CERTIFICATE_PATH" --tenant "$ARM_TENANT_ID"

# Secret-based authentication (use only when certificates aren't feasible)
export ARM_CLIENT_ID="your-client-id"
export ARM_CLIENT_SECRET="your-client-secret"
export ARM_TENANT_ID="your-tenant-id"

az login --service-principal -u "$ARM_CLIENT_ID" -p "$ARM_CLIENT_SECRET" --tenant "$ARM_TENANT_ID"Offerto da

> Archivia i valori sensibili in Azure Key Vault e recuperali in modo programmatico. Preferisci i certificati ai segreti per una sicurezza superiore.

Integrazione in pipeline CI/CD

Esempio di pipeline YAML di Azure DevOps:

steps:
- task: AzureCLI@2
  displayName: 'Deploy Infrastructure'
  inputs:
    azureSubscription: 'Your-Service-Connection'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      set -euo pipefail
      echo "Creating resource group"
      az group create --name $(resourceGroup) --location $(location)Offerto da

Questa configurazione integra i comandi Azure CLI nelle pipeline di deployment automatizzate.

Esecuzione di pipeline riuscita in Azure DevOps con comandi Azure CLI per automatizzare il deployment dell’infrastruttura.

Problemi comuni di Azure CLI e troubleshooting

Anche i professionisti esperti incontrano errori di autenticazione, mismatch di versione e conflitti di configurazione che possono frenare la produttività. Capire i pattern comuni di errore e le strategie di risoluzione trasforma questi ostacoli da stopper del flusso di lavoro a semplici inconvenienti risolvibili in modo rapido e sicuro.

Errori di autenticazione

Problema: i miei script di automazione che usano az login --service-principal hanno improvvisamente smesso di funzionare a settembre 2025 con errori di autenticazione.

Soluzione: è il risultato diretto dell’applicazione obbligatoria dell’MFA. I service principal basati su password sono ora considerati un metodo legacy e meno sicuro. Devi migrare la tua automazione a un pattern conforme. Consulta la sezione Affrontare l’applicazione MFA di settembre 2025 qui sopra per il piano in quattro passaggi, concentrandoti su Workload Identity Federation o autenticazione basata su certificato.

Problema: "Esegui 'az login' per configurare l’account" persiste dopo un login riuscito.

Soluzione: cancella la cache di autenticazione e rieffettua il login:

Una sessione di debug mi ha insegnato il valore del flag --debug di Azure CLI quando si affrontano misteri di autenticazione. Quelle che sembravano anomalie casuali si sono rivelate problemi di proxy aziendale che interferivano con lo scambio di token. L’output di debug ha mostrato gli esatti endpoint HTTP bloccati, portando a una rapida risoluzione e risparmiando ore di congetture.

az account clear
az login --debug
az account list --output tableOfferto da

Questi comandi cancellano le credenziali in cache e forniscono un debugging dettagliato dell’autenticazione che rivela problemi di rete, certificati o policy.

Problemi di "comando non trovato"

Problema: "az: command not found" dopo l’installazione.

Soluzione: questo errore classico sorprende ancora sviluppatori navigati. Una volta ho perso un’ora intera per un errore "command not found" su una nuova VM Linux, per poi rendermi conto di aver dimenticato di eseguire source ~/.bashrc dopo l’installazione. È un errore semplice che capita anche ai veterani.

which az
echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrc
source ~/.bashrcOfferto da

Questi comandi individuano l’installazione di Azure CLI e aggiornano la configurazione PATH della shell.

Compatibilità di versione

Problema: gli script falliscono con errori "argument not recognized".

Soluzione: verifica la compatibilità della versione CLI e aggiorna come descritto nella nostra sezione di verifica versione:

az versionOfferto da

Questo comando mostra la versione corrente. Consulta la sezione installazione per i comandi di aggiornamento specifici per piattaforma.

Ricorda di mantenere Azure CLI aggiornata per accedere a nuove funzionalità e patch di sicurezza.

Suggerimenti avanzati per la produttività

La maestria va oltre l’esecuzione di base dei comandi e comprende tecniche di query sofisticate, ottimizzazione della configurazione e miglioramenti delle prestazioni che distinguono i professionisti esperti. Questi pattern avanzati diventano essenziali nella gestione di ambienti Azure su larga scala, dove efficienza e precisione incidono direttamente sul successo operativo.

Maestria nelle query JMESPath

Le query avanzate trasformano l’estrazione dei dati:

az vm list --query "[?tags.Environment=='production' && tags.Team=='backend'].{Name:name, Location:location, Size:hardwareProfile.vmSize}"Offerto da

Questa query avanzata filtra le VM per più condizioni sui tag ed estrae proprietà specifiche.

Trasforma JSON travolgenti in dati puliti e azionabili con una sola query JMESPath.

Gestione della configurazione

Personalizza il comportamento della CLI con impostazioni persistenti che fanno risparmiare tempo nelle operazioni ripetitive:

az configure --defaults output=table location=eastus group=myDefaultRG
az configure --list-defaultsOfferto da

Questi comandi impostano valori predefiniti per parametri comuni e mostrano la configurazione corrente. Queste impostazioni sono archiviate in ~/.azure/config e si applicano solo al tuo profilo utente, rendendole perfette per personalizzare l’esperienza Azure CLI senza influenzare altri utenti sullo stesso sistema.

Ottimizzazione delle prestazioni

Miglioramenti per operazioni su larga scala:

az vm list --query "[].name" --output tsv | xargs -I {} -P 10 az vm show --name {} --resource-group myRG
az vm start --name myVM --resource-group myRG --no-waitOfferto da

Questi comandi eseguono operazioni in parallelo e usano l’elaborazione asincrona per prestazioni migliori.

Conclusione

Padroneggiare Azure CLI semplifica la gestione del cloud, permettendoti di controllare le risorse in modo efficiente e automatizzare i workflow con sicurezza. Inizia con la modalità interattiva o Azure Cloud Shell, poi passa gradualmente agli script per deployment ripetibili.

Per sviluppare le tue competenze, dai un’occhiata a Understanding Microsoft Azure o al percorso Microsoft Azure Fundamentals (AZ-900)

Buona automazione, e brindiamo a workflow Azure più intelligenti e veloci!