共用方式為

az arcdata dc

Note

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

建立、刪除和管理數據控制者。

命令

名稱 Description 類型 狀態
az arcdata dc config

組態命令。

 Extension GA
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 create

建立數據控制器。

 Extension GA
az arcdata dc debug

偵錯數據控制器。

 Extension GA
az arcdata dc debug controldb-cdc

在數據控制器資料庫和數據表上啟用/停用 CDC - 僅供疑難解答之用。

 Extension GA
az arcdata dc debug copy-logs

複製記錄。

 Extension GA
az arcdata dc debug dump

觸發記憶體轉儲。

 Extension GA
az arcdata dc debug restore-controldb-snapshot

從備份還原 ControlDB 的唯一複本 - 僅供疑難解答之用。

 Extension GA
az arcdata dc delete

刪除資料控制器。

 Extension GA
az arcdata dc endpoint

端點命令。

 Extension GA
az arcdata dc endpoint list

列出數據控制器端點。

 Extension GA
az arcdata dc export

匯出計量、記錄或使用量。

 Extension GA
az arcdata dc list

依資源群組或訂用帳戶列出 Azure Arc 數據控制器。

 Extension GA
az arcdata dc list-upgrades

列出可用的升級版本。

 Extension GA
az arcdata dc status

狀態命令。

 Extension GA
az arcdata dc status show

顯示數據控制器的狀態。

 Extension GA
az arcdata dc update

更新數據控制器。

 Extension GA
az arcdata dc upgrade

升級數據控制器。

 Extension GA
az arcdata dc upload

上傳匯出的數據檔。

 Extension GA

az arcdata dc create

建立數據控制器。

建立數據控制器 - 您的系統上需要 kube 設定，以及下列環境變數所提供的監視儀錶板認證 - 記錄儀錶板的AZDATA_LOGSUI_USERNAME和AZDATA_LOGSUI_PASSWORD，以及計量儀錶板的AZDATA_METRICSUI_USERNAME和AZDATA_METRICSUI_PASSWORD。 或者，如果遺漏任一組環境變數，AZDATA_USERNAME和AZDATA_PASSWORD將做為後援。 使用 ARM 目標自變數時，也可以使用下列選擇性環境變數 - WORKSPACE_ID Log Analytics 工作區識別碼，以及 Log Analytics 主鍵的WORKSPACE_SHARED_KEY。

az arcdata dc create --connectivity-mode
                     --name
                     --resource-group
                     [--annotations]
                     [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--cluster-name]
                     [--custom-location]
                     [--image-tag]
                     [--infrastructure]
                     [--k8s-namespace]
                     [--labels]
                     [--location]
                     [--logs-ui-private-key-file]
                     [--logs-ui-public-key-file]
                     [--metrics-ui-private-key-file]
                     [--metrics-ui-public-key-file]
                     [--no-wait]
                     [--path]
                     [--profile-name]
                     [--service-annotations]
                     [--service-labels]
                     [--storage-annotations]
                     [--storage-class]
                     [--storage-labels]
                     [--use-k8s]

範例

透過 Kubernetes API 部署 Arc 數據控制器（僅限間接連線模式）。

az arcdata dc create --name dc-name --k8s-namespace arc --connectivity-mode indirect --resource-group rg-name  --location eastasia --subscription subscription --use-k8s

透過 Azure Resource Manager 部署 Arc 資料控制器（僅限直接連線模式）。

az arcdata dc create --name dc-name  --connectivity-mode direct --resource-group rg-name --location eastasia --subscription subscription  --custom-location arc-cl

透過ARM將Arc資料控制器部署到已啟用Arc的 Kubernetes 叢集（僅限直接連線模式）。 如果 Arc 資料服務延伸模組和自定義位置不存在，此命令將會部署它們。

az arcdata dc create --name dc-name --subscription subscription --resource-group rg-name  --cluster-name arc-cluster --connectivity-mode direct --custom-location arc-cl

必要參數

--connectivity-mode

與 Azure 的連線 - 間接或直接 - 數據控制者應該在其中運作。

--name -n

數據控制器的名稱。

--resource-group -g

應該在其中新增數據控制站資源的 Azure 資源群組。

選擇性參數

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

--annotations

以逗號分隔的批注清單，以套用所有數據控制器資源。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--auto-upload-logs

啟用自動上傳記錄。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
接受的值: false, true
--auto-upload-metrics

