你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az config

此命令组是试验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

管理 Azure CLI 配置。

自 Azure CLI 2.10.0 起可用。

命令

名称	说明	类型	状态
az config get	获取配置。	核心	实验
az config param-persist	管理参数持久性。	核心	实验
az config param-persist delete	删除参数持久性数据。	核心	实验
az config param-persist off	关闭参数持久性。	核心	实验
az config param-persist on	打开参数持久性。	核心	实验
az config param-persist show	显示参数持久性数据。	核心	实验
az config set	设置一个配置。	核心	实验
az config unset	取消设置配置。	核心	实验

az config get

实验

命令组“config”是试验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取配置。

az config get [--local]
              [<KEY>]

示例

获取所有配置。

az config get

获取“核心”部分中的配置。

az config get core

获取密钥“core.no_color”的配置。

az config get core.no_color

可选参数

--local

包括本地配置。 从工作目录扫描到根驱动器，然后全局配置并返回第一个匹配项。

默认值: False

<KEY>

要获取的配置。 如果未提供，则会列出所有部分和配置。 如果 section 已提供，则会列出指定节下的所有配置。 如果 <section>.<key> 提供，则仅显示相应的配置。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az config set

实验

命令组“config”是试验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

设置一个配置。

有关可用配置选项，请参阅 https://docs.microsoft.com/cli/azure/azure-cli-configuration。 默认情况下，不指定 --local，配置将保存到 ~/.azure/config。

az config set [--local]
              [<KEY_VALUE>]

示例

使用“core.no_color”禁用颜色。

az config set core.no_color=true

隐藏警告，并仅显示带有“core.only_show_errors”的错误。

az config set core.only_show_errors=true

启用客户端遥测。

az config set core.collect_telemetry=true

打开文件日志记录并设置其位置。

az config set logging.enable_log_file=true
az config set logging.log_dir=~/az-logs

将默认位置设置为“westus2”，将默认资源组设置为“myRG”。

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

将默认资源组设置为本地范围的“myRG”。

az config set defaults.group=myRG --local

可选参数

--local

在工作目录中设置为本地配置。

默认值: False

<KEY_VALUE>

以空格分隔的配置形式

.=.

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az config unset

实验

命令组“config”是试验性的，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

取消设置配置。

az config unset [--local]
                [<KEY>]

示例

取消设置键“core.no_color”的配置。

az config unset core.no_color

可选参数

--local

包括本地配置。 从工作目录扫描到根驱动器，然后全局配置并取消设置第一个匹配项。

默认值: False

<KEY>

要取消设置的配置，格式为

..

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。