Freigeben über

az aks machine

Note

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Erfahren Sie mehr über Erweiterungen.

Abrufen von Informationen zu Computern in einem Knotenpool eines verwalteten Clusters.

Befehle

Name Beschreibung Typ Status
az aks machine add

Fügen Sie dem angegebenen Knotenpool einen Computer hinzu.

 Extension GA
az aks machine list

Abrufen von Informationen zu IP-Adressen, Hostname für alle Computer in einem Agentpool.

 Core GA
az aks machine list (aks-preview Erweiterung)

Listet die Details für alle Computer in einem Agentpool auf.

 Extension GA
az aks machine show

Anzeigen von IP-Adressen, Hostname für einen bestimmten Computer in einem Agentpool für ein verwaltetes Cluster.

 Core GA
az aks machine show (aks-preview Erweiterung)

Zeigen Sie die Details eines bestimmten Computers in einem Agentpool eines verwalteten Clusters an.

 Extension GA
az aks machine update

Aktualisieren Sie den angegebenen Computer in einem Agentpool.

 Extension GA

az aks machine add

Fügen Sie dem angegebenen Knotenpool einen Computer hinzu.

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]

Erforderliche Parameter

--cluster-name

Name des verwalteten Clusters

--nodepool-name

Name des Agentpools eines verwalteten Clusters.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--disable-fips-image

Wechseln Sie auf dem Computer, um nicht FIPS-fähiges Betriebssystem zu verwenden.

Eigenschaft Wert
Standardwert: False
--enable-fips-image

Wechseln Sie zur Verwendung des FIPS-fähigen Betriebssystems auf dem Computer.

Eigenschaft Wert
Standardwert: False
--enable-node-public-ip

Aktivieren Sie die öffentliche IP-Adresse des Computers.

Eigenschaft Wert
Standardwert: False
--kubernetes-version

Version von Kubernetes, die zum Erstellen des Computers verwendet werden soll, z. B. "1.7.12" oder "1.8.7".

--machine-name

Hostname des Geräts.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--node-public-ip-prefix-id

Öffentliche IP-Präfix-ID, die verwendet wird, um dem Computer öffentliche IPs zuzuweisen.

--node-public-ip-tags

Die ipTags des Computers öffentliche IPs.

--os-sku

Die Os-sku des Agentknotenpools.

Eigenschaft Wert
Zulässige Werte: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual
--os-type

Der Betriebssystemtyp des Computers.

--pod-subnet-id

Die ID eines Subnetzes in einem vorhandenen VNet, dem Pods auf dem Computer zugewiesen werden sollen (erfordert azure network-plugin).

--priority

Die Priorität des Computers.

Eigenschaft Wert
Zulässige Werte: Regular, Spot
--tags

Die Tags des Computers.

--vm-size

Die Größe des Computers.

--vnet-subnet-id

Die ID eines Subnetzes in einem vorhandenen VNet, in dem der Computer bereitgestellt werden soll.

--zones -z

Durch Leerzeichen getrennte Liste der Verfügbarkeitszonen, in denen ein Computer platziert wird.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks machine list

Bearbeiten

Abrufen von Informationen zu IP-Adressen, Hostname für alle Computer in einem Agentpool.

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

Beispiele

Abrufen von Informationen zu IP-Adressen, Hostnamen, Verfügbarkeitszonen für alle Computer in einem Agentpool

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

Erforderliche Parameter

--cluster-name

Name des verwalteten Clusters

--nodepool-name

Name des Agentpools eines verwalteten Clusters.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks machine list (aks-preview Erweiterung)

Listet die Details für alle Computer in einem Agentpool auf.

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

Beispiele

Auflisten der Details für alle Computer in einem Agentpool

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

Erforderliche Parameter

--cluster-name

Name des verwalteten Clusters

--nodepool-name

Name des Agentpools eines verwalteten Clusters.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks machine show

Bearbeiten

Anzeigen von IP-Adressen, Hostname für einen bestimmten Computer in einem Agentpool für ein verwaltetes Cluster.

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

Erforderliche Parameter

--cluster-name

Name des verwalteten Clusters

--machine-name

Name des Computers im Agentpool eines verwalteten Clusters.

--nodepool-name

Name des Agentpools eines verwalteten Clusters.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks machine show (aks-preview Erweiterung)

Zeigen Sie die Details eines bestimmten Computers in einem Agentpool eines verwalteten Clusters an.

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

Beispiele

Zeigen Sie die Details eines bestimmten Computers in einem Agentpool eines verwalteten Clusters an.

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

Erforderliche Parameter

--cluster-name

Name des verwalteten Clusters

--machine-name

Name des Computers.

--nodepool-name

Name des Agentpools eines verwalteten Clusters.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az aks machine update

Aktualisieren Sie den angegebenen Computer in einem Agentpool.

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

Erforderliche Parameter

--cluster-name

Name des verwalteten Clusters

--nodepool-name

Name des Agentpools eines verwalteten Clusters.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--labels

Die Etiketten der Maschine.

--machine-name

Hostname des Geräts.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--node-taints

Die Taints der Maschine.

--tags

Die Tags des Computers.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False