az aks machine

Note

Ta grupa poleceń zawiera polecenia zdefiniowane w obu Azure CLI i co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Dowiedz się więcej o rozszerzeniach.

Uzyskaj informacje o maszynach w puli węzłów zarządzanych klastrów.

Polecenia

Nazwa	Opis	Typ	Stan
az aks machine add	Dodaj maszynę do określonej puli węzłów.	Extension	ogólna dostępność
az aks machine list	Uzyskaj informacje o adresach IP, nazwa hosta dla wszystkich maszyn w puli agentów.	Core	ogólna dostępność
az aks machine list (aks-preview rozszerzenie)	Wyświetl szczegóły wszystkich maszyn w puli agentów.	Extension	ogólna dostępność
az aks machine show	Pokaż adresy IP, nazwę hosta dla określonej maszyny w puli agentów dla zarządzanego klastra.	Core	ogólna dostępność
az aks machine show (aks-preview rozszerzenie)	Pokaż szczegóły określonego komputera w puli agentów zarządzanego klastra.	Extension	ogólna dostępność
az aks machine update	Zaktualizuj określoną maszynę w puli agentów.	Extension	ogólna dostępność

az aks machine add

Dodaj maszynę do określonej puli węzłów.

az aks machine add --cluster-name
                   --nodepool-name
                   --resource-group
                   [--acquire-policy-token]
                   [--change-reference]
                   [--disable-fips-image]
                   [--enable-fips-image]
                   [--enable-node-public-ip]
                   [--enable-ultra-ssd]
                   [--eviction-policy {Deallocate, Delete}]
                   [--kubernetes-version]
                   [--labels]
                   [--machine-name]
                   [--max-pods]
                   [--no-wait]
                   [--node-public-ip-prefix-id]
                   [--node-public-ip-tags]
                   [--node-taints]
                   [--os-sku {AzureContainerLinux, AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Ubuntu2604, Windows2019, Windows2022, Windows2025, WindowsAnnual}]
                   [--os-type]
                   [--pod-subnet-id]
                   [--priority {Regular, Spot}]
                   [--spot-max-price]
                   [--tags]
                   [--vm-size]
                   [--vnet-subnet-id]
                   [--zones]

Parametry wymagane

--cluster-name

Nazwa klastra zarządzanego.

--nodepool-name

Nazwa puli agentów zarządzanego klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość	Wartość
Grupa parametrów:	Global Policy Arguments

--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość	Wartość
Grupa parametrów:	Global Policy Arguments

--disable-fips-image

Przełącz się, aby używać systemu operacyjnego z obsługą innych niż FIPS na maszynie.

Właściwość	Wartość
Domyślna wartość:	False

--enable-fips-image

Przejdź do korzystania z systemu operacyjnego z obsługą protokołu FIPS na maszynie.

Właściwość	Wartość
Domyślna wartość:	False

--enable-node-public-ip

Włącz publiczny adres IP maszyny.

Właściwość	Wartość
Domyślna wartość:	False

--enable-ultra-ssd

Czy włączyć warstwę UltraSSD.

Właściwość	Wartość
Domyślna wartość:	False

--eviction-policy

Polityka eksmisji dla maszyny. Nie można tego określić, chyba że priorytetem jest "Spot". Jeśli nie zostanie określony, wartość domyślna to "Usuń".

Właściwość	Wartość
Dopuszczalne wartości:	Deallocate, Delete

--kubernetes-version

Wersja platformy Kubernetes używana do tworzenia maszyny, na przykład "1.7.12" lub "1.8.7".

--labels

Etykiety węzłów dla maszyny FlexNode.

--machine-name

Nazwa hosta maszyny.

--max-pods -m

Maksymalna liczba zasobników dla maszyny FlexNode.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość	Wartość
Domyślna wartość:	False

--node-public-ip-prefix-id

Identyfikator prefiksu publicznego adresu IP używany do przypisywania publicznych adresów IP do maszyny.

--node-public-ip-tags

IpTags publicznych adresów IP maszyny.

--node-taints

Węzły są skażone dla maszyny FlexNode.