啟用自動上傳計量。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
接受的值: false, true
--cluster-name

Kubernetes 叢集的名稱。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
--custom-location

自訂位置的名稱。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
--image-tag

要用於數據控制器的 Arc 數據服務影像標籤。

--infrastructure

要在其中執行數據控制站的基礎結構。 允許的值：['aws'、'gcp'、'azure'、'alibaba'、'onpremises'、'other'、'auto']。

--k8s-namespace -k

要部署數據控制器的 Kubernetes 命名空間。 如果已經存在，則會使用它。 如果不存在，將會先嘗試建立它。

--labels

要套用至所有數據控制器資源的標籤逗號分隔清單。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--location -l

儲存數據控制器元數據的 Azure 位置（例如 eastus）。

--logs-ui-private-key-file

檔案的路徑，其中包含要用於記錄 UI 儀錶板端點的 PEM 格式憑證私鑰。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--logs-ui-public-key-file

檔案的路徑，其中包含要用於記錄 UI 儀錶板端點的 PEM 格式憑證。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--metrics-ui-private-key-file

檔案的路徑，其中包含要用於計量 UI 儀錶板端點的 PEM 格式化憑證私鑰。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--metrics-ui-public-key-file

檔案的路徑，其中包含要用於計量 UI 儀錶板端點的 PEM 格式化憑證。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--no-wait

請勿等候長時間執行的作業完成。

屬性 值
預設值: False
--path -p

目錄的路徑，其中包含要使用的自定義組態配置檔。 執行 az arcdata dc config init 以建立自定義組態配置檔。

--profile-name

現有組態配置檔的名稱。 執行 az arcdata dc config list 以查看可用的選項。 下列其中一項：['azure-arc-ake'， 'azure-arc-aks-default-storage'、'azure-arc-aks-hci'、'azure-arc-aks-premium-storage'、'azure-arc-azure-openshift'、'azure-arc-eks'、'azure-arc-gke'、'azure-arc-kubeadm'、'azure-arc-openshift'、'azure-arc-unit-test']。

--service-annotations

要套用至所有外部數據控制器服務的以逗號分隔的批注清單。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--service-labels

要套用至所有外部數據控制器服務的標籤逗號分隔清單。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--storage-annotations

要套用至數據控制器所建立之所有 PVC 的逗號分隔批注清單。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--storage-class

要用於所有數據和記錄永續性磁碟區的記憶體類別，適用於需要這些數據控制器 Pod 的記憶體類別。

--storage-labels

要套用至數據控制器所建立之所有 PVC 的逗號分隔卷標清單。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--use-k8s

使用本機 Kubernetes API 建立數據控制器。

屬性 值
參數群組: Kubernetes API – targeted Arguments
全域參數
--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 delete

刪除資料控制器。

刪除數據控制器 - 系統上需要 kube 設定。

az arcdata dc delete --name
                     [--force]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]
                     [--yes]

範例

透過 Kubernetes API 刪除資料控制器。

az arcdata dc delete --name dc-name --k8s-namespace arc --use-k8s

透過 Azure Resource Manager 刪除數據控制器（ARM）。

az arcdata dc delete --name dc-name --resource-group rg-name

必要參數

--name -n

數據控制器名稱。

選擇性參數

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

--force -f

強制刪除資料控制器及其所有數據服務。

--k8s-namespace -k

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

屬性 值
參數群組: Kubernetes API – targeted Arguments
--no-wait

請勿等候長時間執行的作業完成。

屬性 值
預設值: False
--resource-group -g

數據控制站所在的 Azure 資源群組。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
--use-k8s

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

屬性 值
參數群組: Kubernetes API – targeted Arguments
--yes -y

刪除資料控制器，而不需確認提示。

全域參數
--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 export

匯出計量、記錄或使用量。

將計量、記錄或使用量匯出至檔案。

az arcdata dc export --k8s-namespace
                     --path
                     --type
                     [--force]
                     [--use-k8s]

必要參數

--k8s-namespace -k

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

--path -p

完整或相對路徑，包括要匯出之檔案的檔名。

--type -t

要匯出的數據型別。 選項：記錄、計量和使用方式。

選擇性參數

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

--force -f

強制建立輸出檔案。 覆寫相同路徑上的任何現有檔案。

--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

az arcdata dc list

依資源群組或訂用帳戶列出 Azure Arc 數據控制器。

az arcdata dc list [--resource-group]

範例

