az arcdata dc

注意

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

建立、刪除和管理資料控制者。

命令

名稱	Description	類型	狀態
az arcdata dc config	組態命令。	副檔名	GA
az arcdata dc config add	針對設定檔中的 json 路徑新增值。	副檔名	GA
az arcdata dc config init	初始化可與 搭配 az arcdata dc create 使用的資料控制器組態設定檔。	副檔名	GA
az arcdata dc config list	列出可用的組態設定檔選項。	副檔名	GA
az arcdata dc config patch	根據 json 修補程式檔案修補組態檔。	副檔名	GA
az arcdata dc config remove	針對設定檔中的 json 路徑移除值。	副檔名	GA
az arcdata dc config replace	針對設定檔中的 json 路徑取代值。	副檔名	GA
az arcdata dc config show	傳回資料控制器自訂資源的組態。	副檔名	GA
az arcdata dc create	建立資料控制器。	副檔名	GA
az arcdata dc debug	偵錯資料控制器。	副檔名	GA
az arcdata dc debug controldb-cdc	在資料控制器資料庫和資料表上啟用/停用 CDC - 僅供疑難排解之用。	副檔名	GA
az arcdata dc debug copy-logs	複製記錄。	副檔名	GA
az arcdata dc debug dump	觸發記憶體傾印。	副檔名	GA
az arcdata dc debug restore-controldb-snapshot	從備份還原 ControlDB 的唯一複本 - 僅供疑難排解之用。	副檔名	GA
az arcdata dc delete	刪除資料控制器。	副檔名	GA
az arcdata dc endpoint	端點命令。	副檔名	GA
az arcdata dc endpoint list	列出資料控制器端點。	副檔名	GA
az arcdata dc export	匯出計量、記錄或使用量。	副檔名	GA
az arcdata dc list	依資源群組或訂用帳戶列出 Azure Arc 資料控制器。	副檔名	GA
az arcdata dc list-upgrades	列出可用的升級版本。	副檔名	GA
az arcdata dc status	狀態命令。	副檔名	GA
az arcdata dc status show	顯示資料控制器的狀態。	副檔名	GA
az arcdata dc update	更新資料控制器。	副檔名	GA
az arcdata dc upgrade	升級資料控制器。	副檔名	GA
az arcdata dc upload	上傳匯出的資料檔案。	副檔名	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

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

--auto-upload-logs

啟用自動上傳記錄。

接受的值: false, true

--auto-upload-metrics

啟用自動上傳計量。

接受的值: false, true

--cluster-name

Kubernetes 叢集的名稱。

--custom-location

自訂位置的名稱。

--image-tag

要用於資料控制器的 Arc 資料服務影像標籤。

--infrastructure

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

--k8s-namespace -k

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

--labels

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

--location -l

儲存資料控制器中繼資料的 Azure 位置（例如 eastus）。

--logs-ui-private-key-file

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

--logs-ui-public-key-file

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

--metrics-ui-private-key-file

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

--metrics-ui-public-key-file

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

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

要套用至所有外部資料控制器服務的以逗號分隔的批註清單。

--service-labels

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

--storage-annotations

要套用至資料控制器所建立之所有 PVC 的逗號分隔批註清單。

--storage-class

要用於所有資料和記錄永續性磁片區的儲存體類別，適用于需要這些資料控制器 Pod 的儲存體類別。

--storage-labels

要套用至資料控制器所建立之所有 PVC 的逗號分隔標籤清單。

--use-k8s

使用本機 Kubernetes API 建立資料控制器。

全域參數

--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 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 命名空間。

--no-wait

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

預設值: False

--resource-group -g

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

--use-k8s

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

--yes -y

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

全域參數

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

增加記錄詳細資訊，以顯示所有偵錯記錄。

--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 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 資源群組。

全域參數

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

增加記錄詳細資訊，以顯示所有偵錯記錄。

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

啟用自動上傳記錄。

接受的值: false, true

--auto-upload-metrics

啟用自動上傳計量。

接受的值: false, true

--desired-version -v

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

--k8s-namespace -k

具有已部署資料控制器的 Kubernetes 命名空間。

--maintenance-duration

預覽

預設維護時段的持續時間。

--maintenance-enabled

預覽

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

接受的值: false, true

--maintenance-recurrence

預覽

預設維護時段的週期性間隔。

--maintenance-start

預覽

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

--maintenance-time-zone

預覽

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

--name -n

資料控制器名稱。

--no-wait

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

預設值: False

--resource-group -g

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

--use-k8s

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

全域參數

--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 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 命名空間。

--name -n

資料控制器的名稱。

--no-wait

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

預設值: False

--resource-group -g

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

--target

已被取代

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

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

--use-k8s

使用本機 Kubernetes API 升級資料控制器。

全域參數

--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 arcdata dc upload

上傳匯出的資料檔案。

將從資料控制站匯出的資料檔上傳至 Azure。

az arcdata dc upload --path

必要參數

--path -p

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

全域參數

--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 來取得完整偵錯記錄。