Condividi tramite

Configurazione dell'interfaccia della riga di comando di Azure

  • Articolo

L'interfaccia della riga di comando di Azure consente la configurazione utente per impostazioni quali registrazione, raccolta dati e valori di argomento predefiniti. L'interfaccia della riga di comando offre un comando pratico per gestire alcune impostazioni predefinite, az confige un'opzione interattiva tramite az init. Altri valori possono essere impostati in un file di configurazione o con variabili di ambiente. Questo articolo fornisce altre informazioni su queste impostazioni di configurazione utente e su come configurare l'interfaccia della riga di comando di Azure.

I valori di configurazione usati dall'interfaccia della riga di comando vengono valutati nell'ordine di precedenza seguente, con priorità agli elementi nella parte superiore dell'elenco.

  1. Parametri della riga di comando
  2. Variabili di ambiente
  3. Valori nel file di configurazione impostato con az config o az init

Configurare le impostazioni con az init

Il modo più semplice per impostare le configurazioni dell'interfaccia della riga di comando di Azure consiste nell'usare il comando az init interattivo. Scegliere una configurazione comune, ad esempio "interazione" o "automazione", oppure scegliere di esaminare le singole configurazioni. Ciò che è particolarmente utile con questo approccio è az init il motivo per cui è consigliabile scegliere un'opzione di configurazione rispetto a un'altra.

az init

Configurare le impostazioni usando az config

È possibile impostare le impostazioni predefinite per l'interfaccia della riga di comando con il comando az config set . Questo comando accetta un elenco delimitato da spazi di key=value coppie come argomento. I valori forniti vengono usati dall'interfaccia della riga di comando di Azure al posto degli argomenti obbligatori.

La tabella seguente contiene un elenco delle chiavi di configurazione disponibili.

Nome Descrizione
gruppo di impostazioni predefinite Gruppo di risorse predefinito da usare per tutti i comandi.
impostazioni.predefinite.posizione Percorso predefinito da usare per tutti i comandi.
defaults.web Nome predefinito dell'app da usare per i comandi az webapp.
defaults.vm Nome predefinito della VM da usare per i comandi az vm.
defaults.vmss Nome predefinito del set di scalabilità di macchine virtuali da usare per i comandi az vmss.
defaults.acr Nome predefinito del registro contenitori da usare per i comandi az acr.

Ad esempio, ecco come impostare il gruppo di risorse predefinito e il percorso predefinito per tutti i comandi.

az config set defaults.location=westus2 defaults.group=MyResourceGroup

Il comando seguente disattiva i collegamenti al sondaggio durante l'esecuzione dei comandi dell'interfaccia della riga di comando di Azure:

az config set output.show_survey_link=no

File di configurazione CLI

Il file di configurazione dell'interfaccia della riga di comando contiene altre impostazioni che vengono usate per gestire il comportamento dell'interfaccia della riga di comando. Il file di configurazione stesso si trova in $AZURE_CONFIG_DIR/config. Il valore predefinito di AZURE_CONFIG_DIR è $HOME/.azure su Linux e macOS e %USERPROFILE%\.azure su Windows.

I file di configurazione vengono scritti nel formato di file INI. Le intestazioni di sezione definiscono il formato di file, seguito da un elenco di voci chiave-valore.

  • Le intestazioni di sezione vengono redatte come [section-name]. I nomi delle sezioni distinguono tra maiuscole e minuscole.
  • Le voci vengono scritte come key=value. I nomi delle chiavi non sono case-sensitive.
  • I commenti corrispondono a qualsiasi riga che inizia con # o ;. I commenti inline non sono consentiti.

I valori booleani non fanno distinzione tra maiuscole e minuscole. I valori seguenti rappresentano valori booleani:

  • True: 1, yes, true, on
  • False: 0, no, false, off

Di seguito è riportato un esempio di file di configurazione dell'interfaccia della riga di comando che disabilita qualsiasi richiesta di conferma e imposta la registrazione nella directory /var/log/azure.

[core]
disable_confirm_prompt=Yes

[logging]
enable_log_file=yes
log_dir=/var/log/azure

Vedere la sezione seguente per informazioni dettagliate su tutti i valori di configurazione disponibili e sul rispettivo significato. Per dettagli completi sul formato di file INI, vedere la documentazione di Python su INI.

Valori di configurazione dell'interfaccia della riga di comando e variabili di ambiente

La tabella seguente contiene tutte le sezioni e i nomi di opzione che è possibile inserire in un file di configurazione. Le variabili di ambiente corrispondenti vengono impostate come AZURE_{section}_{name}, in lettere maiuscole. Ad esempio, il valore predefinito di output per core viene impostato nella variabile AZURE_CORE_OUTPUT, mentre il valore predefinito di storage_account per batchai viene impostato nella variabile AZURE_BATCHAI_STORAGE_ACCOUNT e il valore predefinito di location viene impostato nella variabile AZURE_DEFAULTS_LOCATION.

Quando si specifica un valore predefinito, questo argomento non è più richiesto da alcun comando. Viene invece usato il valore predefinito.