--os-sku

Jednostka os-SKU puli węzłów agenta.

Właściwość	Wartość
Dopuszczalne wartości:	AzureContainerLinux, AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Ubuntu2604, Windows2019, Windows2022, Windows2025, WindowsAnnual

--os-type

Typ systemu operacyjnego maszyny.

--pod-subnet-id

Identyfikator podsieci w istniejącej sieci wirtualnej, do której ma zostać przypisane zasobniki na maszynie (wymaga wtyczki azure network-plugin).

--priority

Priorytet maszyny.

Właściwość	Wartość
Dopuszczalne wartości:	Regular, Spot

--spot-max-price

Maksymalna cena (w dolarach amerykańskich) jest gotowa zapłacić za wystąpienia typu spot.

Właściwość	Wartość
Domyślna wartość:	nan

--tags

Tagi maszyny.

--vm-size

Rozmiar maszyny.

--vnet-subnet-id

Identyfikator podsieci w istniejącej sieci wirtualnej, w której ma zostać wdrożona maszyna.

--zones -z

Rozdzielona spacjami lista stref dostępności, w których zostanie umieszczona maszyna.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

az aks machine list

Uzyskaj informacje o adresach IP, nazwa hosta dla wszystkich maszyn w puli agentów.

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

Przykłady

Uzyskaj informacje o adresach IP, nazwie hosta, Strefy dostępności dla wszystkich maszyn w puli agentów

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

Parametry wymagane

--cluster-name

Nazwa klastra zarządzanego.

--nodepool-name

Nazwa puli agentów zarządzanego klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

az aks machine list (aks-preview rozszerzenie)

Wyświetl szczegóły wszystkich maszyn w puli agentów.

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

Przykłady

Wyświetlanie listy szczegółów dotyczących wszystkich maszyn w puli agentów

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

Parametry wymagane

--cluster-name

Nazwa klastra zarządzanego.

--nodepool-name

Nazwa puli agentów zarządzanego klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

az aks machine show

Pokaż adresy IP, nazwę hosta dla określonej maszyny w puli agentów dla zarządzanego klastra.

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

Parametry wymagane

--cluster-name

Nazwa klastra zarządzanego.

--machine-name

Nazwa maszyny w puli agentów zarządzanego klastra.

--nodepool-name

Nazwa puli agentów zarządzanego klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

az aks machine show (aks-preview rozszerzenie)

Pokaż szczegóły określonego komputera w puli agentów zarządzanego klastra.

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

Przykłady

Pokaż szczegóły określonego komputera w puli agentów zarządzanego klastra.

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

Parametry wymagane

--cluster-name

Nazwa klastra zarządzanego.

--machine-name

Nazwa maszyny.

--nodepool-name

Nazwa puli agentów zarządzanego klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

az aks machine update

Zaktualizuj określoną maszynę w puli agentów.

az aks machine update --cluster-name
                      --nodepool-name
                      --resource-group
                      [--acquire-policy-token]
                      [--change-reference]
                      [--kubernetes-version]
                      [--labels]
                      [--machine-name]
                      [--no-wait]
                      [--node-taints]
                      [--tags]

Parametry wymagane

--cluster-name

Nazwa klastra zarządzanego.

--nodepool-name

Nazwa puli agentów zarządzanego klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość	Wartość
Grupa parametrów:	Global Policy Arguments

--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość	Wartość
Grupa parametrów:	Global Policy Arguments

--kubernetes-version

Wersja rozwiązania Kubernetes dla maszyny FlexNode. Ta opcja nie jest obsługiwana w przypadku zwykłych maszyn.

--labels

Etykiety maszyny.

--machine-name

Nazwa hosta maszyny.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość	Wartość
Domyślna wartość:	False

--node-taints

Defekty maszyny.

--tags

Tagi maszyny.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość	Wartość
Domyślna wartość:	False

--output -o

Format danych wyjściowych.

Właściwość	Wartość
Domyślna wartość:	json
Dopuszczalne wartości:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość	Wartość
Domyślna wartość:	False