Azure CLI-configuratie

Met de Azure CLI kunt u de gebruikersconfiguratie definiëren voor instellingen zoals logboekregistratie, het verzamelen van gegevens en standaardwaarden voor argumenten. De CLI biedt een handige opdracht voor het beheren van enkele standaardinstellingen az configen een interactieve optie via az init. Andere waarden kunnen worden ingesteld in een configuratiebestand of via omgevingsvariabelen. Dit artikel bevat meer informatie over deze gebruikersconfiguratie-instellingen en het configureren van de Azure CLI.

Configuratiewaarden die worden gebruikt door de CLI worden geëvalueerd in de volgende volgorde, waarbij items die hoger in de lijst staan een hogere prioriteit hebben.

1. Opdrachtregelparameters
2. Omgevingsvariabelen
3. Waarden in de configuratiebestandsset met az config of az init

Instellingen configureren met az init

De eenvoudigste manier om Azure CLI-configuraties in te stellen, is door de interactieve az init-opdracht te gebruiken. Kies een algemene configuratie, zoals 'interactie' of 'automatisering', of kies ervoor om afzonderlijke configuraties te doorlopen. Wat met name handig is bij deze aanpak, is az init redenen waarom u misschien een configuratieoptie boven een andere wilt kiezen.

az init

Instellingen configureren met az config

U kunt standaardwaarden voor de CLI instellen met de opdracht az config set . Met deze opdracht wordt een door spaties gescheiden lijst key=value met paren gebruikt als argument. De opgegeven waarden worden door de Azure CLI gebruikt in plaats van de vereiste argumenten.

De volgende tabel bevat een lijst met beschikbare configuratiesleutels.

Name	Beschrijving
defaults.group	De resourcegroep die standaard moet worden gebruikt voor alle opdrachten.
defaults.location	De locatie die standaard moet worden gebruikt voor alle opdrachten.
defaults.web	De app-naam die standaard moet worden gebruikt voor az webapp-opdrachten.
defaults.vm	De VM-naam die standaard moet worden gebruikt voor az vm-opdrachten.
defaults.vmss	De standaardnaam van de virtuele-machineschaalset (VMSS) die moet worden gebruikt voor az vmss opdrachten.
defaults.acr	De standaardnaam voor het containerregister die moet worden gebruikt voor az acr-opdrachten.

Een voorbeeld: dit is hoe u de standaard-resourcegroep en locatie voor alle opdrachten instelt.

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

Met de volgende opdracht worden de enquêtekoppelingen uitgeschakeld tijdens het uitvoeren van de Azure CLI-opdrachten:

az config set output.show_survey_link=no

CLI-configuratiebestand

Het CLI-configuratiebestand bevat andere instellingen die worden gebruikt voor het beheren van CLI-gedrag. Het configuratiebestand zelf bevindt zich op deze locatie: $AZURE_CONFIG_DIR/config. De standaardwaarde van AZURE_CONFIG_DIR is in Linux- en Mac OS $HOME/.azure en in Windows %USERPROFILE%\.azure.

Configuratiebestanden worden geschreven in de INI-bestandsindeling. Sectiekoppen definiëren de bestandsindeling, gevolgd door een lijst met sleutel-waarde-vermeldingen.

• Sectieheaders worden geschreven als [section-name]. Sectienamen zijn hoofdlettergevoelig.
• Vermeldingen worden geschreven als key=value. Sleutelnamen zijn niet hoofdlettergevoelig.
• Iedere regel die begint met een # of ; is een opmerking. Inlineopmerkingen zijn niet toegestaan.

Booleaanse waarden zijn hoofdlettergevoelig. De volgende waarden vertegenwoordigen booleaanse waarden:

• Waar: 1, yes, , trueon
• Onwaar: 0, no, , falseoff

Hier volgt een voorbeeld van een CLI-configuratiebestand dat bevestigingsprompts uitschakelt en logboekregistratie naar de map /var/log/azure instelt.

[core]
disable_confirm_prompt=Yes

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

Zie de volgende sectie voor meer informatie over alle beschikbare configuratiewaarden en hun betekenis. Zie voor een volledig overzicht van de INI-bestandsindeling, de Python-documentatie over INI.

CLI-configuratiewaarden en omgevingsvariabelen

De volgende tabel bevat alle secties en optienamen die in een configuratiebestand kunnen worden opgenomen. De bijbehorende omgevingsvariabelen worden ingesteld als AZURE_{section}_{name}, in hoofdletters. De standaardwaarde is bijvoorbeeld output ingesteld in de AZURE_CORE_OUTPUT variabele, de storage_account standaardwaarde batchai is ingesteld in de AZURE_BATCHAI_STORAGE_ACCOUNT variabele en de standaardwaarde location wordt ingesteld in de AZURE_DEFAULTS_LOCATIONcore variabele.

Wanneer u een standaardwaarde opgeeft, is dat argument niet meer vereist voor opdrachten. In plaats daarvan wordt de standaardwaarde gebruikt.

