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。 請嘗試 「？？」 以顯示更多。
與叢集相關聯的網路網狀架構資源識別碼。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
選擇性參數
將用於儲存相關記錄之 Log Analytics 工作區的資源識別碼。
客戶提供的位置資訊，以識別叢集所在的位置。
叢集在 Arc Appliance 安裝期間要使用的服務主體。 支援速記語法、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/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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"選擇性參數
叢集的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
不提示確認。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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"選擇性參數
叢集的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
叢集中的裸機電腦名稱稱，應在環境驗證期間略過。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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"選擇性參數
叢集的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
如果掃描工作應該執行掃描，則選擇 。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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"選擇性參數
叢集的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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 Appliance 安裝期間要使用的服務主體。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
驗證臨界值，指出環境驗證和部署期間電腦器的允許失敗。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
多機架叢集中電腦架的機架定義清單，或單一機架叢集中的空白清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
叢集執行時間保護的設定。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
使用金鑰保存庫來儲存秘密的組態，以供操作員稍後擷取。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
將取代現有資源的 Azure 資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
更新叢集的策略。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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"必要參數
更新期間要套用至叢集的版本。
選擇性參數
叢集的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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']。
等到刪除為止。
等候資源存在。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
輪詢間隔以秒為單位。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
以秒為單位的等候上限。
等到 provisioningState 更新為 'Succeeded'。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應