az-config
Manage Azure App Configuration resources
TLDR
Print all configurations
Print configurations for a specific section
Set a configuration
Unset a configuration
SYNOPSIS
az config {delete|get|list|set|unset} [--scope] [--default] [name[=value]]
PARAMETERS
--scope
Config scope: current, global, or local. Default: current.
--default
Handle missing config: no (error), yaml (YAML default), only (default only). Default: no.
--output -o
Output format: json|jsonc|table|tsv|yaml.
--query
JMESPath query string for output filtering.
-h, --help
Show help for the command.
--verbose
Increase logging verbosity.
DESCRIPTION
The az config command group in Azure CLI manages persistent configuration settings that customize CLI behavior, such as default output format, resource group, location, or subscription. Settings are stored in JSON files under scopes: global (~/.azure/config), local (installation-specific), or current (per-session, non-persistent). Use subcommands to list all settings, get specific values, set new ones, delete, or unset them. This avoids repeating options in commands. For example, az config set defaults.location=westus sets a default region globally. Supports defaults for missing keys via --default flag. Ideal for scripting and personalization across Azure resource management.
CAVEATS
Changes require CLI restart in some environments; current scope is transient. Validate values to avoid CLI errors. No undo without prior backup.
SUBCOMMANDS
list: List all configs.
get name: Retrieve value.
set name=value: Set value.
delete name: Remove setting.
unset name: Unset (similar to delete).
COMMON SETTINGS
defaults.location, defaults.group, defaults.output, defaults.subscription, extensions.auto_update.
HISTORY
Introduced in Azure CLI 2.0 (2017) by Microsoft for unified config management, evolving with scopes in 2.1+ and YAML defaults in later releases for better scripting.
SEE ALSO
az(1)


