az networkcloud kubernetescluster
注意
此參考是 Azure CLI 網路雲端 擴充功能的一部分 （2.51.0 版或更高版本）。 擴充功能會在您第一次執行 az networkcloud kubernetescluster 命令時自動安裝。 深入了解擴充功能。
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
管理 Kubernetes 叢集。
命令
az networkcloud kubernetescluster create
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
建立新的 Kubernetes 叢集，或更新現有叢集的屬性。
az networkcloud kubernetescluster create --control-plane-node-configuration
--extended-location
--initial-agent-pool-configurations
--kubernetes-cluster-name
--kubernetes-version
--network-configuration
--resource-group
[--aad-configuration]
[--admin-username]
[--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
[--location]
[--managed-resource-group-configuration]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--ssh-dest-key-path]
[--ssh-key-values]
[--tags]範例
建立或更新 Kubernetes 叢集
az networkcloud kubernetescluster create --name "kubernetesClusterName" --resource-group "resourceGroupName" --location "location" --kubernetes-version "1.XX.Y" --extended-location name="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName" type=CustomLocation --aad-configuration admin-group-object-ids=["f110271b-XXXX-4163-9b99-214d91660f0e"] --admin-username "azureuser" --ssh-key-values "ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm" --initial-agent-pool-configurations "[{count:1,mode:'System',name:'systemPool-1',vmSkuName:'NC-XXXXX',agentOptions:{hugepagesCount:96,hugepagesSize:1G},upgradeSettings:{maxSurge:'10%'},adminUsername:'azureuser',ssh-key-values:['ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm']}]" --control-plane-node-configuration count=1 vmSkuName='NC-YYYYY' adminUsername='azureuser' ssh-key-values="['ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm']" --network-configuration cloud-services-network-id="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName" cni-network-id="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName" pod-cidrs=["10.244.0.0/16"] service-cidrs=["10.96.0.0/16"] dns-service-ip="10.96.0.10" attached-network-configuration.l2-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName',pluginType:'DPDK'}]" attached-network-configuration.l3-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName',pluginType:'SRIOV',ipamEnabled:'False'}]" attached-network-configuration.trunked-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName',pluginType:'MACVLAN'}]" bgp-service-load-balancer-configuration.bgp-advertisements="[{advertiseToFabric:'True',communities:['64512:100'],ipAddressPools:['pool1'],peers:['peer1']}]" bgp-service-load-balancer-configuration.fabric-peering-enabled="True" bgp-service-load-balancer-configuration.bgp-peers="[{bfdEnabled:'False',bgpMultiHop:'False',holdTime:'P300s',keepAliveTime:'P300s',myAsn:64512,name:'peer1',peerAddress:'203.0.113.254',peerAsn:64497,peerPort:179}]" bgp-service-load-balancer-configuration.ip-address-pools="[{addresses:['198.51.102.0/24'],autoAssign:'True',name:'pool1',onlyUseHostIps:'True'}]"必要參數
這個 Kubernetes 叢集控制平面的定義特性。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
與資源相關聯的叢集擴充位置。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
使用此 Kubernetes 叢集建立的代理程式組件區，用於執行重要的系統服務和工作負載。 此欄位中的這項資料只會在建立期間使用，而且在建立 Kubernetes 叢集之後，欄位將會是空的。 建立之後，代理程式組件區的管理會使用 agentPools 子資源來完成。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
Kubernetes 叢集的名稱。
此叢集的 Kubernetes 版本。 接受 n.n、n.n.n 和 n.n.n-n 格式。 建立或更新之後，所使用的解譯版本將會解析為此欄位。
Kubernetes 叢集網路的設定，包括跨越叢集的網路附件。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
選擇性參數
Azure Active Directory 整合屬性。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
將套用至執行 Kubernetes 節點之作業系統之系統管理員的使用者名稱。 如果未提供，服務將會選擇使用者名稱。
如果遺失，請產生 SSH 公開和私密金鑰檔案。 金鑰會儲存在 '~/.ssh' 底下。
未指定資源所在的地理位置，將會使用資源群組的位置。
與資源相關聯的受控資源群組組態。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
請勿等候長時間執行的作業完成。
ssh 公開金鑰的空間分隔路徑清單。 您可以提供檔案路徑或目錄。 如果提供目錄，將會嘗試載入找到的所有公開金鑰（.pub）。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
以空格分隔的 SSH 公開金鑰清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud kubernetescluster delete
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
刪除提供的 Kubernetes 叢集。
az networkcloud kubernetescluster delete [--ids]
[--kubernetes-cluster-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]範例
刪除 Kubernetes 叢集
az networkcloud kubernetescluster delete --name "kubernetesClusterName" --resource-group "resourceGroupName"選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
Kubernetes 叢集的名稱。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 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 kubernetescluster list
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
列出所提供訂用帳戶中的 Kubernetes 叢集。
az networkcloud kubernetescluster list [--max-items]
[--next-token]
[--resource-group]範例
列出訂用帳戶的 Kubernetes 叢集
az networkcloud kubernetescluster list列出資源群組的 Kubernetes 叢集
az networkcloud kubernetescluster list --resource-group "resourceGroupName"選擇性參數
命令輸出中要傳回的專案總數。 如果可用的專案總數超過指定的值，則會在命令的輸出中提供權杖。 若要繼續分頁，請在後續命令的引數中 --next-token 提供權杖值。
標記，指定要開始分頁的位置。 這是先前截斷回應中的權杖值。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud kubernetescluster restart-node
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
重新開機 Kubernetes 叢集的目標節點。
az networkcloud kubernetescluster restart-node --node-name
[--ids]
[--kubernetes-cluster-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]範例
重新開機 Kubernetes 叢集節點
az networkcloud kubernetescluster restart-node --node-name "nodeName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"必要參數
要重新開機的節點名稱。
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
Kubernetes 叢集的名稱。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 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 kubernetescluster show
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
取得所提供 Kubernetes 叢集的屬性。
az networkcloud kubernetescluster show [--ids]
[--kubernetes-cluster-name]
[--resource-group]
[--subscription]範例
取得 Kubernetes 叢集
az networkcloud kubernetescluster show --name "kubernetesClusterName" --resource-group "resourceGroupName"選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
Kubernetes 叢集的名稱。
資源組名。 您可以使用 來設定預設群組 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 kubernetescluster update
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
更新所提供 Kubernetes 叢集的屬性，或更新與 Kubernetes 叢集相關聯的標記。 屬性和標記更新可以獨立完成。
az networkcloud kubernetescluster update [--control-plane-node-configuration]
[--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--kubernetes-cluster-name]
[--kubernetes-version]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--ssh-dest-key-path]
[--ssh-key-values]
[--subscription]
[--tags]範例
修補 Kubernetes 叢集
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --kubernetes-version "1.25.4" --control-plane-node-configuration count="3" --tags key1="myvalue1" key2="myvalue2"更新 Kubernetes 叢集管理員認證
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm'更新 Kubernetes 叢集控制節點系統管理員認證
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --control-plane-node-configuration ssh-key-values="['ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm']"選擇性參數
可針對這個 Kubernetes 叢集修補的控制平面定義特性。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
如果遺失，請產生 SSH 公開和私密金鑰檔案。 金鑰會儲存在 '~/.ssh' 底下。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
Kubernetes 叢集的名稱。
此叢集的 Kubernetes 版本。 接受 n.n、n.n.n 和 n.n.n-n 格式。 建立或更新之後，所使用的解譯版本將會解析為此欄位。
請勿等候長時間執行的作業完成。
資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。
ssh 公開金鑰的空間分隔路徑清單。 您可以提供檔案路徑或目錄。 如果提供目錄，將會嘗試載入找到的所有公開金鑰（.pub）。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
以空格分隔的 SSH 公開金鑰清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
將取代現有資源的 Azure 資源標籤。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。
全域參數
增加記錄詳細資訊，以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤，隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az networkcloud kubernetescluster wait
命令群組 'az networkcloud' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus
將 CLI 置於等候狀態，直到符合條件為止。
az networkcloud kubernetescluster wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--kubernetes-cluster-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]選擇性參數
請等候在 'Succeeded' 使用 'provisioningState' 建立。
等到條件符合自訂 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。
等到刪除為止。
等候資源存在。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。
輪詢間隔以秒為單位。
Kubernetes 叢集的名稱。
資源組名。 您可以使用 來設定預設群組 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。
提交並檢視相關的意見反應