LinuxCommandLibrary

az-config

Manage Azure App Configuration resources

TLDR

Print all configurations

$ az config get
copy

Print configurations for a specific section
$ az config get [section_name]
copy

Set a configuration
$ az config set [configuration_name]=[value]
copy

Unset a configuration
$ az config unset [configuration_name]
copy

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)

Copied to clipboard