列出指定資源群組中的所有Arc資料控制器。

az arcdata dc list --resource-group rg-name

列出指定訂用帳戶中的所有Arc數據控制器。

az arcdata dc list --subscription subscriptionId

選擇性參數

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

--resource-group -g

包含 Arc 數據控制器的 Azure 資源群組。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
全域參數
--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 list-upgrades

列出可用的升級版本。

嘗試列出 Docker 映射登錄中可供升級的版本。 - 您的系統上需要 kube 組態，以及下列環境變數 ['AZDATA_USERNAME'， 'AZDATA_PASSWORD']。

az arcdata dc list-upgrades --k8s-namespace
                            [--use-k8s]

範例

數據控制器升級清單。

az arcdata dc list-upgrades --k8s-namespace 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

az arcdata dc update

更新數據控制器。

更新 datacontroller，以啟用/停用自動上傳記錄和計量。

az arcdata dc update [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--desired-version]
                     [--k8s-namespace]
                     [--maintenance-duration]
                     [--maintenance-enabled {false, true}]
                     [--maintenance-recurrence]
                     [--maintenance-start]
                     [--maintenance-time-zone]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

範例

透過 Azure Resource Manager（ARM） 啟用記錄的自動上傳。

az arcdata dc update --auto-upload-logs true --name dc-name --resource-group rg-name

透過ARM啟用計量的自動上傳。

az arcdata dc update --auto-upload-metrics true --name dc-name --resource-group rg-name

選擇性參數

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

--auto-upload-logs

啟用自動上傳記錄。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
接受的值: false, true
--auto-upload-metrics

啟用自動上傳計量。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
接受的值: false, true
--desired-version -v

要升級數據控制器的所需版本標籤，或空白以使用最新的有效版本。

--k8s-namespace -k

具有已部署數據控制器的 Kubernetes 命名空間。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--maintenance-duration
預覽

默認維護時段的持續時間。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--maintenance-enabled
預覽

在預設維護期間設定已啟用的旗標。

屬性 值
參數群組: Kubernetes API – targeted Arguments
接受的值: false, true
--maintenance-recurrence
預覽

默認維護時段的週期性間隔。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--maintenance-start
預覽

第一個預設維護時段開始的日期時間。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--maintenance-time-zone
預覽

用來計算預設維護時段的時區。

屬性 值
參數群組: Kubernetes API – targeted Arguments
--name -n

數據控制器名稱。

--no-wait

請勿等候長時間執行的作業完成。

屬性 值
預設值: False
--resource-group -g

數據控制站所在的 Azure 資源群組。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
--use-k8s

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

屬性 值
參數群組: Kubernetes API – targeted Arguments
全域參數
--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 upgrade

升級數據控制器。

將數據控制器升級至指定的所需版本。 如果未指定 desired-version，則會嘗試升級至最新版本。 如果您不確定所需的版本，您可以使用 list-upgrades 命令來檢視可用的版本，或使用 --dry-run 自變數來顯示要使用的版本。

az arcdata dc upgrade [--desired-version]
                      [--dry-run]
                      [--k8s-namespace]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

範例

數據控制器升級。

az arcdata dc upgrade --k8s-namespace arc --use-k8s

選擇性參數

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

--desired-version -v

要升級數據控制器的所需版本標籤，或空白以使用最新的有效版本。

--dry-run -d

指出要升級哪個實例，但實際上不會升級實例。

--k8s-namespace -k

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

屬性 值
參數群組: Kubernetes API – targeted Arguments
--name -n

數據控制器的名稱。

--no-wait

如果指定，命令將會開始升級，但不會等待整個升級完成。 升級將會在背景繼續。

屬性 值
預設值: False
--resource-group -g

數據控制站所在的 Azure 資源群組。

屬性 值
參數群組: Azure Resource Manager – targeted Arguments
--target
已被取代

選項 '--target' 已被取代，並將在未來版本中移除。 請改用 『--desired-version』。

要升級數據控制器的所需版本標籤，或空白以使用最新的有效版本。

--use-k8s

使用本機 Kubernetes API 升級數據控制器。

屬性 值
參數群組: Kubernetes API – targeted Arguments
全域參數
--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 upload

上傳匯出的數據檔。

將從數據控制站匯出的數據檔上傳至 Azure。

az arcdata dc upload --path

必要參數

--path -p

完整或相對路徑，包括要上傳之檔案的檔名。

全域參數
--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