共用方式為

az arcdata dc config

Note

此參考是 Azure CLI 的 arcdata 延伸模組的一部分（2.3.1 版或更高版本）。 擴充功能會在您第一次執行 az arcdata dc config 命令時自動安裝。 深入了解擴充功能。

組態命令。

命令

名稱 Description 類型 狀態
az arcdata dc config add

在組態檔中新增 json 路徑的值。

 Extension GA
az arcdata dc config init

初始化可與 az arcdata dc create搭配使用的資料控制器組態配置檔。

 Extension GA
az arcdata dc config list

列出可用的組態配置檔選項。

 Extension GA
az arcdata dc config patch

根據 json 修補程式檔案修補組態檔。

 Extension GA
az arcdata dc config remove

拿掉組態檔中 json 路徑的值。

 Extension GA
az arcdata dc config replace

取代組態檔中 json 路徑的值。

 Extension GA
az arcdata dc config show

傳回數據控制器自定義資源的組態。

 Extension GA

az arcdata dc config add

在組態檔中新增 json 路徑的值。

在組態檔中的 json 路徑上新增值。 下列所有範例都會在Bash中提供。 如果使用另一個命令行，您可能需要適當地逸出引號。 或者，您可以使用修補程序檔案功能。

az arcdata dc config add --config-file
                         --json-values
                         --path

範例

新增數據控制器記憶體。

az arcdata dc config add --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

必要參數

--config-file -c
已被取代

選項 '-c' 已被取代，未來版本將會移除。 請改用 『-p』。

您要設定之組態的資料控制器設定檔路徑，也就是自訂/control.json。

--json-values -j

值 json 路徑的索引鍵值組清單：key1.subkey1=value1，key2.subkey2=value2。 您可以提供內嵌 json 值，例如：key='{“kind”：“cluster”，“name”：“test-cluster”}' 或提供檔案路徑，例如 key=./values.json。 add 命令不支持條件式。 如果您要提供的內嵌值是索引鍵值組本身與 “=” 和 “，”逸出這些字元。 例如，key1=“key2=val2，key3=val3”。 如需路徑外觀的範例，請參閱 http://jsonpatch.com/。 如果您想要存取陣列，您必須指定索引，例如key.0=value。

--path -p

您要設定之組態的資料控制器設定檔路徑，也就是自訂/control.json。

全域參數
--debug

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

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

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

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

--subscription

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

--verbose

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

屬性 值
預設值: False

az arcdata dc config init

初始化可與 az arcdata dc create搭配使用的資料控制器組態配置檔。

初始化可與 az arcdata dc create搭配使用的資料控制器組態配置檔。 您可以在自變數中指定組態設定檔的特定來源。

az arcdata dc config init [--force]
                          [--path]
                          [--source]
                          [--target]

範例

引導式數據控制器設定 init 體驗 - 您會收到所需值的提示。

az arcdata dc config init

arcdata dc config init 搭配自變數，在 ./custom 中建立 aks-dev-test 的組態配置檔。

az arcdata dc config init --source azure-arc-kubeadm --path custom

選擇性參數

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

--force -f

強制覆寫目標檔案。

--path -p

您想要放置組態配置檔的檔案路徑，預設為 cwd/custom。

--source -s

組態配置檔來源：['azure-arc-ake'， 'azure-arc-aks-default-storage'， 'azure-arc-aks-dev-test'， 'azure-arc-aks-hci'、'azure-arc-aks-premium-storage'、'azure-arc-azure-openshift'、'azure-arc-eks'、'azure-arc-gke'、'azure-arc-kubeadm'、'azure-arc-kubeadm-dev-test'、'azure-arc-openshift'、'azure-arc-unit-test']。

--target -t
已被取代

選項 '-t' 已被取代，將在未來的版本中移除。 請改用 『-p』。

您想要放置組態配置檔的檔案路徑，預設為 cwd/custom。

全域參數
--debug

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

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

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

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

--subscription

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

--verbose

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

屬性 值
預設值: False

az arcdata dc config list

列出可用的組態配置檔選項。

列出在 arcdata dc config init中使用的可用組態配置檔選項。

az arcdata dc config list [--config-profile]

範例

顯示所有可用的組態配置檔名稱。

az arcdata dc config list

顯示特定組態配置檔的 JSON。

az arcdata dc config list --config-profile aks-dev-test

選擇性參數

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

--config-profile -c

默認組態配置檔： ['azure-arc-ake'， 'azure-arc-aks-default-storage'， 'azure-arc-aks-dev-test'， 'azure-arc-aks-hci'、'azure-arc-aks-premium-storage'、'azure-arc-azure-openshift'、'azure-arc-eks'、'azure-arc-gke'、'azure-arc-kubeadm'、'azure-arc-kubeadm-dev-test'、'azure-arc-openshift'、'azure-arc-unit-test']。

全域參數
--debug

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

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

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

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

--subscription

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

--verbose

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

屬性 值
預設值: False

az arcdata dc config patch

根據 json 修補程式檔案修補組態檔。

