Delen via


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_LOCATION core 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.
enable_broker_on_windows boolean Gebruik WaM (Web Account Manager) om via de az login opdracht te verifiëren bij Azure.
login_experience_v2 boolean Schakel de az login abonnementskiezer in/uit.
no_color boolean Kleur uitschakelen. Oorspronkelijk gekleurde berichten worden voorafgegaan door DEBUG, INFOen WARNING ERROR. 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 naam 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.