Konfiguration av Azure CLI

  • Artikel
  • 4 minuter för att läsa

Azure CLI tillåter användarkonfiguration av inställningar som loggning, insamling av data och standardvärden för argument. CLI har ett bekvämlighetskommando för att hantera vissa standardvärden, az config. Andra värden kan anges i en konfigurationsfil eller med miljövariabler. Den här artikeln innehåller ytterligare information om dessa användarkonfigurationsinställningar och hur du konfigurerar Azure CLI.

Konfigurationsvärden som används av CLI utvärderas med följande prioritet, där poster som är högre upp på listan prioriteras.

  1. Kommandoradsparametrar
  2. Kvarständiga parametervärden som angetts med az config param-persist
  3. Miljövariabler
  4. Värden i konfigurationsfilen med az config

CLI-konfiguration med az config

Du anger standardinställningar för CLI med kommandot az config set. Det här kommandot tar en blankstegsavgränsad key=value lista med par som argument. De angivna värdena används av CLI istället för obligatoriska argument.

Följande tabell innehåller en lista över tillgängliga konfigurationsnycklar.

Name Beskrivning
defaults.group Standardresursgruppen som ska användas för alla kommandon.
defaults.location Standardplatsen som ska användas för alla kommandon.
defaults.web Standardappnamnet som ska användas för alla az webapp-kommandon.
defaults.vm Standardnamnet för VM som ska användas för alla az vm-kommandon.
defaults.vmss Standardnamnet för VM-skalningsuppsättningar (VMSS) som ska användas för az vmss-kommandon.
defaults.acr Standardcontainerregistret som ska användas för alla az acr-kommandon.

Här är ett exempel på hur du skulle ställa in standardresursgruppen och -platsen för alla kommandon.

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

CLI-konfigurationsfil

CLI-konfigurationsfilen innehåller övriga inställningar som används för att hantera CLI-beteende. Själva konfigurationsfilen finns på $AZURE_CONFIG_DIR/config. Standardvärdet för AZURE_CONFIG_DIR är $HOME/.azure på Linux and macOS, och %USERPROFILE%\.azure för Windows.

Konfigurationsfiler skrivs i INI-format. Det här filformatet definieras av avsnittsrubriker, följt av en lista över nyckel/värde-poster.

  • Avsnittsrubrikerna skrivs som [section-name]. Avsnittsnamn är skiftlägeskänsliga.
  • Poster skrivs som key=value. Nyckelnamnen är inte skiftlägeskänsliga.
  • Kommentarer är alla rader som börjar med # eller ;. Infogade kommentarer tillåts inte.

Booleska värden är skiftlägeskänsliga och representeras av följande värden.

  • Sant: 1 , yes , true , on
  • Falskt: 0 , no , false , off

Här är ett exempel på en CLI-konfigurationsfil som inaktiverar bekräftelseuppmaningar och ställer in loggning till katalogen /var/log/azure.

[core]
disable_confirm_prompt=Yes

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

I nästa avsnitt finns information om alla tillgängliga konfigurationsvärden och vad de betyder. Fullständig information om INI-filformatet finns i Python-dokumentationen om INI.

CLI-konfigurationsvärden och miljövariabler

I följande tabell finns alla avsnitt och alternativnamn som kan placera i en konfigurationsfil. Deras motsvarande miljövariabler anges som AZURE_{section}_{name}, i versaler. Standardvärdet för anges till exempel i variabeln, standardvärdet för anges i variabeln och output core AZURE_CORE_OUTPUT storage_account batchai AZURE_BATCHAI_STORAGE_ACCOUNT location standardvärdet anges i AZURE_DEFAULTS_LOCATION variabeln .

När du anger ett standardvärde krävs inte längre det argumentet av något kommando. I stället används standardvärdet.

Avsnitt Namn Typ Description
Core utdata sträng Format för standardutdata. Kan vara något av json, jsonc, tsv eller table.
inaktivera_bekräfta_uppmana boolean Aktivera/inaktivera bekräftelsemeddelanden.
samla in_telemetri boolean Tillåt att Microsoft samlar in anonyma data om CLI-användning. Sekretessinformation finns i Azure CLI MIT-licensen.
visa _ _ endast fel boolean Visa endast fel under kommandoanrop. Med andra ord skrivs endast fel till stderr . Den ignorerar varningar från förhandsversionen, inaktuella och experimentella kommandon. Det är också tillgängligt för enskilda kommandon med --only-show-errors parametern .
ingen _ färg boolean Inaktivera färg. Ursprungligen färgade meddelanden föregås av DEBUG , INFO och WARNING ERROR . Detta kringgår problemet med ett bibliotek från tredje part där terminalens färg inte kan återställas efter en stdout omdirigering.
logging aktivera_loggfil_ boolean Slå på/av loggning.
logg_katalog sträng Katalogen som loggar ska skrivas i. Det här värdet är som standard ${AZURE_CONFIG_DIR}/logs*.
standardvärden group sträng Standardresursgruppen som ska användas för alla kommandon.
location sträng Standardplatsen som ska användas för alla kommandon.
webb sträng Standardappnamnet som ska användas för alla az webapp-kommandon.
vm sträng Standardnamnet för VM som ska användas för alla az vm-kommandon.
vmss sträng Standardnamnet för VM-skalningsuppsättningen (VMSS) som ska användas för az vmss kommandon.
acr sträng Standardcontainerregistret som ska användas för alla az acr-kommandon.
Lagring konto sträng Standardnamnet för lagringskontot (t.ex. mystorageaccount i för att använda https://mystorageaccount.blob.core.windows.net) az storage för dataplanskommandon (t.ex. az storage container list ).
key sträng Standardåtkomstnyckeln som ska användas för az storage dataplanskommandon.
sas_token sträng Sas-standardtoken som ska användas az storage för dataplanskommandon.
anslutnings_sträng sträng Standardanslutningssträngen som ska användas az storage för dataplanskommandon.
batchai lagrings_konto sträng Standardlagringsnyckeln som ska användas för az batchai-kommandon.
lagrings_nyckel sträng Standardlagringsnyckeln som ska användas för az batchai-kommandon.
Batch konto sträng Azure Batch-standardnamn som ska användas för az batch-kommandon.
åtkomst_nyckel sträng Standardåtkomstnyckeln som ska användas för az batch-kommandon. Ska endast användas med aad-auktorisering.
slutpunkt sträng Standardslutpunkten att ansluta till för az batch-kommandon.
ver_läge sträng Verifieringsläge som ska användas för az batch-kommandon. Det kan vara shared_key eller aad.
Moln name sträng Standardmolnet för alla az kommandon. Möjliga värden är AzureCloud (standard), AzureChinaCloud , , AzureUSGovernment AzureGermanCloud . Du kan använda kommandot för att ändra az cloud set –name moln. Ett exempel finns i Hantera moln med Azure CLI.
Förlängning use_dynamic_install sträng Installera ett tillägg om det inte har lagts till ännu när du kör ett kommando från det. Möjliga värden är no (standard), yes_prompt , yes_without_prompt .
run_after_dynamic_install boolean Fortsätt att köra kommandot när ett tillägg installeras dynamiskt för det. Standardvärdet är False.

Anteckning

Det kan finnas andra värden i din konfigurationsfil, men de hanteras direkt via CLI-kommandon, däribland az config. De som anges i tabellen ovan är den enda värden du bör ändra själv.

Se även