你当前正在访问 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 获取完整的调试日志。