Condividi tramite

Configurazione dell'interfaccia della riga di comando di Azure

  • Articolo

L'interfaccia della riga di comando di Azure consente all'utente di configurare impostazioni come registrazione, raccolta di dati e valori predefiniti degli argomenti. 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
defaults.group Gruppo di risorse predefinito da usare per tutti i comandi.
defaults.location 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 dell'interfaccia della riga di comando

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 scritte come [section-name]. I nomi delle sezioni distinguono tra maiuscole e minuscole.
  • Le voci vengono scritte come key=value. I nomi delle chiavi non fanno distinzione tra maiuscole e minuscole.
  • 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
core output string Formato di output predefinito. Valori consentiti: json (impostazione predefinita), jsonc, yamlcyaml, , table, tsv, none. Per altre informazioni, vedere Formati di output per i comandi dell'interfaccia della riga di comando di Azure.
disable_confirm_prompt boolean Consente di attivare o disattivare i prompt di conferma.
display_region_identified boolean I clienti di Azure possono scegliere di distribuire risorse in molte aree diverse. In alcuni casi, i clienti possono 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 boolean 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.
only_show_errors boolean Mostra solo gli errori durante la chiamata del comando. In altre parole, solo gli errori vengono scritti in stderr. Elimina gli avvisi dai comandi di anteprima, deprecati e sperimentali. È disponibile anche per i singoli comandi con il --only-show-errors parametro .
enable_broker_on_windows boolean Usare Web Account Manager (WAM) per eseguire l'autenticazione in Azure tramite il az login comando .
login_experience_v2 boolean Attivare/disattivare il az login selettore di sottoscrizione.
no_color boolean Disabilita il colore. I messaggi originariamente colorati sono preceduti da DEBUG, WARNING INFOe 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 show_secrets_warning boolean Attivare/disattivare l'avviso per l'output delle informazioni riservate.
logging enable_log_file boolean Consente di attivare o disattivare la registrazione.
log_dir string Directory in cui scrivere i log. Per impostazione predefinita, questo valore è ${AZURE_CONFIG_DIR}/logs*.
defaults group string Gruppo di risorse predefinito da usare per tutti i comandi.
location string Percorso predefinito da usare per tutti i comandi.
web string Nome predefinito dell'app da usare per i comandi az webapp.
vm string Nome predefinito della VM da usare per i comandi az vm.
vmss string Nome predefinito del set di scalabilità di macchine virtuali da usare per i comandi az vmss.
acr string Nome predefinito del registro contenitori da usare per i comandi az acr.
storage Account string Nome dell'account di archiviazione predefinito (ad esempio, mystorageaccount in https://mystorageaccount.blob.core.windows.net) da usare per az storage i comandi del piano dati (ad esempio, az storage container list).
chiave string Chiave di accesso predefinita da usare per az storage i comandi del piano dati.
sas_token string Token di firma di accesso condiviso predefinito da usare per az storage i comandi del piano dati.
connection_string string Il stringa di connessione predefinito da usare per az storage i comandi del piano dati.
batchai storage_account string Account di archiviazione predefinito da usare per i comandi az batchai.
storage_key string Chiave di archiviazione predefinita da usare per i comandi az batchai.
batch Account string Nome dell'account Azure Batch predefinito da usare per i comandi az batch.
access_key string Chiave di accesso predefinita da usare per i comandi az batch. Usata solo con l'autorizzazione aad.
endpoint string Endpoint predefinito a cui connettersi per i comandi az batch.
auth_mode string Modalità di autorizzazione da usare per i comandi az batch. Valori consentiti: shared_key, aad.
cloud name string 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.
extension use_dynamic_install string Installa un'estensione se non è stata ancora aggiunta durante l'esecuzione di un comando. Valori consentiti: no (impostazione predefinita), yes_prompt, yes_without_prompt.
run_after_dynamic_install boolean Continua a eseguire il comando quando viene installata dinamicamente una relativa estensione. Il valore predefinito è False.
index_url string 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.

Nota

È possibile che nel file di configurazione vengano visualizzati altri valori, ma tali valori vengono gestiti direttamente tramite i comandi dell'interfaccia della riga di comando, incluso az config. Quelli elencati nella tabella in precedenza sono gli unici valori che è necessario modificare manualmente.