az arcdata dc

Note

此參考是Azure CLIarcdata擴充功能（版本 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 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 create

建立數據控制器。

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

az arcdata dc create --connectivity-mode
                     --name
                     --resource-group
                     [--acquire-policy-token]
                     [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--change-reference]
                     [--cluster-name]
                     [--custom-location]
                     [--image-tag]
                     [--infrastructure]
                     [--k8s-namespace]
                     [--location]
                     [--no-wait]
                     [--path]
                     [--profile-name]
                     [--storage-class]

範例

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

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--auto-upload-logs

啟用自動上傳記錄。

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

--auto-upload-metrics

啟用自動上傳計量。

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

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--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 命名空間。 如果已經存在，則會使用它。 如果不存在，將會先嘗試建立它。

--location -l

資料控制器元資料將儲存在 Azure 位置（例如 eastus）。

--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']。

--storage-class

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

全域參數

--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
                     [--acquire-policy-token]
                     [--change-reference]
                     [--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

數據控制器名稱。

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--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 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
                            [--acquire-policy-token]
                            [--change-reference]
                            [--use-k8s]

範例

數據控制器升級清單。

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

必要參數

--k8s-namespace -k

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

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--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 [--acquire-policy-token]
                     [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--change-reference]
                     [--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

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--auto-upload-logs

啟用自動上傳記錄。

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

--auto-upload-metrics

啟用自動上傳計量。

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

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--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 [--acquire-policy-token]
                      [--change-reference]
                      [--desired-version]
                      [--dry-run]
                      [--k8s-namespace]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

範例

數據控制器升級。

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

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

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