Sezione Nome TIPO Descrizione
nucleo prodotto corda Formato di output predefinito. Valori consentiti: json (impostazione predefinita), jsonc, yamlyamlc, , table, tsv, none. Per altre informazioni, vedere Formati di output per i comandi dell'interfaccia della riga di comando di Azure.
disable_confirm_prompt booleano Consente di attivare o disattivare i prompt di conferma.
regione_di_visualizzazione_identificata booleano I clienti di Azure possono scegliere di distribuire risorse in molte aree diverse. In alcuni casi, i clienti potrebbero essere in grado di ridurre i costi selezionando le aree vicine che offrono gli stessi servizi. Se viene identificata un'area vicina, verrà visualizzata l'area da selezionare per le distribuzioni future. Questa impostazione controlla se il messaggio viene visualizzato.
collect_telemetry booleano Consente a Microsoft di raccogliere dati anonimi sull'utilizzo dell'interfaccia della riga di comando. Per informazioni sulla privacy, vedere la licenza MIT dell'interfaccia della riga di comando di Azure.
mostra_solo_errori booleano Mostra solo gli errori durante la chiamata del comando. In altre parole, solo gli errori vengono scritti in stderr. Sopprime gli avvisi relativi a comandi di anteprima, deprecati e sperimentali. È disponibile anche per i singoli comandi con il --only-show-errors parametro .
abilita broker su Windows booleano Usare Web Account Manager (WAM) per eseguire l'autenticazione in Azure tramite il az login comando .
esperienza_di_accesso_v2 booleano Attivare/disattivare il az login selettore di sottoscrizione.
nessun_colore booleano Disabilita il colore. I messaggi originariamente colorati sono preceduti da DEBUG, INFOWARNINGe ERROR. Questo valore booleano ignora il problema di una libreria di terze parti in cui il colore del terminale non può tornare indietro dopo un stdout reindirizzamento.
Clienti mostra_avviso_segreti booleano Attivare/disattivare l'avviso per l'output delle informazioni riservate.
registrazione abilita_file_di_log booleano Consente di attivare o disattivare la registrazione.
log_dir corda Directory in cui scrivere i registri. Per impostazione predefinita, questo valore è ${AZURE_CONFIG_DIR}/logs*.
Impostazioni predefinite gruppo corda Gruppo di risorse predefinito da usare per tutti i comandi.
ubicazione corda Percorso predefinito da usare per tutti i comandi.
web corda Nome predefinito dell'app da usare per i comandi az webapp.
Vm corda Nome predefinito della VM da usare per i comandi az vm.
vmss corda Nome predefinito del set di scalabilità di macchine virtuali da usare per i comandi az vmss.
acr corda Nome predefinito del registro contenitori da usare per i comandi az acr.
archiviazione Conto corda Nome dell'account di archiviazione predefinito (ad esempio, mystorageaccount in https://mystorageaccount.blob.core.windows.net) da usare per i comandi del piano dati (az storage ad esempio, az storage container list).
chiave corda Chiave di accesso predefinita da usare per i comandi del piano dati di az storage.
sas_token corda Token SAS predefinito da usare per az storage i comandi del data plane.
stringa_di_connessione corda La stringa di connessione predefinita da usare per az storage i comandi del piano dei dati.
batchai account di archiviazione corda Account di archiviazione predefinito da usare per i comandi az batchai.
chiave_archiviazione corda Chiave di archiviazione predefinita da usare per i comandi az batchai.
lotto Conto corda Nome dell'account Azure Batch predefinito da usare per i comandi az batch.
chiave di accesso corda Chiave di accesso predefinita da usare per i comandi az batch. Usata solo con l'autorizzazione aad.
punto finale corda Endpoint predefinito a cui connettersi per i comandi az batch.
modalità di autenticazione corda Modalità di autorizzazione da usare per i comandi az batch. Valori consentiti: shared_key, aad.
cloud nome corda Il cloud predefinito per tutti i comandi az. Valori consentiti: AzureCloud (impostazione predefinita), AzureChinaCloud, AzureUSGovernment. Per cambiare cloud, è possibile usare il comando az cloud set -–name. Per un esempio, vedere Gestire i cloud con l'interfaccia della riga di comando di Azure.
estensione usa_installazione_dinamica corda Installa un'estensione se non è ancora stata aggiunta al momento dell'esecuzione di un comando da essa. Valori consentiti: no (impostazione predefinita), yes_prompt, yes_without_prompt.
esegui_dopo_installazione_dinamica booleano Continua a eseguire il comando quando viene installata dinamicamente una relativa estensione. Il valore predefinito è False.
index_url corda URL del file di indice dell'estensione privato che segue il formato in index.json. Una volta specificato, l'esecuzione az extension add --name <extension-name> usa tale file per trovare l'estensione da aggiungere.

Annotazioni

Potrebbero essere visualizzati altri valori nel file di configurazione, ma questi vengono gestiti direttamente tramite i comandi dell'interfaccia della riga di comando, tra cui az config. Quelli elencati nella tabella in precedenza sono gli unici valori che è necessario modificare manualmente.