Introduzione all'interfaccia della riga di comando di Azure

Articolo
2025-05-10

L'interfaccia della riga di comando di Azure è uno strumento multipiattaforma che semplifica la gestione delle risorse di Azure dalla riga di comando. Ottimizzato per l'automazione e la facilità d'uso, supporta sessioni interattive e scripting con comandi semplici che si integrano perfettamente con il modello di Azure Resource Manager. È possibile iniziare a usarlo nel browser con Azure Cloud Shell o installarlo in locale per usarlo dal terminale preferito.

Installare o eseguire in Azure Cloud Shell

Il modo più semplice per provare l'interfaccia della riga di comando di Azure consiste nell'usare Azure Cloud Shell, una shell basata su browser senza alcuna installazione necessaria. Cloud Shell supporta Bash e PowerShell e include la versione più recente dell'interfaccia della riga di comando di Azure preinstallata.

Per installare l'interfaccia della riga di comando di Azure in locale, vedere Come installare l'interfaccia della riga di comando di Azure.

Per controllare la versione, eseguire:

az version

Per iniziare a usare l'interfaccia della riga di comando di Azure con un'installazione locale, accedere:

Eseguire il comando az login.
```
az login
```
Se l'interfaccia della riga di comando di Azure può aprire il browser predefinito, avvia il flusso del codice di autorizzazione e apre il browser predefinito per caricare una pagina di accesso di Azure.

In caso contrario, avvia il flusso di codice del dispositivo e ti istruisce ad aprire una pagina del browser su . Immettere quindi il codice visualizzato nel terminale.

Se non è disponibile alcun Web browser o l'apertura del Web browser non riesce, è possibile forzare il flusso del codice del dispositivo con az login --use-device-code.
Accedere con le credenziali dell'account nel browser.

Importante

A partire dal 2025, Microsoft applichererà l'autenticazione a più fattori obbligatoria per l'interfaccia della riga di comando di Azure e altri strumenti da riga di comando. L'autenticazione a più fattori influirà solo sulle identità utente di Microsoft Entra ID. Non influirà sulle identità del carico di lavoro, come i principali del servizio e le identità gestite .

Se si usa az login con un ID Entra e una password per autenticare uno script o un processo automatizzato, inizi a pianificare ora la migrazione a un'identità di carico di lavoro. Per altre informazioni, vedere L'impatto dell'autenticazione a più fattori nell'interfaccia della riga di comando di Azure negli scenari di automazione.

Dopo l'accesso, viene visualizzato un elenco delle sottoscrizioni. Quello contrassegnato isDefault: true è attualmente attivo. Per passare a una sottoscrizione diversa, eseguire:

az account set --subscription "<subscription-id>"

Per altre informazioni sulla selezione della sottoscrizione, vedere Gestire le sottoscrizioni di Azure. Per le opzioni di accesso avanzate, vedere Accedere con l'interfaccia della riga di comando di Azure.

Trova comandi

I comandi dell'interfaccia della riga di comando di Azure sono organizzati come gruppi di comandi. Ogni gruppo rappresenta un'area di un servizio di Azure. Sono disponibili due opzioni per trovare i gruppi di comandi:

Usare il comando az find . Ad esempio, per cercare i nomi dei comandi contenenti vm, usare l'esempio seguente:
```
az find vm
```

Usare l'argomento --help per ottenere un elenco completo di sottogruppi all'interno di un gruppo di riferimento. Nell'esempio seguente vengono restituiti tutti i sottogruppi per le macchine virtuali:

az vm --help

Nell'esempio seguente viene illustrata la parte pertinente dell'output.

Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...

L'output della guida include sottogruppi, parametri, opzioni di autenticazione ed esempi.

Ecco un altro esempio che trova i comandi di Azure CLI per raggruppare le macchine virtuali in set di disponibilità, un sottogruppo di az vm:

az vm availability-set --help

È anche possibile usare --help per ottenere elenchi di parametri ed esempi di comandi per un comando di riferimento.

az vm create --help

Ecco la sezione pertinente dell'output di esempio:

Arguments
    --name  [Required] : Name of the virtual machine.
    ...
Authentication Arguments
    --admin-password   : Password for the VM if authentication type is 'Password'.
    --admin-username   : Username for the VM...
    ...
Managed Service Identity Arguments
    ...
Examples
    Create a VM from a custom managed image.
      az vm create -g MyResourceGroup -n MyVm --image MyImage
    ...

Usare l'indice di riferimento che elenca tutti i gruppi di comandi in ordine alfabetico.

Esplorare esempi e articoli

Per esempi di utilizzo, vedere:

Indice degli esempi per l'interfaccia della riga di comando di Azure per argomento, gruppo di riferimento o repository GitHub.

Indice articolo per trovare guide approfondite. Usare i find tasti di scelta rapida, ad esempio Ctrl + F, per trovare rapidamente il gruppo di comandi di riferimento a cui si è interessati. Ad esempio, l'indice dell'articolo per az vm è simile alla tabella seguente:

Sottogruppo di riferimento	Articolo sull'Azure CLI che illustra l'uso di comandi di riferimento
az vm	Formati di output per i comandi CLI di Azure
	Come usare le variabili nei comandi dell'interfaccia della riga di comando di Azure
	Ottenere informazioni sulla macchina virtuale con query
	{Altri articoli elencati qui.}
az vm aem	Nuova versione dell'estensione vm di Azure per soluzioni SAP
	Versione standard dell'estensione vm di Azure per soluzioni SAP
az vm application	{...}

Usare il completamento tramite tabulazione

L'interfaccia della riga di comando di Azure supporta il completamento delle schede in Bash. Per abilitarla in PowerShell, vedere Abilitare il completamento della scheda in PowerShell.

Comprendere gli argomenti globali

Gli argomenti comuni disponibili per la maggior parte dei comandi includono:

Argomentazione	Descrizione
`--help`	Visualizzare l'aiuto dei comandi
`--output`	Modificare il formato di output: `json`, `jsonc`, `tsv`, `table`, `yaml`
`--query`	Filtrare l'output con JMESPath
`--verbose`	Stampare altri dettagli di esecuzione
`--debug`	Mostra chiamate REST di basso livello per il debug
`--subscription`	Specificare il nome o l'ID della sottoscrizione
`--only-show-errors`	Eliminare l'output non critico

Per altre informazioni, vedere Formati di output e Risultati delle query.

Usare la modalità interattiva

Eseguire la modalità interattiva con:

az interactive

La modalità interattiva avvia un'esperienza avanzata dell'interfaccia della riga di comando di Azure con aiuto integrato e comandi suggeriti. Per altre informazioni, vedi Modalità interattiva.

Un'estensione facoltativa di VS Code offre funzionalità simili con completamento automatico e suggerimenti al passaggio del mouse.

Impara attraverso esercitazioni e guide introduttive

Scopri le basi pratiche dell'interfaccia della riga di comando di Azure con l'esercitazione sull'onboarding. Scopri come:

Annotazioni

Gli esempi dell'interfaccia della riga di comando di Azure in Microsoft Learn sono scritti per Bash. Le one-liner in genere funzionano su shell diverse, ma gli script su più righe potrebbero necessitare modifiche. Per altre informazioni, vedere Informazioni sulle differenze di sintassi tra Bash, PowerShell e Cmd

Inviare commenti

I commenti e i suggerimenti degli utenti sono benvenuti. Inviare problemi in GitHub o eseguire:

az feedback

Condividi tramite