共用方式為

az aksarc nodepool

Note

此參考是 Azure CLI 的 aksarc 擴充功能的一部分（2.32.0 版或更高版本）。 擴充功能會在您第一次執行 az aksarc nodepool 命令時自動安裝。 深入了解擴充功能。

管理布建叢集中的節點集區。

命令

名稱 Description 類型 狀態
az aksarc nodepool add

在布建的叢集中新增 nodepool。

 Extension GA
az aksarc nodepool delete

刪除布建叢集中的 nodepool。

 Extension GA
az aksarc nodepool list

列出布建叢集中的所有節點集區。

 Extension GA
az aksarc nodepool scale

調整布建叢集中的 nodepool。

 Extension GA
az aksarc nodepool show

取得布建叢集中的 nodepool。

 Extension GA
az aksarc nodepool update

更新布建叢集中的 nodepool。

 Extension GA

az aksarc nodepool add

在布建的叢集中新增 nodepool。

az aksarc nodepool add --cluster-name
                       --name
                       --resource-group
                       [--enable-cluster-autoscaler]
                       [--labels]
                       [--max-count]
                       [--max-pods]
                       [--min-count]
                       [--no-wait]
                       [--node-count]
                       [--node-taints]
                       [--node-vm-size]
                       [--os-sku]
                       [--os-type]
                       [--tags]

範例

AddNodepool

az aksarc nodepool add --name "samplenodepool" --cluster-name "samplecluster" --resource-group "sample-rg"

必要參數

--cluster-name

布建叢集的名稱。

--name -n

nodepool 的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--enable-cluster-autoscaler -e

啟用已布建叢集的叢集自動調整程式。

屬性 值
預設值: False
--labels

以空格分隔的標籤：key[=value] [key[=value] ...]。

--max-count

自動調整的節點數目上限。

--max-pods -m

可在節點上執行的 Pod 數目上限。

--min-count

自動調整的節點數目下限。

--no-wait

請勿等候長時間執行的作業完成。

屬性 值
預設值: False
--node-count -c

要建立於 nodepool 中的節點數目。

--node-taints

以逗號分隔的 nodepool 污點清單。

--node-vm-size

nodepool 中節點的 VM 大小。

--os-sku

nodepool 中節點的OS Sku。 選項：“CBLMariner” |“Windows2019” |“Windows2022”。

--os-type

nodepool 中節點的 OS 類型。 選項：“Linux” |“Windows”。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az aksarc nodepool delete

刪除布建叢集中的 nodepool。

az aksarc nodepool delete --cluster-name
                          --name
                          --resource-group
                          [--no-wait]
                          [--yes]

範例

DeleteNodepool

az aksarc nodepool delete --name "samplenodepool" --cluster-name "samplecluster" --resource-group "sample-rg"

必要參數

--cluster-name

布建叢集的名稱。

--name -n

nodepool 的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--no-wait

請勿等候長時間執行的作業完成。

屬性 值
預設值: False
--yes -y

請勿提示確認。

屬性 值
預設值: False
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az aksarc nodepool list

列出布建叢集中的所有節點集區。

az aksarc nodepool list --cluster-name
                        --resource-group

範例

ListNodepool

az aksarc nodepool list --cluster-name "samplecluster" --resource-group "sample-rg"

必要參數

--cluster-name

布建叢集的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az aksarc nodepool scale

調整布建叢集中的 nodepool。

az aksarc nodepool scale --cluster-name
                         --name
                         --resource-group
                         [--no-wait]
                         [--node-count]
                         [--node-vm-size]
                         [--yes]

範例

ScaleNodePoolCount

az aksarc nodepool scale --name "samplenodepool" --cluster-name "samplecluster" --resource-group "sample-rg" --node-count 3

ScaleNodePoolVMSize

az aksarc nodepool scale --name "samplenodepool" --cluster-name "samplecluster" --resource-group "sample-rg" --node-vm-size "Standard_A2_v2"

必要參數

--cluster-name

布建叢集的名稱。

--name -n

nodepool 的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--no-wait

請勿等候長時間執行的作業完成。

屬性 值
預設值: False
--node-count -c

節點集區中要調整為的節點數目。

--node-vm-size

nodepool 中節點的 VM 大小。

--yes -y

請勿提示確認。

屬性 值
預設值: False
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az aksarc nodepool show

取得布建叢集中的 nodepool。

az aksarc nodepool show --cluster-name
                        --name
                        --resource-group

範例

GetNodepool

az aksarc nodepool show --name "samplenodepool" --cluster-name "samplecluster" --resource-group "sample-rg"

必要參數

--cluster-name

布建叢集的名稱。

--name -n

nodepool 的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az aksarc nodepool update

更新布建叢集中的 nodepool。

az aksarc nodepool update --cluster-name
                          --name
                          --resource-group
                          [--disable-cluster-autoscaler]
                          [--enable-cluster-autoscaler]
                          [--labels]
                          [--max-count]
                          [--min-count]
                          [--no-wait]
                          [--node-taints]
                          [--update-cluster-autoscaler]

範例

UpdateNodepool

az aksarc nodepool update --name "samplenodepool" --cluster-name "samplecluster" --resource-group "sample-rg" --disable-cluster-autoscaler

必要參數

--cluster-name

布建叢集的名稱。

--name -n

nodepool 的名稱。

--resource-group -g

資源組名。 您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--disable-cluster-autoscaler -d

停用已布建叢集的叢集自動調整程式。

屬性 值
預設值: False
--enable-cluster-autoscaler -e

啟用已布建叢集的叢集自動調整程式。

屬性 值
預設值: False
--labels

以空格分隔的標籤：key[=value] [key[=value] ...]。傳遞空字串以清除標籤。

--max-count

自動調整的節點數目上限。

--min-count

自動調整的節點數目下限。

--no-wait

請勿等候長時間執行的作業完成。

屬性 值
預設值: False
--node-taints

以逗號分隔的 nodepool 污點清單。 傳遞空字串以清除污點。

--update-cluster-autoscaler -u

更新已布建叢集的叢集自動調整程式。

屬性 值
預設值: False
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False