Sectie	Name	Type	Description
core	output	tekenreeks	De standaarduitvoerindeling. Toegestane waarden: json (standaard), jsonc, yaml, yamlc, table, , tsv. none Zie Uitvoerindelingen voor Azure CLI-opdrachten voor meer informatie.
	disable_confirm_prompt	boolean	Schakelt het vragen om bevestiging in/uit.
	display_region_identified	boolean	Azure-klanten kunnen ervoor kiezen om resources in veel verschillende regio's te implementeren. In sommige gevallen kunnen klanten de kosten verlagen door regio's in de buurt te selecteren die dezelfde services aanbieden. Als er een regio in de buurt wordt geïdentificeerd, wordt in een bericht de regio weergegeven die moet worden geselecteerd voor toekomstige implementaties. Met deze instelling bepaalt u of het bericht wordt weergegeven.
	collect_telemetry	boolean	Microsoft toestaan anonieme gegevens te verzamelen over het gebruik van de CLI. Zie de Azure CLI MIT-licentie voor privacyinformatie.
	only_show_errors	boolean	Alleen fouten weergeven tijdens het aanroepen van opdrachten. Met andere woorden, alleen fouten worden geschreven naar stderr. Het onderdrukt waarschuwingen van preview-, afgeschafte en experimentele opdrachten. Het is ook beschikbaar voor afzonderlijke opdrachten met de --only-show-errors parameter.
	no_color	boolean	Kleur uitschakelen. Oorspronkelijk gekleurde berichten worden voorafgegaan door DEBUG, INFOen WARNINGERROR. Deze Booleaanse waarde omzeilt het probleem van een bibliotheek van derden waarbij de kleur van de terminal niet kan worden teruggezet na een stdout omleiding.
Clients	show_secrets_warning	boolean	Schakel de waarschuwing voor uitvoer van gevoelige informatie in/uit.
logging	enable_log_file	boolean	Logboekregistratie in- of uitschakelen.
	log_dir	tekenreeks	De map waar logboeken worden opgeslagen. Standaard is deze waarde ingesteld op ${AZURE_CONFIG_DIR}/logs*.
Standaardinstellingen	groeperen	tekenreeks	De resourcegroep die standaard moet worden gebruikt voor alle opdrachten.
	locatie	tekenreeks	De locatie die standaard moet worden gebruikt voor alle opdrachten.
	web	tekenreeks	De app-naam die standaard moet worden gebruikt voor az webapp-opdrachten.
	vm	tekenreeks	De VM-naam die standaard moet worden gebruikt voor az vm-opdrachten.
	vmss	tekenreeks	De standaardnaam van de virtuele-machineschaalset (VMSS) die moet worden gebruikt voor az vmss opdrachten.
	acr	tekenreeks	De standaardnaam voor het containerregister die moet worden gebruikt voor az acr-opdrachten.
storage	Account	tekenreeks	De standaardnaam van het opslagaccount (bijvoorbeeld mystorageaccount in https://mystorageaccount.blob.core.windows.net) die moet worden gebruikt voor az storage opdrachten in het gegevensvlak (bijvoorbeeld az storage container list).
	sleutel	tekenreeks	De standaardtoegangssleutel die moet worden gebruikt voor az storage opdrachten in het gegevensvlak.
	sas_token	tekenreeks	Het standaard SAS-token dat moet worden gebruikt voor az storage gegevensvlakopdrachten.
	connection_string	tekenreeks	De standaard verbindingsreeks voor opdrachten in az storage het gegevensvlak.
batchai	storage_account	tekenreeks	Het opslagaccount dat standaard moet worden gebruikt voor az batchai-opdrachten.
	storage_key	tekenreeks	De opslagsleutel dat standaard moet worden gebruikt voor az batchai-opdrachten.
batch	Account	tekenreeks	De standaardaccountnaam voor Azure Batch die moet worden gebruikt voor opdrachten van az batch.
	access_key	tekenreeks	De standaardtoegangssleutel die moet worden gebruikt voor opdrachten van az batch. Alleen gebruikt met autorisatie via aad.
	endpoint	tekenreeks	Het standaardeindpunt om verbinding te maken voor opdrachten van az batch.
	auth_mode	tekenreeks	De autorisatiemodus die moet worden gebruikt voor opdrachten van az batch. Toegestane waarden: shared_key, aad.
Wolk	name	tekenreeks	De standaardcloud voor alle az opdrachten. Toegestane waarden: AzureCloud (standaard), AzureChinaCloud, AzureUSGovernment. Als u clouds wilt wijzigen, kunt u de az cloud set –name opdracht gebruiken. Zie Clouds beheren met de Azure CLI voor een voorbeeld.
Extensie	use_dynamic_install	tekenreeks	Installeer een extensie als deze nog niet is toegevoegd bij het uitvoeren van een opdracht. Toegestane waarden: no (standaard), yes_prompt, yes_without_prompt.
	run_after_dynamic_install	boolean	Ga door met het uitvoeren van de opdracht wanneer er dynamisch een extensie voor is geïnstalleerd. Standaard is False.
	index_url	tekenreeks	URL van het indexbestand met de persoonlijke extensie volgens de indeling in index.json. Zodra dit is opgegeven, wordt dat bestand gebruikt az extension add --name <extension-name> om de extensie te vinden die moet worden toegevoegd.

Notitie

Het is mogelijk dat er andere waarden in het configuratiebestand zijn opgenomen, maar deze worden beheerd via CLI-opdrachten, zoals az config. De waarden die eerder in de tabel worden vermeld, zijn de enige waarden die u zelf moet wijzigen.