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.
- Opdrachtregelparameters
- Omgevingsvariabelen
- Waarden in de configuratiebestandsset met
az configofaz 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.
