az config

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

管理 Azure CLI 組態。

自 Azure CLI 2.10.0 起提供。

命令

名稱	Description	類型	狀態
az config get	取得設定。	Core	Experimental
az config param-persist	管理參數持續性。	Core	Experimental
az config param-persist delete	刪除參數持續性數據。	Core	Experimental
az config param-persist off	關閉參數持續性。	Core	Experimental
az config param-persist on	開啟參數持續性。	Core	Experimental
az config param-persist show	顯示參數持續性數據。	Core	Experimental
az config set	設定組態。	Core	Experimental
az config unset	取消設定。	Core	Experimental

az config get

實驗

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

取得設定。

az config get [--local]
              []

範例

取得所有組態。

az config get

取得 『core』 區段中的組態。

az config get core

取得金鑰 'core.no_color' 的組態。

az config get core.no_color

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--local

包含本機設定。 從工作目錄掃描到根磁碟驅動器，然後掃描全域設定，並傳回第一個出現專案。

屬性	值
預設值:	False

<KEY>

要取得的組態。 如果未提供，則會列出所有區段和組態。 如果提供 section，則會列出指定區段下的所有組態。 如果提供 <section>.<key>，則只會顯示對應的組態。

屬性	值
參數群組:	Positional

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az config set

實驗

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

設定組態。

如需可用的組態選項，請參閱 https://learn.microsoft.com/cli/azure/azure-cli-configuration。 根據預設，不會指定 --local，組態會儲存至 ~/.azure/config。

az config set [--local]
              []

範例

使用 『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>

以 <section>.<key>=<value>格式的空間分隔組態。

屬性	值
參數群組:	Positional

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az config unset

實驗

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

取消設定。

az config unset [--local]
                []

範例

取消設定金鑰 'core.no_color'。

az config unset core.no_color

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--local

包含本機設定。 從工作目錄掃描到根磁碟驅動器，然後掃描全域設定，並取消設定第一次出現。

屬性	值
預設值:	False

<KEY>

要取消設定的組態，格式為 <section>.<key>。

屬性	值
參數群組:	Positional

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False