az aks machine

Note

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。安裝每個擴充功能以受益於其擴充功能。深入了解擴充功能。

取得受控叢集節點集區中計算機的相關信息。

命令

名稱	Description	類型	狀態
az aks machine add	將機器新增至指定的節點集區。	Extension	GA
az aks machine list	取得 Agentpool 中所有機器的 IP 位址、主機名的相關信息。	Core	GA
az aks machine list (aks-preview 擴充功能)	列出 Agentpool 中所有電腦的詳細數據。	Extension	GA
az aks machine show	顯示 Managedcluster 代理程式集區中特定電腦的 IP 位址、主機名。	Core	GA
az aks machine show (aks-preview 擴充功能)	在 Managedcluster 的 Agentpool 中顯示特定電腦的詳細數據。	Extension	GA
az aks machine update	更新代理程式集區中指定的電腦。	Extension	GA

az aks machine add

將機器新增至指定的節點集區。

az aks machine add --cluster-name
                   --nodepool-name
                   --resource-group
                   [--disable-fips-image]
                   [--enable-fips-image]
                   [--enable-node-public-ip]
                   [--kubernetes-version]
                   [--machine-name]
                   [--no-wait]
                   [--node-public-ip-prefix-id]
                   [--node-public-ip-tags]
                   [--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual}]
                   [--os-type]
                   [--pod-subnet-id]
                   [--priority {Regular, Spot}]
                   [--tags]
                   [--vm-size]
                   [--vnet-subnet-id]
                   [--zones]

必要參數

--cluster-name

受控叢集的名稱。

--nodepool-name

受控叢集的 Agentpool 名稱。

--resource-group -g

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

選擇性參數

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

--disable-fips-image

切換為在電腦上使用未啟用 FIPS 的作業系統。

屬性	值
預設值:	False

--enable-fips-image

切換為在電腦上使用已啟用 FIPS 的作業系統。

屬性	值
預設值:	False

--enable-node-public-ip

啟用機器公用 IP。

屬性	值
預設值:	False

--kubernetes-version

用於建立機器的 Kubernetes 版本，例如 “1.7.12” 或 “1.8.7”。

--machine-name

機器的主機名稱。

--no-wait

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

屬性	值
預設值:	False

--node-public-ip-prefix-id

公用 IP 前置詞 ID 用於將公用 IP 指派給電腦。

--node-public-ip-tags

機器公用 IP 的 ipTags。

--os-sku

代理程序節點集區的os-sku。

屬性	值
接受的值:	AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual

--os-type

機器的作業系統類型。

--pod-subnet-id

現有 VNet 中要在電腦中指派網繭的子網路識別碼（需要 azure network-plugin）。

--priority

機器的優先順序。

屬性	值
接受的值:	Regular, Spot

--tags

機器的標籤。

--vm-size

機器的大小。

--vnet-subnet-id

現有 VNet 中要部署機器的子網路識別碼。

--zones -z

將放置機器的可用區域的空格分隔清單。

全域參數

--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 aks machine list

編輯

取得 Agentpool 中所有機器的 IP 位址、主機名的相關信息。

az aks machine list --cluster-name
                    --nodepool-name
                    --resource-group

範例

取得 Agentpool 中所有機器的 IP 位址、主機名、可用性區域的相關信息

az aks machine list  --resource-group <rg> --cluster-name <clusterName> --nodepool-name <apName>

必要參數

--cluster-name

受控叢集的名稱。

--nodepool-name

受控叢集的 Agentpool 名稱。

--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 aks machine list (aks-preview 擴充功能)

列出 Agentpool 中所有電腦的詳細數據。

az aks machine list --cluster-name
                    --nodepool-name
                    --resource-group

範例

列出 Agentpool 中所有電腦的詳細數據

az aks machine list --resource-group <resourceGroupName> --cluster-name <clusterName> --nodepool-name <apName>

必要參數

--cluster-name

受控叢集的名稱。

--nodepool-name

受控叢集的 Agentpool 名稱。

--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 aks machine show

編輯

顯示 Managedcluster 代理程式集區中特定電腦的 IP 位址、主機名。

az aks machine show --cluster-name
                    --machine-name
                    --nodepool-name
                    --resource-group

必要參數

--cluster-name

受控叢集的名稱。

--machine-name

受控叢集代理程式集區中的計算機名稱。

--nodepool-name

受控叢集的 Agentpool 名稱。

--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 aks machine show (aks-preview 擴充功能)

在 Managedcluster 的 Agentpool 中顯示特定電腦的詳細數據。

az aks machine show --cluster-name
                    --machine-name
                    --nodepool-name
                    --resource-group

範例

在 Managedcluster 的 Agentpool 中顯示特定電腦的詳細數據。

az aks machine show --resource-group <resourceGroupName> --cluster-name <clusterName> --nodepool-name <apName> --machine-name <machineName>

必要參數

--cluster-name

受控叢集的名稱。

--machine-name

計算機的名稱。

--nodepool-name

受控叢集的 Agentpool 名稱。

--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 aks machine update

更新代理程式集區中指定的電腦。

az aks machine update --cluster-name
                      --nodepool-name
                      --resource-group
                      [--labels]
                      [--machine-name]
                      [--no-wait]
                      [--node-taints]
                      [--tags]

必要參數

--cluster-name

受控叢集的名稱。

--nodepool-name

受控叢集的 Agentpool 名稱。

--resource-group -g

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

選擇性參數

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

--labels

機器的標籤。

--machine-name

機器的主機名稱。

--no-wait

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

屬性	值
預設值:	False

--node-taints

機器的污點。

--tags

機器的標籤。

全域參數

--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 aks machine

命令

az aks machine add

必要參數

選擇性參數

az aks machine list

範例

必要參數

az aks machine list (aks-preview 擴充功能)

範例

必要參數

az aks machine show

必要參數

az aks machine show (aks-preview 擴充功能)

範例

必要參數

az aks machine update

必要參數

選擇性參數

意見反應