az hdinsight

命令

名称	说明	类型	Status
az hdinsight application	管理 HDInsight 应用程序。	Core	GA
az hdinsight application create	为 HDInsight 群集创建应用程序。	Core	GA
az hdinsight application delete	删除 HDInsight 群集上的指定应用程序。	Core	GA
az hdinsight application list	列出 HDInsight 群集的所有应用程序。	Core	GA
az hdinsight application show	获取指定应用程序的属性。	Core	GA
az hdinsight application wait	将 CLI 置于等待状态，直到操作完成。	Core	GA
az hdinsight autoscale	管理 HDInsight 群集的自动缩放配置。	Core	GA
az hdinsight autoscale condition	管理启用了基于计划的自动缩放的 HDInsight 群集的计划条件。	Core	GA
az hdinsight autoscale condition create	添加新的计划条件。	Core	GA
az hdinsight autoscale condition delete	删除计划条件。	Core	GA
az hdinsight autoscale condition list	列出所有计划条件。	Core	GA
az hdinsight autoscale condition update	更新计划条件。	Core	GA
az hdinsight autoscale condition wait	将 CLI 置于等待状态，直到操作完成。	Core	GA
az hdinsight autoscale create	为正在运行的群集启用自动缩放。	Core	GA
az hdinsight autoscale delete	为正在运行的群集禁用自动缩放。	Core	GA
az hdinsight autoscale list-timezones	列出启用基于计划的自动缩放时可用的时区名称。	Core	GA
az hdinsight autoscale show	获取指定群集的自动缩放配置。	Core	GA
az hdinsight autoscale update	更新自动缩放配置。	Core	GA
az hdinsight autoscale wait	将 CLI 置于等待状态，直到操作完成。	Core	GA
az hdinsight azure-monitor	管理 HDInsight 群集上的 Azure Monitor 日志集成。	Core	GA
az hdinsight azure-monitor-agent	管理 HDInsight 群集上的 Azure Monitor 代理日志集成。	Core	GA
az hdinsight azure-monitor-agent disable	禁用 HDInsight 群集上的 Azure Monitor 代理日志集成。	Core	GA
az hdinsight azure-monitor-agent enable	在 HDInsight 群集上启用 Azure Monitor 代理日志集成。	Core	GA
az hdinsight azure-monitor-agent show	获取 HDInsight 群集上的 Azure Monitor 代理日志集成的状态。	Core	GA
az hdinsight azure-monitor disable	禁用 HDInsight 群集上的 Azure Monitor 日志集成。	Core	GA
az hdinsight azure-monitor enable	在 HDInsight 群集上启用 Azure Monitor 日志集成。	Core	GA
az hdinsight azure-monitor show	获取 HDInsight 群集上的 Azure Monitor 日志集成的状态。	Core	GA
az hdinsight create	创建新群集。	Core	GA
az hdinsight credentials	管理现有 HDInsight 群集的凭据，包括 Entra ID 用户和 HTTP 密码。	Core	GA
az hdinsight credentials show	显示现有 HDInsight 群集的凭据配置，包括 HTTP 用户名、密码和 Entra ID 用户设置。	Core	GA
az hdinsight credentials update	更新现有 HDInsight 群集的凭据，包括 Entra ID 用户和 HTTP 密码。	Core	GA
az hdinsight credentials wait	将 CLI 置于等待状态，直到操作完成。	Core	GA
az hdinsight delete	删除指定的 HDInsight 群集。	Core	GA
az hdinsight host	管理 HDInsight 群集的虚拟主机。	Core	GA
az hdinsight host list	列出指定 HDInsight 群集的主机。	Core	GA
az hdinsight host restart	重启指定 HDInsight 群集的特定主机。	Core	GA
az hdinsight list	列出资源组或订阅中的 HDInsight 群集。	Core	GA
az hdinsight list-usage	列出指定位置的用法。	Core	GA
az hdinsight monitor	管理 HDInsight 群集上的经典 Azure Monitor 日志集成。	Core	GA
az hdinsight monitor disable	禁用 HDInsight 群集上的经典 Azure Monitor 日志集成。	Core	GA
az hdinsight monitor enable	在 HDInsight 群集上启用经典 Azure Monitor 日志集成。	Core	GA
az hdinsight monitor show	获取 HDInsight 群集上的经典 Azure Monitor 日志集成的状态。	Core	GA
az hdinsight resize	将指定的 HDInsight 群集调整为指定大小。	Core	GA
az hdinsight rotate-disk-encryption-key	轮换指定的 HDInsight 群集的磁盘加密密钥。	Core	GA
az hdinsight script-action	管理 HDInsight 脚本操作。	Core	GA
az hdinsight script-action delete	删除群集的指定持久化脚本作。	Core	GA
az hdinsight script-action execute	在指定的 HDInsight 群集上执行脚本操作。	Core	GA
az hdinsight script-action list	列出指定群集的所有持久化脚本作。	Core	GA
az hdinsight script-action list-execution-history	列出指定群集的所有脚本执行历史记录。	Core	GA
az hdinsight script-action promote	将指定的即席脚本执行提升为持久化脚本。	Core	GA
az hdinsight script-action show-execution-details	获取给定脚本执行 ID 的脚本执行详细信息。	Core	GA
az hdinsight show	获取指定的群集。	Core	GA
az hdinsight update	更新指定 HDInsight 群集的标记或标识。 设置标识属性将替代群集的现有标识配置。	Core	GA
az hdinsight wait	将 CLI 置于等待状态，直到操作完成。	Core	GA

