az config

此命令群組是實驗性且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

管理 Azure CLI 組態。

自 Azure CLI 2.10.0 起提供。

命令

名稱	Description	類型	狀態
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

取得 'core' 區段中的組態。

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。