根據指定的修補檔修補組態檔。 如需如何撰寫路徑，請參閱 http://jsonpatch.com/。 由於 jsonpath 連結庫 https://jsonpath.com/，取代作業可以在其路徑中使用條件式。 所有修補程式 JSON 檔案都必須以具有其對應作業的修補程式數位的“patch” 索引鍵開頭（新增、取代、移除）、路徑和值。 「移除」作業不需要值，只需要路徑。 請參閱以下範例。

az arcdata dc config patch --config-file
                           --patch-file
                           --path

範例

例如 1 - 將單一端點的埠 （Data Controller Endpoint） 取代為修補程式檔案。

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}

例如 2 - 以修補程式檔案取代資料控制體記憶體。

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

必要參數

--config-file -c
已被取代

選項 '-c' 已被取代，未來版本將會移除。 請改用 『--path』。

您要設定之組態的資料控制器設定檔路徑，也就是自訂/control.json。

--patch-file -p

以 jsonpatch 連結庫為基礎的修補 json 檔案路徑：http://jsonpatch.com/。 您必須使用名為 「patch」 的金鑰來啟動修補 json 檔案，其值為您想要進行之修補作業的陣列。 針對修補作業的路徑，您可以使用點表示法，例如key1.key2來進行大部分作業。 如果您想要執行取代作業，而且您要取代需要條件的陣列中的值，請使用 jsonpath 表示法，方法是以 $開頭您的路徑。 這可讓您執行 $.key1.key2[？（@.key3==“someValue”].key4。 請參閱以下範例。 如需條件的其他說明，請參閱：https://jsonpath.com/。

--path

您要設定之組態的資料控制器設定檔路徑，也就是自訂/control.json。

全域參數
--debug

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

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

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

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

--subscription

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

--verbose

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

屬性 值
預設值: False

az arcdata dc config remove

拿掉組態檔中 json 路徑的值。

拿掉組態檔中 json 路徑的值。 下列所有範例都會在Bash中提供。 如果使用另一個命令行，您可能需要適當地逸出引號。 或者，您可以使用修補程序檔案功能。

az arcdata dc config remove --config-file
                            --json-path
                            --path

範例

例如 1 - 移除資料控制體記憶體。

az arcdata dc config remove --path custom/control.json --json-path '.spec.storage'

必要參數

--config-file -c
已被取代

選項 '-c' 已被取代，未來版本將會移除。 請改用 『-p』。

您要設定之組態的資料控制器設定檔路徑，也就是自訂/control.json。

--json-path -j

根據 jsonpatch 連結庫的 json 路徑清單，指出您想要移除的值，例如：key1.subkey1，key2.subkey2。 remove 命令不支持條件式。 如需路徑外觀的範例，請參閱 http://jsonpatch.com/。 如果您想要存取陣列，您必須指定索引，例如key.0=value。

--path -p

您要設定之組態的資料控制器設定檔路徑，也就是自訂/control.json。

全域參數
--debug

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

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

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

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

--subscription

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

--verbose

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

屬性 值
預設值: False

az arcdata dc config replace

取代組態檔中 json 路徑的值。

取代組態檔中 json 路徑的值。 Bash 中會提供所有範例。 如果使用另一個命令行，您可能需要適當地逸出引號。 或者，您可以使用修補程序檔案功能。

az arcdata dc config replace --config-file
                             --json-values
                             --path

範例

例如 1 - 取代單一端點的埠（數據控制器端點）。

az arcdata dc config replace --path custom/control.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

例如 2 - 取代數據控制體記憶體。

az arcdata dc config replace --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

必要參數

--config-file -c
已被取代

選項 '-c' 已被取代，未來版本將會移除。 請改用 『-p』。

您要設定之組態的資料控制器設定檔路徑，也就是自訂/control.json。

--json-values -j

值 json 路徑的索引鍵值組清單：key1.subkey1=value1，key2.subkey2=value2。 您可以提供內嵌 json 值，例如：key='{“kind”：“cluster”，“name”：“test-cluster”}' 或提供檔案路徑，例如 key=./values.json。 replace 命令支援透過 jsonpath 連結庫的條件。 若要使用此選項，請使用 $來啟動您的路徑。 這可讓您執行條件式，例如 -j $.key1.key2[？（@.key3==“someValue”].key4=value。 如果您要提供的內嵌值是索引鍵值組本身與 “=” 和 “，”逸出這些字元。 例如，key1=“key2=val2，key3=val3”。 您可能會看到下列範例。 如需其他說明，請參閱：https://jsonpath.com/。

--path -p

您要設定之組態的資料控制器設定檔路徑，也就是自訂/control.json。

全域參數
--debug

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

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

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

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

--subscription

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

--verbose

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

屬性 值
預設值: False

az arcdata dc config show

傳回數據控制器自定義資源的組態。

az arcdata dc config show [--k8s-namespace]
                          [--use-k8s]

選擇性參數

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

--k8s-namespace -k

數據控制器所在的 Kubernetes 命名空間。

--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數
--debug

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

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

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

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

--subscription

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

--verbose

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

屬性 值
預設值: False