你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
az networkcloud cluster
注意
此参考是 Azure CLI（版本 2.51.0 或更高版本）的网络云扩展的一部分。 该扩展将在首次运行 az networkcloud cluster 命令时自动安装。 详细了解扩展。
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
管理群集。
命令
az networkcloud cluster create
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
创建新群集或更新群集的属性（如果存在）。
az networkcloud cluster create --aggregator-or-single-rack-definition
--cluster-name
--cluster-type {MultiRack, SingleRack}
--cluster-version
--extended-location
--network-fabric-id
--resource-group
[--analytics-workspace-id]
[--cluster-location]
[--cluster-service-principal]
[--compute-deployment-threshold]
[--compute-rack-definitions]
[--location]
[--managed-resource-group-configuration]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--runtime-protection]
[--secret-archive]
[--tags]
[--update-strategy]示例
创建或更新单机架群集
az networkcloud cluster create --name "clusterName" -g "resourceGroupName" --extended-location name="/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterManagerExtendedLocationName" type="CustomLocation" --location "eastus" --analytics-workspace-id "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/microsoft.operationalInsights/workspaces/logAnalyticsWorkspaceName" --cluster-location "Foo Street, 3rd Floor, row 9" --cluster-service-principal application-id="12345678-1234-1234-1234-123456789012" password="password" principal-id="00000008-0004-0004-0004-000000000012" tenant-id="80000000-4000-4000-4000-120000000000" --cluster-type "SingleRack" --cluster-version "3.0.0" --compute-deployment-threshold type="PercentSuccess" grouping="PerCluster" value=90 --network-fabric-id "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default" --aggregator-or-single-rack-definition network-rack-id="/subscriptions/subscriptionId/resourceGroups/rgName/providers/Microsoft.Network/virtualNetworks/cmName/subnets/ClusterManagerSubnet" rack-sku-id="/subscriptions/subscriptionId/providers/Microsoft.NetworkCloud/rackSkus/VLab_Single_DellR750_8C2M_x70r3_9" rack-serial-number=b99m99r1 rack-location='b99m99r1' availability-zone=1 storage-appliance-configuration-data="[{rackSlot:1,adminCredentials:{username:'adminuser',password:'password'},storageApplianceName:name,serialNumber:serial}]" bare-metal-machine-configuration-data="[{bmcCredentials:{password:'bmcPassword',username:'root'},bmcMacAddress:'AA:BB:CC:DD:E7:08',bootMacAddress:'AA:BB:CC:F8:71:2E',machineName:lab00r750wkr1,rackSlot:2,serialNumber:5HS7PK3},{bmcCredentials:{password:'bmcPassword',username:'root'},bmcMacAddress:'AA:BB:CC:FD:DC:76',bootMacAddress:'AA:BB:CC:F8:50:CA',machineName:lab00r750wkr8,rackSlot:11,serialNumber:9M56PK3}]" --tags key1="myvalue1" key2="myvalue2"使用 json 文件输入创建或更新单机架群集
az networkcloud cluster create --name "clusterName" -g "resourceGroupName" --extended-location name="/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterManagerExtendedLocationName" type="CustomLocation" --location "eastus" --analytics-workspace-id "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/microsoft.operationalInsights/workspaces/logAnalyticsWorkspaceName" --cluster-location "Foo Street, 3rd Floor, row 9" --cluster-service-principal application-id="12345678-1234-1234-1234-123456789012" password="password" principal-id="00000008-0004-0004-0004-000000000012" tenant-id="80000000-4000-4000-4000-120000000000" --cluster-type "SingleRack" --cluster-version "3.0.0" --compute-deployment-threshold type="PercentSuccess" grouping="PerCluster" value=90 --network-fabric-id "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default" --aggregator-or-single-rack-definition ./aggregator-or-single-rack-definition.json --tags key1="myvalue1" key2="myvalue2必需参数
旨在仅反映单个机架群集中的单个机架或多机架群集中的聚合器机架的机架定义。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
群集的名称。
群集的机架配置类型。
群集的当前运行时版本。
与群集关联的群集管理器的扩展位置。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
与群集关联的 Network Fabric 的资源 ID。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
可选参数
将用于存储相关日志的 Log Analytics 工作区的资源 ID。
客户提供的位置信息，用于标识群集所在的位置。
群集在 Arc 设备安装过程中要使用的服务主体。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
验证阈值，指示环境验证和部署期间计算计算机的允许失败。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
多机架群集中计算机架的机架定义列表，或单机架群集中的空列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
未指定资源所在的地理位置，将使用资源组的位置。
与资源关联的托管资源组的配置。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
不等待长时间运行的操作完成。
群集运行时保护的设置。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
用于使用密钥保管库存储机密的配置，供操作员稍后检索。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
资源标记。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
更新群集的策略。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkcloud cluster delete
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
删除提供的群集。
az networkcloud cluster delete [--cluster-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]示例
删除群集
az networkcloud cluster delete --name "clusterName" --resource-group "resourceGroupName"可选参数
群集的名称。
一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
不提示确认。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkcloud cluster deploy
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
部署群集。
az networkcloud cluster deploy [--cluster-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--skip-validations-for-machines]
[--subscription]示例
部署群集
az networkcloud cluster deploy --name "clusterName" --resource-group "resourceGroupName"可选参数
群集的名称。
一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
群集中应在环境验证期间跳过的裸机计算机的名称。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkcloud cluster list
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
列出提供的资源组或订阅中的群集。
az networkcloud cluster list [--max-items]
[--next-token]
[--resource-group]示例
列出资源组的群集
az networkcloud cluster list --resource-group "resourceGroupName"列出订阅的群集
az networkcloud cluster list可选参数
命令输出中要返回的项总数。 如果可用的项总数大于指定的值，则会在命令的输出中提供令牌。 若要恢复分页，请在后续命令的参数中 --next-token 提供令牌值。
用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkcloud cluster scan-runtime
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
触发运行时保护扫描的执行，根据群集配置检测和修正检测到的问题。
az networkcloud cluster scan-runtime [--cluster-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--scan-activity {Scan, Skip}]
[--subscription]示例
在群集上执行运行时保护扫描
az networkcloud cluster scan-runtime -n "clusterName" -g "resourceGroupName" --scan-activity "Scan"可选参数
群集的名称。
一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
选择扫描操作是否应运行扫描。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkcloud cluster show
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
获取提供的群集的属性。
az networkcloud cluster show [--cluster-name]
[--ids]
[--resource-group]
[--subscription]示例
获取群集
az networkcloud cluster show --name "clusterName" --resource-group "resourceGroupName"可选参数
群集的名称。
一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkcloud cluster update
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
更新提供的群集的属性，或更新与群集关联的标记。 属性和标记更新可以独立完成。
az networkcloud cluster update [--aggregator-or-single-rack-definition]
[--cluster-location]
[--cluster-name]
[--cluster-service-principal]
[--compute-deployment-threshold]
[--compute-rack-definitions]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--runtime-protection]
[--secret-archive]
[--subscription]
[--tags]
[--update-strategy]示例
修补群集位置
az networkcloud cluster update --name "clusterName" --resource-group "resourceGroupName" --cluster-location "Foo Street, 3rd Floor, row 9" --tags key1="myvalue1" key2="myvalue2"修补群集聚合器OrSingleRackDefinition
az networkcloud cluster update --name "clusterName" --resource-group "resourceGroupName --aggregator-or-single-rack-definition "{networkRackId:'/subscriptions/subscriptionId/resourceGroups/rgName/providers/Microsoft.Network/virtualNetworks/cmName/subnets/ClusterManagerSubnet',rackSkuId:'/subscriptions/subscriptionId/providers/Microsoft.NetworkCloud/rackSkus/VLab_Single_DellR750_8C2M_x70r3_9',rackSerialNumber:b99m99r1,rackLocation:b99m99r1,availabilityZone:1,storageApplianceConfigurationData:[{rackSlot:1,adminCredentials:{username:'adminuser',password:'password'},storageApplianceName:name,serialNumber:serial}],bareMetalMachineConfigurationData:[{bmcCredentials:{password:'bmcPassword',username:'root'},bmcMacAddress:'AA:BB:CC:DD:E7:08',bootMacAddress:'AA:BB:CC:F8:71:2E',machineName:lab00r750wkr1,rackSlot:2,serialNumber:5HS7PK3},{bmcCredentials:{password:'bmcPassword',username:'root'},bmcMacAddress:'AA:BB:CC:FD:DC:76',bootMacAddress:'AA:BB:CC:F8:50:CA',machineName:lab00r750wkr8,rackSlot:11,serialNumber:9M56PK3}]}" --compute-deployment-threshold type="PercentSuccess" grouping="PerCluster" value=90 --tags key1="myvalue1" key2="myvalue2"使用 json 文件输入修补群集聚合器OrSingleRackDefinition
az networkcloud cluster update --name "clusterName" --resource-group "resourceGroupName" --aggregator-or-single-rack-definition ./aggregator-or-single-rack-definition.json --compute-deployment-threshold type="PercentSuccess" grouping="PerCluster" value=90 --tags key1="myvalue1" key2="myvalue2"修补群集运行时保护配置
az az networkcloud cluster update --name "clusterName" --resource-group "resourceGroupName" --runtime-protection enforcement-level="OnDemand"修补机密存档
az networkcloud cluster update --name "clusterName" --resource-group "resourceGroupName" --secret-archive use-key-vault=True key-vault-id="/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.KeyVault/vaults/keyVaultName"修补程序更新策略
az networkcloud cluster update --name "clusterName" --resource-group "resourceGroupName" --update-strategy strategy-type="Rack" threshold-type="CountSuccess" threshold-value=4 max-unavailable=4 wait-time-minutes=10可选参数
旨在仅反映单个机架群集中的单个机架或多机架群集中的聚合器机架的机架定义。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
客户提供的位置信息，用于标识群集所在的位置。
群集的名称。
群集在 Arc 设备安装过程中要使用的服务主体。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
验证阈值，指示环境验证和部署期间计算计算机的允许失败。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
多机架群集中计算机架的机架定义列表，或单机架群集中的空列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
群集运行时保护的设置。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
用于使用密钥保管库存储机密的配置，供操作员稍后检索。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
将替换现有标记的 Azure 资源标记。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
更新群集的策略。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkcloud cluster update-version
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
将提供的群集版本更新为可用支持版本之一。
az networkcloud cluster update-version --target-cluster-version
[--cluster-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]示例
更新群集版本
az networkcloud cluster update-version --cluster-name "clusterName" --target-cluster-version "2.0" --resource-group "resourceGroupName"必需参数
更新期间要应用于群集的版本。
可选参数
群集的名称。
一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az networkcloud cluster wait
命令组“az networkcloud”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus
将 CLI 置于等待状态，直到满足条件。
az networkcloud cluster wait [--cluster-name]
[--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--resource-group]
[--subscription]
[--timeout]
[--updated]可选参数
群集的名称。
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。
等到删除为止。
等待资源存在。
一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
轮询间隔（以秒为单位）。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
最大等待（以秒为单位）。
等到 provisioningState 更新为“Succeeded”。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