Introduzione all'interfaccia della riga di comando di Azure

Introduzione all'interfaccia Command-Line di Azure Questo articolo presenta l'interfaccia della riga di comando e consente di completare le attività comuni.

Nota

Negli script e nel sito della documentazione Microsoft, gli esempi dell'interfaccia della riga di comando di Azure sono scritti per la shell bash. Gli esempi di una riga verranno eseguiti in qualsiasi piattaforma. Gli esempi più lunghi che includono continuazioni di riga (\) o l'assegnazione di variabili devono essere modificati per funzionare in altre shell, tra cui PowerShell.

Installazione o esecuzione in Azure Cloud Shell

Il modo più semplice per imparare a usare l'interfaccia della riga di comando di Azure consiste nell'eseguirlo in un ambiente di Cloud Shell di Azure tramite il browser. Per informazioni su Cloud Shell, vedere Avvio rapido per Bash in Azure Cloud Shell.

Quando si è pronti per installare l'interfaccia della riga di comando, vedere le istruzioni di installazione.

Dopo aver installato l'interfaccia della riga di comando per la prima volta, eseguire az --version per verificare se è installata e se la versione è corretta.

Nota

Se si usa il modello di distribuzione classica di Azure, installare l'interfaccia della riga di comando classica di Azure.

Come accedere all'interfaccia della riga di comando di Azure

Prima di usare qualsiasi comando dell'interfaccia della riga di comando di Azure con un'installazione locale, è necessario accedere con az login.

  1. Eseguire il comando login.

    az login
    

    Se l'interfaccia della riga di comando può aprire il browser predefinito, avvierà il flusso del codice di autorizzazione e aprirà il browser predefinito per caricare una pagina di accesso di Azure.

    In caso contrario, avvierà il flusso del codice del dispositivo e indicherà di aprire una pagina del browser all'indirizzo https://aka.ms/devicelogin e immettere il codice visualizzato nel terminale.

    Se non è disponibile alcun Web browser o non è possibile aprire il Web browser, è possibile forzare il flusso del codice del dispositivo con az login --use-device-code.

  2. Accedere con le credenziali dell'account nel browser.

Dopo l'accesso, viene visualizzato un elenco di sottoscrizioni associate all'account Azure. Le informazioni della sottoscrizione con isDefault: true rappresentano la sottoscrizione attualmente attivata dopo l'accesso. Per selezionare un'altra sottoscrizione, usare il comando az account set con l'ID sottoscrizione a cui passare. Per altre informazioni sulla selezione delle sottoscrizioni, vedere Usare più sottoscrizioni di Azure.

È possibile accedere in modo non interattivo, come illustrato nei dettagli in Accedere con l'interfaccia della riga di comando di Azure.

Comandi comuni dell'interfaccia della riga di comando di Azure

Questa tabella elenca alcuni comandi comuni usati nell'interfaccia della riga di comando e collegamenti alla relativa documentazione di riferimento.

Tipo di risorsa Gruppo di comandi dell'interfaccia della riga di comando di Azure
Gruppo di risorse az group
Macchine virtuali az vm
Account di archiviazione az storage account
Insieme di credenziali di chiave az keyvault
Applicazioni Web az webapp
Database SQL az sql server
Cosmos DB az cosmosdb

Ricerca dei comandi

I comandi dell'interfaccia della riga di comando di Azure sono organizzati come comandi di gruppi. Ogni gruppo rappresenta un servizio di Azure e i comandi operano su tale servizio.

Per cercare i comandi, usare az find. Per cercare i nomi dei comandi contenenti secret, ad esempio, usare il comando seguente:

az find secret

Usare l'argomento --help per ottenere un elenco completo di comandi e sottogruppi di un gruppo. Ad esempio, per trovare i comandi dell'interfaccia della riga di comando per l'uso di gruppi di sicurezza di rete:

az network nsg --help

L'interfaccia della riga di comando offre il completamento tramite tasto TAB per tutti i comandi nella shell bash.

Argomenti disponibili a livello globale

Alcuni argomenti sono disponibili per tutti i comandi.

  • --help stampa le informazioni di riferimento dell'interfaccia della riga di comando sui comandi e i relativi argomenti ed elenca i sottogruppi e i comandi disponibili.
  • --output modifica il formato di output. I formati di output disponibili sono json, jsonc (codice JSON colorato), tsv (valori delimitati da tabulazioni), table (tabelle ASCII leggibili) e yaml. Per impostazione predefinita, l'output dell'interfaccia della riga di comando è in formato json. Per altre informazioni sui formati di output disponibili, vedere Formati di output per l'interfaccia della riga di comando di Azure.
  • --query usa il linguaggio di query JMESPath per filtrare l'output restituito dai servizi di Azure. Per altre informazioni sulle query, vedere Eseguire query sui risultati dei comandi con l'interfaccia della riga di comando di Azure e l'esercitazione su JMESPath.
  • --verbose stampa le informazioni sulle risorse create in Azure durante un'operazione e altre informazioni utili.
  • --debug stampa una quantità ancora maggiore di informazioni sulle operazioni dell'interfaccia della riga di comando, che vengono usate a scopo di debug. Se si rilevano bug, fornire l'output generato con il flag --debug attivato quando si invia la segnalazione.

Modalità interattiva

L'interfaccia della riga di comando offre una modalità interattiva che visualizza automaticamente le informazioni della Guida e facilita la selezione dei sottocomandi. La modalità interattiva viene attivata con il comando az interactive.

az interactive

Per altre informazioni sulla modalità interattiva, vedere Modalità interattiva dell'interfaccia della riga di comando di Azure.

È anche disponibile un plug-in Visual Studio Code che offre un'esperienza interattiva con completamento automatico e documentazione al passaggio del mouse.

Guide introduttive ed esercitazioni per apprendere le nozioni di base dell'interfaccia della riga di comando

Per informazioni su come usare l'interfaccia della riga di comando di Azure, provare un'esercitazione approfondita per configurare le macchine virtuali e usare la potenza dell'interfaccia della riga di comando per eseguire query sulle risorse di Azure.

Sono anche disponibili guide introduttive per altri servizi noti.

Invia commenti

I commenti e i suggerimenti degli utenti in merito all'interfaccia della riga di comando sono molto apprezzati, perché consentiranno di apportare miglioramenti e risolvere bug. È possibile segnalare un problema in GitHub oppure usare le funzionalità predefinite dell'interfaccia della riga di comando per lasciare un feedback generico con il comando az feedback.

az feedback

Vedi anche