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 bevat een handige opdracht voor het beheren van sommige standaardinstellingen, az config. Andere waarden kunnen worden ingesteld in een configuratiebestand of via omgevingsvariabelen. In dit artikel vindt u meer informatie over deze gebruikersconfiguratie-instellingen en over 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
- Persistente waarden voor parameters instellen met
az config param-persist - Omgevingsvariabelen
- Waarden in de configuratiebestandsset met
az config
CLI-configuratie met az config
U stelt de standaardwaarden voor de CLI in met de opdracht az config set.
Met deze opdracht wordt een door spatie gescheiden lijst key=value met paren als argument gebruikt. De opgegeven waarden worden in plaats van de vereiste argumenten gebruikt door de CLI.
De volgende tabel bevat een lijst met beschikbare configuratiesleutels.
| Naam | 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 naam van de standaard 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
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. De bestandsindeling wordt gedefinieerd door sectiekoppen, 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 niet hoofdlettergevoelig en worden vertegenwoordigd door de volgende waarden.
- Waar:
1, , ,yestrue,on - Onwaar:
0, ,nofalse,off
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 voor is bijvoorbeeld ingesteld in de variabele , de standaardwaarde voor is ingesteld in de variabele en de standaardwaarde output is ingesteld in de variabele core AZURE_CORE_OUTPUT storage_account batchai AZURE_BATCHAI_STORAGE_ACCOUNT location AZURE_DEFAULTS_LOCATION .
Wanneer u een standaardwaarde opgeeft, is dat argument niet meer vereist voor opdrachten. In plaats daarvan wordt de standaardwaarde gebruikt.
| Sectie | Naam | Type | Description |
|---|---|---|---|
| Core | output | tekenreeks | De standaarduitvoerindeling. Kan json, jsonc, tsv of table zijn. |
| disable_confirm_prompt | booleaans | Schakelt het vragen om bevestiging in/uit. | |
| collect_telemetry | booleaans | Microsoft toestaan anonieme gegevens te verzamelen over het gebruik van de CLI. Zie de Azure CLI MIT-licentie voor informatie over privacy. | |
| alleen _ fouten _ tonen | booleaans | Er worden alleen fouten tijdens het aanroepen van de opdracht weer gegeven. Met andere woorden, alleen fouten worden naar stderr geschreven. Het onderdrukt waarschuwingen van preview-, afgeschafte en experimentele opdrachten. Het is ook beschikbaar voor afzonderlijke opdrachten met de --only-show-errors parameter . |
|
| geen _ kleur | booleaans | Kleur uitschakelen. Oorspronkelijk gekleurde berichten krijgen het voorvoegsel DEBUG , INFO en WARNING ERROR . Hiermee wordt het probleem van een bibliotheek van derden overgeslagen waarbij de kleur van de terminal na een omleiding niet terug kan stdout worden teruggedraaid. |
|
| logboekregistratie | enable_log_file | booleaans | Logboekregistratie in- of uitschakelen. |
| log_dir | tekenreeks | De map waar logboeken worden opgeslagen. Standaard is deze waarde ingesteld op ${AZURE_CONFIG_DIR}/logs*. |
|
| Standaardinstellingen | group | tekenreeks | De resourcegroep die standaard moet worden gebruikt voor alle opdrachten. |
| location | 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. |
|
| Opslag | account | tekenreeks | De standaardnaam van het opslagaccount (bijvoorbeeld mystorageaccount in om te gebruiken voor https://mystorageaccount.blob.core.windows.net) az storage gegevensvlakopdrachten (bijvoorbeeld az storage container list ). |
| sleutel | tekenreeks | De standaardtoegangssleutel die moet worden gebruikt voor az storage gegevensvlakopdrachten. |
|
| sas_token | tekenreeks | Het standaard SAS-token dat moet worden gebruikt voor az storage gegevensvlakopdrachten. |
|
| connection_string | tekenreeks | De standaardinstelling connection string te gebruiken voor az storage gegevensvlakopdrachten. |
|
| 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. Deze waarde kan shared_key of aad zijn. |
|
| Wolk | naam | tekenreeks | De standaardcloud voor alle az opdrachten. De mogelijke waarden zijn AzureCloud (standaard), AzureChinaCloud , AzureUSGovernment , AzureGermanCloud . Als u clouds wilt wijzigen, kunt u de opdracht az cloud set –name gebruiken. Zie Manage Clouds with the Azure CLI (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. De mogelijke waarden zijn no (standaard), yes_prompt , yes_without_prompt . |
| run_after_dynamic_install | booleaans | Ga door met het uitvoeren van de opdracht wanneer er dynamisch een extensie voor wordt geïnstalleerd. De standaardinstelling is False. |
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 in de bovenstaande tabel zijn de enige waarden die u zelf dient te wijzigen.