az hdinsight create --name
                    --resource-group
                    --type
                    [--assign-identity]
                    [--autoscale-count --autoscale-workernode-count]
                    [--autoscale-max-count --autoscale-max-workernode-count]
                    [--autoscale-min-count --autoscale-min-workernode-count]
                    [--autoscale-type {Load, Schedule}]
                    [--cluster-admin-account]
                    [--cluster-admin-password]
                    [--cluster-configurations]
                    [--cluster-tier {Premium, Standard}]
                    [--cluster-users-group-dns]
                    [--component-version]
                    [--compute-isolation --enable-compute-isolation {false, true}]
                    [--days {Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                    [--domain]
                    [--edgenode-size]
                    [--enable-private-link {false, true}]
                    [--encryption-algorithm {RSA-OAEP, RSA-OAEP-256, RSA1_5}]
                    [--encryption-at-host {false, true}]
                    [--encryption-in-transit {false, true}]
                    [--encryption-key-name]
                    [--encryption-key-version]
                    [--encryption-vault-uri]
                    [--entra-uid --entra-user-identity]
                    [--entra-uinfo --entra-user-full-info]
                    [--esp]
                    [--headnode-size]
                    [--host-sku]
                    [--http-password]
                    [--http-user]
                    [--idbroker]
                    [--kafka-client-group-id]
                    [--kafka-client-group-name]
                    [--kafka-management-node-count]
                    [--kafka-management-node-size]
                    [--ldaps-urls]
                    [--location]
                    [--minimal-tls-version {1.2}]
                    [--no-validation-timeout]
                    [--no-wait]
                    [--outbound-dependencies-managed-type --outbound-managed-type {External, Managed}]
                    [--private-link-config --private-link-configurations]
                    [--public-ip-tag-type]
                    [--public-ip-tag-value]
                    [--resource-provider-connection --rp-connection {Inbound, Outbound}]
                    [--ssh-password]
                    [--ssh-public-key]
                    [--ssh-user]
                    [--storage-account]
                    [--storage-account-key]
                    [--storage-account-managed-identity]
                    [--storage-container]
                    [--storage-filesystem]
                    [--subnet]
                    [--tags]
                    [--time]
                    [--timezone]
                    [--version]
                    [--vnet-name]
                    [--workernode-count]
                    [--workernode-data-disk-size]
                    [--workernode-data-disk-storage-account-type {premium_lrs, standard_lrs}]
                    [--workernode-data-disks-per-node]
                    [--workernode-size]
                    [--zones]
                    [--zookeepernode-size]

示例

使用现有存储帐户创建群集。

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount

使用最低 tls 版本创建群集。

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount --minimal-tls-version 1.2

创建启用传输中加密的群集。

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount --encryption-in-transit true

在主机上创建具有加密的群集。

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount --encryption-at-host true

使用企业安全性套餐（ESP）创建群集。

az hdinsight create --esp -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount \
--subnet "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyRG/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/subnet1" \
--domain "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyRG/providers/Microsoft.AAD/domainServices/MyDomain.onmicrosoft.com" \
--assign-identity "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MyMsiRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyMSI" \
--cluster-admin-account MyAdminAccount@MyDomain.onmicrosoft.com \
--cluster-users-group-dns MyGroup

使用企业安全性套餐（ESP）创建群集并启用 HDInsight ID Broker。

az hdinsight create --esp --idbroker -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount \
--subnet "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyRG/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/subnet1" \
--domain "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyRG/providers/Microsoft.AAD/domainServices/MyDomain.onmicrosoft.com" \
--assign-identity "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/MyMsiRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyMSI" \
--cluster-admin-account MyAdminAccount@MyDomain.onmicrosoft.com \
--cluster-users-group-dns MyGroup

使用磁盘加密创建 Kafka 群集。 请参见https://learn.microsoft.com/azure/hdinsight/kafka/apache-kafka-byok.

az hdinsight create -t kafka -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" --workernode-data-disks-per-node 2 \
--storage-account MyStorageAccount \
--encryption-key-name kafkaClusterKey \
--encryption-key-version 00000000000000000000000000000000 \
--encryption-vault-uri https://MyKeyVault.vault.azure.net \
--assign-identity MyMSI

使用 kafka rest 代理创建 kafka 群集。

az hdinsight create -t kafka -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" --workernode-data-disks-per-node 2 \
--storage-account MyStorageAccount \
--kafka-management-node-size "Standard_D4_v2" \
--kafka-client-group-id MySecurityGroupId \
--kafka-client-group-name MySecurityGroupName
--component-version kafka=2.1

创建包含 Azure Data Lake Storage Gen2 的群集

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount \
--storage-account-managed-identity MyMSI

使用 JSON 字符串配置创建群集。

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount \
--cluster-configuration {'gateway':{'restAuthCredential.username':'admin'}}

从本地文件创建配置群集。

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount \
--cluster-configuration @config.json

创建基于负载的自动缩放的群集。

az hdinsight create -t spark --version 3.6 -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" --storage-account MyStorageAccount \
--autoscale-type Load --autoscale-min-workernode-count 3 --autoscale-max-workernode-count 5

创建基于计划的自动缩放的群集。

az hdinsight create -t spark --version 3.6 -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" --storage-account MyStorageAccount \
--autoscale-type Schedule --timezone "Pacific Standard Time" --days Monday \
--time 09:00 --autoscale-workernode-count 5

使用中继出站和专用链接功能创建群集。

az hdinsight create -t spark --version 3.6 -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" --storage-account MyStorageAccount \
--subnet "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/fakevnet/subnets/default" \
--resource-provider-connection Outbound --enable-private-link

创建具有计算隔离功能的群集。

az hdinsight create -t spark --version 3.6 -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" --storage-account MyStorageAccount \
--enable-compute-isolation --workernode-size "Standard_E8S_V3" --headnode-size "Standard_E8S_V3"

使用 WASB + MSI 创建群集。

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
-p "HttpPassword1234!" \
--storage-account MyStorageAccount \
--storage-account-managed-identity MyMSI

使用 Entra User By objectId 或 upn 创建 entra 用户群集（逗号分隔）

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
--ssh-password "sshPassword1234!" \
--storage-account MyStorageAccount \
--entra-user-identity "00000000-0000-0000-0000-000000000000","00000000-0000-0000-0000-000000000000","user@contoso.com"

使用 Entra User By objectId 或 upn 创建 entra 用户群集（逗号分隔，使用短名称）

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
--ssh-password "sshPassword1234!" \
--storage-account MyStorageAccount \
--entra-uid "00000000-0000-0000-0000-000000000000","00000000-0000-0000-0000-000000000000","user@contoso.com"

使用 Entra User By objectId 或 upn 创建 entra 用户群集（空格分隔）

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
--ssh-password "sshPassword1234!" \
--storage-account MyStorageAccount \
--entra-user-identity "00000000-0000-0000-0000-000000000000" "00000000-0000-0000-0000-000000000000" "user@contoso.com"

使用 Entra User By JSON 字符串创建 entra 用户群集

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
--ssh-password "sshPassword1234!" \
--storage-account MyStorageAccount \
--entra-user-full-info '[{"objectId": "00000000-0000-0000-0000-000000000000","displayName": "name","upn": "user@contoso.com"}]'

使用 JSON 字符串创建包含 Entra User 的 entra 用户群集（使用短名称）

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
--ssh-password "sshPassword1234!" \
--storage-account MyStorageAccount \
--entra-uinfo '[{"objectId": "00000000-0000-0000-0000-000000000000","displayName": "name","upn": "user@contoso.com"}]'

使用 Entra User By JSON 文件创建 entra 用户群集

az hdinsight create -t spark -g MyResourceGroup -n MyCluster \
--ssh-password "sshPassword1234!" \
--storage-account MyStorageAccount \
--entra-user-full-info @config.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

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

--verbose

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

属性	值
默认值:	False

az hdinsight delete --name
                    --resource-group
                    [--no-wait]
                    [--yes]

必需参数

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

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

属性	值
默认值:	False

az hdinsight list [--resource-group]

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

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

属性	值
默认值:	False

az hdinsight list-usage --location

必需参数

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

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

属性	值
默认值:	False

az hdinsight resize --name
                    --resource-group
                    --workernode-count
                    [--no-wait]

示例

重设群集的工作节点大小。

az hdinsight resize --name MyCluster --resource-group rg --workernode-count 5

必需参数

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

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

属性	值
默认值:	False

az hdinsight rotate-disk-encryption-key --encryption-key-name
                                        --encryption-key-version
                                        --encryption-vault-uri
                                        --name
                                        --resource-group
                                        [--no-wait]

必需参数

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

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

属性	值
默认值:	False

az hdinsight show --name
                  --resource-group

必需参数

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

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

属性	值
默认值:	False

az hdinsight update --name
                    --resource-group
                    [--assign-identity]
                    [--assign-identity-type]
                    [--no-wait]
                    [--tags]

示例

更新标记。

az hdinsight update --name MyCluster --resource-group rg --tags key=value

使用单个 UserAssigned msi 更新管理标识。

az hdinsight update --name MyCluster --resource-group rg --assign-identity-type UserAssigned --assign-identity MyMsi

使用多个 UserAssigned msi 更新管理标识。

az hdinsight update --name MyCluster --resource-group rg --assign-identity-type UserAssigned --assign-identity MyMsi1 MyMsi2

更新 SystemAssigned 管理标识。

az hdinsight update --name MyCluster --resource-group rg --assign-identity-type SystemAssigned

使用 SystemAssigned、UserAssigned msi 更新管理标识。

az hdinsight update --name MyCluster --resource-group rg --assign-identity-type "SystemAssigned,UserAssigned" --assign-identity MyMsi1

必需参数

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

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

属性	值
默认值:	False

az hdinsight wait --name
                  --resource-group
                  [--created]
                  [--custom]
                  [--deleted]
                  [--exists]
                  [--interval]
                  [--timeout]
                  [--updated]

必需参数

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

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

属性	值
默认值:	False