你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az arcdata dc

注意

此参考是 Azure CLI（版本 2.3.1 或更高版本）的 arcdata 扩展的一部分。 该扩展将在首次运行 az arcdata dc 命令时自动安装。 详细了解扩展。

创建、删除和管理数据控制器。

命令

名称	说明	类型	状态
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 工作区 ID 和 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 资源管理器（仅限直接连接模式）部署 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 位置（例如美国东部）。

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

订阅的名称或 ID。 可以使用 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 资源管理器（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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az arcdata dc update

更新数据控制器。

汇报数据控制程序以启用/禁用自动上传日志和指标。

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 资源管理器（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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az arcdata dc upgrade

升级数据控制器。

将数据控制器升级到指定的所需版本。 如果未指定所需版本，将尝试升级到最新版本。 如果不确定所需版本，可以使用 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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。