Dela via

Azure CLI-konfiguration

Azure CLI tillåter användarkonfiguration för inställningar som loggning, datainsamling och standardargumentvärden. CLI erbjuder ett bekvämlighetskommando för att hantera vissa standardvärden, az configoch ett interaktivt alternativ via az init. Andra värden kan anges i en konfigurationsfil eller med miljövariabler. Den här artikeln innehåller ytterligare information om de här användarkonfigurationsinställningarna och hur du konfigurerar Azure CLI.

Konfigurationsvärden som används av CLI utvärderas i följande prioritet, där objekt högre upp i listan prioriteras.

  1. Kommandoradsparametrar
  2. Miljövariabler
  3. Värden i konfigurationsfiluppsättningen med az config eller az init

Konfigurera inställningar med az init

Det enklaste sättet att ange Azure CLI-konfigurationer är att använda det interaktiva kommandot az init . Välj en vanlig konfiguration som "interaktion" eller "automatisering" eller välj att gå igenom enskilda konfigurationer. Det som är särskilt användbart med den här metoden är az init varför du kanske vill välja ett konfigurationsalternativ framför ett annat.

az init

Konfigurera inställningar med az config

Du kan ange standardvärden för CLI med kommandot az config set . Det här kommandot tar en blankstegsavgränsad lista med key=value par som argument. De angivna värdena används av Azure CLI i stället för obligatoriska argument.

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

Namn Beskrivning
defaults.group Den standardresursgrupp som ska användas för alla kommandon.
standardinställningar.plats Standardplatsen som ska användas för alla kommandon.
defaults.web Standardappnamnet som ska användas för az webapp kommandon.
defaults.vm Standardnamnet för den virtuella datorn som ska användas för az vm kommandon.
defaults.vmss Standardnamnet för skala för virtuella maskiner (VMSS) som ska användas för az vmss kommandon.
defaults.acr Standardnamnet för containerregistret som ska användas för az acr kommandon.

Så här ställer du till exempel in standardresursgruppen och platsen för alla kommandon.

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

Följande kommando inaktiverar undersökningslänkarna när Azure CLI-kommandona körs:

az config set core.survey_message=no

CLI-konfigurationsfil

CLI-konfigurationsfilen innehåller andra 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-filformatet. Avsnittsrubriker definierar filformatet, följt av en lista med nyckel- och värdepar.

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

Booleska värden är skiftlägesokänsliga. Följande värden representerar booleska värden:

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

Här är ett exempel på en CLI-konfigurationsfil som inaktiverar eventuella bekräftelsemeddelanden och konfigurerar loggning till /var/log/azure katalogen.

[core]
disable_confirm_prompt=Yes

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

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

CLI-konfigurationsvärden och miljövariabler

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

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.

Sektion Namn Typ Beskrivning
kärna produktion snöre Standardutdataformatet. Tillåtna värden: json (standard), jsonc, yaml, yamlc, table, tsv, . none Mer information finns i Utdataformat för Azure CLI-kommandon.
avaktivera_bekräftelseprompt booleskt Aktivera/inaktivera bekräftelsemeddelanden.
visa_region_identifierad booleskt Azure-kunder kan välja att distribuera resurser i många olika regioner. I vissa fall kan kunder kanske minska kostnaderna genom att välja närliggande regioner som erbjuder samma tjänster. Om en närliggande region identifieras visar ett meddelande den region som ska väljas för framtida distributioner. Den här inställningen styr om meddelandet visas.
samla in telemetri booleskt Tillåt Microsoft att samla in anonyma data om användningen av CLI. Sekretessinformation finns i Azure CLI MIT-licensen.
visa_endast_fel booleskt Visa endast fel under kommandoanrop. Med andra ord skrivs endast fel till stderr. Den utelämnar varningar från förhandsversioner, inaktuella och experimentella kommandon. Den är också tillgänglig för enskilda kommandon med parametern --only-show-errors .
aktivera_mäklare_på_windows booleskt Använd Web Account Manager (WAM) för att autentisera till Azure via az login kommandot.
inloggningsupplevelse_v2 booleskt Aktivera/inaktivera prenumerationsväljaren az login .
ingen_färg booleskt Inaktivera färg. Ursprungligen färgade meddelanden är prefixeras med DEBUG, INFO, WARNING och ERROR. Det här booleska objektet kringgår problemet med ett bibliotek från tredje part där terminalens färg inte kan återställas efter en stdout omdirigering.
Klienter visa_hemligheter_varning booleskt Aktivera/inaktivera varningen för känslig information.
loggning aktivera_loggfil booleskt Växla loggning av/på.
log_dir snöre Katalogen att skriva loggar till. Det här värdet är som standard ${AZURE_CONFIG_DIR}/logs*.
Standardvärden grupp snöre Den standardresursgrupp som ska användas för alla kommandon.
läge snöre Standardplatsen som ska användas för alla kommandon.
webb snöre Standardappnamnet som ska användas för az webapp kommandon.
virtuell maskin snöre Standardnamnet för den virtuella datorn som ska användas för az vm kommandon.
vmss snöre Standardnamnet för skala för virtuella maskiner (VMSS) som ska användas för az vmss kommandon.
acr snöre Standardnamnet för containerregistret som ska användas för az acr kommandon.
lagring konto snöre Standardnamnet för lagringskontot (till exempel mystorageaccount i https://mystorageaccount.blob.core.windows.net) som ska användas för az storage dataplanskommandon (till exempel az storage container list).
nyckel snöre Standardåtkomstnyckeln som ska användas för az storage dataplanskommandon.
sas-token snöre Standard-SAS-token som ska användas för az storage dataplanskommandon.
anslutningssträng (connection_string) snöre Standardanslutningssträngen som ska användas för az storage dataplanskommandon.
batchai lagringskonto snöre Standardlagringskontot som ska användas för az batchai kommandon.
lagringsnyckel snöre Standardlagringsnyckeln som ska användas för az batchai kommandon.
batch konto snöre Standardnamnet för Azure Batch-kontot som ska användas för az batch kommandon.
Accessnyckel snöre Standardåtkomstnyckeln som ska användas för az batch kommandon. Används endast med aad auktorisering.
Slutpunkt snöre Standardslutpunkten som ska anslutas till för az batch kommandon.
autentiseringsläge snöre Auktoriseringsläget som ska användas för az batch kommandon. Tillåtna värden: shared_key, aad.
moln namn snöre Standardmolnet för alla az kommandon. Tillåtna värden: AzureCloud (standard), AzureChinaCloud, AzureUSGovernment. Om du vill ändra moln kan du använda az cloud set -–name kommandot . Ett exempel finns i Hantera moln med Azure CLI.
förlängning använd_dynamisk_installation snöre Installera ett tillägg om det inte har lagts till ännu när du kör ett kommando från det. Tillåtna värden: no (standard), yes_prompt, yes_without_prompt.
kör_efter_dynamisk_installation booleskt Fortsätt att köra kommandot när ett tillägg installeras dynamiskt för det. Standard är False.
indexens webbadress snöre URL för privat tilläggsindexfil som följer formatet i index.json. När filen har angetts används az extension add --name <extension-name> för att hitta tillägget som ska läggas till.

Anmärkning

Du kan se andra värden i konfigurationsfilen, men de hanteras direkt via CLI-kommandon, inklusive az config. De som angavs i tabellen tidigare är de enda värden som du bör ändra själv.