Udostępnij przez


az aks machine

Note

Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w 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
                   [--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]

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.

--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
--kubernetes-version

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

--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-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.

--os-sku

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

Właściwość Wartość
Dopuszczalne wartości: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, 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
--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, strefach 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
                      [--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.

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