Freigeben über


az aks nodepool

Hinweis

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. Weitere Informationen zu Erweiterungen

Befehle zum Verwalten von Knotenpools im Kubernetes-Kubernetes-Cluster.

Befehle

Name Beschreibung Typ Status
az aks nodepool add

Fügen Sie dem verwalteten Kubernetes-Cluster einen Knotenpool hinzu.

Core Allgemein verfügbar
az aks nodepool add (aks-preview Erweiterung)

Fügen Sie dem verwalteten Kubernetes-Cluster einen Knotenpool hinzu.

Erweiterung Allgemein verfügbar
az aks nodepool delete

Löschen Sie den Agentpool im verwalteten Kubernetes-Cluster.

Core Allgemein verfügbar
az aks nodepool delete (aks-preview Erweiterung)

Löschen Sie den Agentpool im verwalteten Kubernetes-Cluster.

Erweiterung Allgemein verfügbar
az aks nodepool delete-machines

Löschen Sie bestimmte Computer in einem Agentpool für einen verwalteten Cluster.

Core Allgemein verfügbar
az aks nodepool delete-machines (aks-preview Erweiterung)

Löschen Sie bestimmte Computer in einem Agentpool für einen verwalteten Cluster.

Erweiterung Allgemein verfügbar
az aks nodepool get-upgrades

Ruft die verfügbaren Upgradeversionen für einen Agentpool des Managed Kubernetes-Clusters ab.

Core Allgemein verfügbar
az aks nodepool get-upgrades (aks-preview Erweiterung)

Ruft die verfügbaren Upgradeversionen für einen Agentpool des Managed Kubernetes-Clusters ab.

Erweiterung Allgemein verfügbar
az aks nodepool list

Listet Knotenpools im Managed Kubernetes-Cluster auf. So rufen Sie eine Liste der Knoten im Befehl "Clusterausführung kubectl get nodes " ab.

Core Allgemein verfügbar
az aks nodepool list (aks-preview Erweiterung)

Listet Knotenpools im Managed Kubernetes-Cluster auf.

Erweiterung Allgemein verfügbar
az aks nodepool manual-scale

Befehle zum Verwalten von nodepool virtualMachineProfile.scale.manual.

Erweiterung Allgemein verfügbar
az aks nodepool manual-scale add

Fügen Sie einem VirtualMachines-Agentpool im verwalteten Kubernetes-Cluster ein neues Handbuch hinzu.

Erweiterung Allgemein verfügbar
az aks nodepool manual-scale delete

Löschen Sie ein vorhandenes Handbuch für einen VirtualMachines-Agentpool im verwalteten Kubernetes-Cluster.

Erweiterung Allgemein verfügbar
az aks nodepool manual-scale update

Aktualisieren Sie ein vorhandenes Handbuch eines VirtualMachines-Agentpools im verwalteten Kubernetes-Cluster.

Erweiterung Allgemein verfügbar
az aks nodepool operation-abort

Abbrechen des letzten Ausgeführten Vorgangs auf nodepool.

Core Allgemein verfügbar
az aks nodepool operation-abort (aks-preview Erweiterung)

Abbrechen des letzten Ausgeführten Vorgangs auf nodepool.

Erweiterung Allgemein verfügbar
az aks nodepool scale

Skaliert den Knotenpool in einem Managed Kubernetes-Cluster.

Core Allgemein verfügbar
az aks nodepool scale (aks-preview Erweiterung)

Skaliert den Knotenpool in einem Managed Kubernetes-Cluster.

Erweiterung Allgemein verfügbar
az aks nodepool show

Zeigt die Details für einen Knotenpool im Managed Kubernetes-Cluster an.

Core Allgemein verfügbar
az aks nodepool show (aks-preview Erweiterung)

Zeigt die Details für einen Knotenpool im Managed Kubernetes-Cluster an.

Erweiterung Allgemein verfügbar
az aks nodepool snapshot

Befehle zum Verwalten von Nodepool-Momentaufnahmen.

Kern und Erweiterung Allgemein verfügbar
az aks nodepool snapshot create

Erstellen Sie eine Nodepool-Momentaufnahme.

Core Allgemein verfügbar
az aks nodepool snapshot create (aks-preview Erweiterung)

Erstellen Sie eine Nodepool-Momentaufnahme.

Erweiterung Allgemein verfügbar
az aks nodepool snapshot delete

Löschen sie eine Nodepool-Momentaufnahme.

Core Allgemein verfügbar
az aks nodepool snapshot delete (aks-preview Erweiterung)

Löschen sie eine Nodepool-Momentaufnahme.

Erweiterung Allgemein verfügbar
az aks nodepool snapshot list

Knotenpoolmomentaufnahmen auflisten.

Core Allgemein verfügbar
az aks nodepool snapshot list (aks-preview Erweiterung)

Knotenpoolmomentaufnahmen auflisten.

Erweiterung Allgemein verfügbar
az aks nodepool snapshot show

Zeigen Sie die Details einer Nodepool-Momentaufnahme an.

Core Allgemein verfügbar
az aks nodepool snapshot show (aks-preview Erweiterung)

Zeigen Sie die Details einer Nodepool-Momentaufnahme an.

Erweiterung Allgemein verfügbar
az aks nodepool snapshot update

Aktualisieren von Tags in einer Momentaufnahme eines Knotenpools.

Core Allgemein verfügbar
az aks nodepool snapshot update (aks-preview Erweiterung)

Aktualisieren von Tags in einer Momentaufnahme eines Knotenpools.

Erweiterung Allgemein verfügbar
az aks nodepool snapshot wait

Warten Sie, bis eine Nodepool-Momentaufnahme einen gewünschten Zustand erreicht.

Core Allgemein verfügbar
az aks nodepool start

Starten Sie den Agentpool im verwalteten Kubernetes-Cluster angehalten.

Core Allgemein verfügbar
az aks nodepool start (aks-preview Erweiterung)

Starten Sie den Agentpool im verwalteten Kubernetes-Cluster angehalten.

Erweiterung Allgemein verfügbar
az aks nodepool stop

Beenden Sie die Ausführung des Agentpools im verwalteten Kubernetes-Cluster.

Core Allgemein verfügbar
az aks nodepool stop (aks-preview Erweiterung)

Beenden Sie die Ausführung des Agentpools im verwalteten Kubernetes-Cluster.

Erweiterung Allgemein verfügbar
az aks nodepool update

Aktualisieren sie die Eigenschaften eines Knotenpools.

Core Allgemein verfügbar
az aks nodepool update (aks-preview Erweiterung)

Aktualisieren sie die Eigenschaften eines Knotenpools.

Erweiterung Allgemein verfügbar
az aks nodepool upgrade

Führt ein Upgrade für den Knotenpool in einem Managed Kubernetes-Cluster durch.

Core Allgemein verfügbar
az aks nodepool upgrade (aks-preview Erweiterung)

Führt ein Upgrade für den Knotenpool in einem Managed Kubernetes-Cluster durch.

Erweiterung Allgemein verfügbar
az aks nodepool wait

Warten Sie, bis ein Knotenpool einen gewünschten Zustand erreicht.

Core Allgemein verfügbar

az aks nodepool add

Fügen Sie dem verwalteten Kubernetes-Cluster einen Knotenpool hinzu.

az aks nodepool add --cluster-name
                    --name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--min-count]
                    [--mode {System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--vnet-subnet-id]
                    [--zones]

Beispiele

Erstellen Sie einen Knotenpool in einem vorhandenen AKS-Cluster mit aktiviertem kurzlebigen Betriebssystem.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Erstellen Sie einen Knotenpool mit aktivierter EncryptionAtHost-Funktion.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Erstellen Sie einen Knotenpool mit aktiviertem UltraSSD.Create a nodepool with UltraSSD enabled.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-ultra-ssd

Erstellen eines Knotenpoolclusters mit einer bestimmten Betriebssystem-SKU

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu

Erstellen eines Knotenpools mit FIPS-fähigen Betriebssystemen

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image

erstellen Sie einen Kubernetes-Cluster mit einer Momentaufnahme-ID.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

Erstellen eines Knotenpools in einem vorhandenen AKS-Cluster mit Hostgruppen-ID

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

erstellen Sie einen Knotenpool mit einer Capacity Reservation Group(CRG)-ID.

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Durch Trennzeichen getrennte Schlüssel-Wert-Paare, um benutzerdefinierte Header anzugeben.

--allowed-host-ports

Verfügbarmachen von Hostports im Knotenpool. Wenn angegeben, sollte das Format eine durch Leerzeichen getrennte Liste von Bereichen mit Protokoll sein, z. B. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

Die IDs der Anwendungssicherheitsgruppen, zu denen die Netzwerkschnittstelle des Knotenpools gehören soll. Bei Angabe sollte das Format eine durch Leerzeichen getrennte Liste von IDs sein.

--crg-id

Die crg-ID, die zum Zuordnen des neuen Knotenpools zur vorhandenen Kapazitätsreservierungsgruppenressource verwendet wird.

--disable-windows-outbound-nat

Deaktivieren Sie Windows OutboundNAT im Windows-Agent-Knotenpool.

Standardwert: False
--drain-timeout

Wenn Knoten abwässern, wie viele Minuten warten, bis alle Pods entfernt werden.

--enable-cluster-autoscaler -e

Aktivieren Sie die Clusterautoskaler.

Standardwert: False
--enable-encryption-at-host

Enable EncryptionAtHost, standardwert is false.

Standardwert: False
--enable-fips-image

Verwenden Sie FIPS-fähiges Betriebssystem auf Agentknoten.

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

Aktivieren Sie die öffentliche IP des VMSS-Knotens.

Standardwert: False
--enable-secure-boot

Aktivieren sie den sicheren Start im Agentknotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--enable-ultra-ssd

UltraSSD aktivieren, Standardwert ist "false".

Standardwert: False
--enable-vtpm

Aktivieren Sie vTPM im Agentknotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--eviction-policy

Die Eviction-Richtlinie des Spotknotenpools. Sie kann nur festgelegt werden, wenn "-priority" spot ist.

Zulässige Werte: Deallocate, Delete
Standardwert: Delete
--gpu-instance-profile

GPU-Instanzprofil zur Partitionierung multi-gpu Nvidia GPUs.

Zulässige Werte: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

Die vollqualifizierte dedizierte Hostgruppen-ID, die zum Bereitstellen des Agentknotenpools verwendet wird.

--kubelet-config

Pfad zur JSON-Datei, die Kubelet-Konfigurationen für Agentknoten enthält. https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

Version von Kubernetes zum Erstellen des Clusters, z. B. "1.16.9".

Wert aus: `az aks get-versions`
--labels

Die Knotenbeschriftungen für den Knotenpool. Eine Syntax von Bezeichnungen finden Sie https://aka.ms/node-labels unter

--linux-os-config

Pfad zur JSON-Datei, die Betriebssystemkonfigurationen für Linux-Agentknoten enthält. https://aka.ms/aks/custom-node-config.

--max-count

Maximale Anzahl von Knoten, die für autoscaler verwendet werden, wenn "--enable-cluster-autoscaler" angegeben ist. Geben Sie den Wert im Bereich von [0, 1000] für den Benutzerknotenpool und [1.1000] für den Systemknotenpool an.

--max-pods -m

Maximale Anzahl von Pods, die auf einem Knoten bereitgestellt werden können

Wenn nicht angegeben, werden Die Standardwerte basierend auf dem Netzwerk-Plug-In. 30 für "azure", 110 für "kubenet" oder 250 für "none".

--max-surge

Zusätzliche Knoten, die zum Beschleunigen des Upgrades verwendet werden. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 5 oder 33 %.

--min-count

Mindestanzahl von Knoten, die für autoscaler verwendet werden, wenn "--enable-cluster-autoscaler" angegeben ist. Geben Sie den Wert im Bereich von [0, 1000] für den Benutzerknotenpool und [1.1000] für den Systemknotenpool an.

--mode

Der Modus für einen Knotenpool, der die primäre Funktion eines Knotenpools definiert. Wenn sie als "System" festgelegt ist, bevorzugt AKS die Planung von System pods für Knotenpools mit Modus System. Weitere Informationen finden Sie unter https://aka.ms/aks/nodepool/mode.

Zulässige Werte: System, User
Standardwert: User
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-count -c

Anzahl der Knoten im Kubernetes-Agentpool. Nach dem Erstellen eines Clusters können Sie die Größe des Knotenpools mit az aks scale.

Standardwert: 3
--node-osdisk-size

Größe in GiB des Betriebssystemdatenträgers für jeden Knoten im Agentpool. Mindestens 30 GiB.

--node-osdisk-type

Betriebssystemdatenträgertyp, der für Computer in einem bestimmten Agentpool verwendet werden soll. Standardmäßig wird nach Möglichkeit "Ephemeral" in Verbindung mit vm-Größe und Betriebssystemdatenträgergröße verwendet. Möglicherweise wird dieser Pool nach der Erstellung nicht mehr geändert. ('Ephemeral' oder 'Managed').

Zulässige Werte: Ephemeral, Managed
--node-public-ip-prefix-id

Öffentliche IP-Präfix-ID, die zum Zuweisen öffentlicher IPs zu VMSS-Knoten verwendet wird.

--node-public-ip-tags

Die ipTags der öffentlichen Knoten-IPs.

--node-soak-duration

Die Zeit (in Minuten), die nach dem Entwässern eines Knotens und vor dem Neustellen des Knotens und dem Wechsel zum nächsten Knoten gewartet werden soll.

--node-taints

Die Knotentaints für den Knotenpool.

--node-vm-size -s

Größe virtueller Computer, die als Kubernetes-Knoten erstellt werden sollen.

--os-sku

Die Betriebssystem-SKU des Agentknotenpools. Ubuntu oder CBLMarin für Linux. Windows2019 oder Windows2022 für Windows.

Zulässige Werte: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022
--os-type

Der Betriebssystemtyp. Linux oder Windows.

--pod-subnet-id

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

--ppg

Die ID einer PPG.

--priority

Die Priorität des Knotenpools.

Zulässige Werte: Regular, Spot
Standardwert: Regular
--scale-down-mode

Beschreiben, wie virtuelle Computer zu Knotenpools hinzugefügt oder daraus entfernt werden.

Zulässige Werte: Deallocate, Delete
Standardwert: Delete
--snapshot-id

Die Quellmomentaufnahme-ID, die zum Erstellen dieses Knotenpools verwendet wird.

--spot-max-price

Sie kann nur festgelegt werden, wenn "-priority" spot ist. Geben Sie den Höchstpreis an, den Sie in US-Dollar bezahlen möchten. Mögliche Werte sind ein beliebiger Dezimalwert größer als Null oder -1, der angibt, dass der Standardpreis bei Bedarf hoch ist. Sie kann nur bis zu 5 Dezimalstellen enthalten.

Standardwert: nan
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--vnet-subnet-id

Die Ressourcen-ID eines Subnetzes in einem vorhandenen VNet, in dem der Cluster bereitgestellt werden soll.

--zones -z

Verfügbarkeitszonen, in denen Agentknoten platziert werden. Um Agentknoten auch in mehr als einer Zone zu installieren, müssen Sie Zonennummern übergeben, die durch Leerzeichen getrennt sind. For example - To have all 3 zones, you are expected to enter --zones 1 2 3.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool add (aks-preview Erweiterung)

Fügen Sie dem verwalteten Kubernetes-Cluster einen Knotenpool hinzu.

az aks nodepool add --cluster-name
                    --name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--driver-type {CUDA, GRID}]
                    [--enable-artifact-streaming]
                    [--enable-cluster-autoscaler]
                    [--enable-custom-ca-trust]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gateway-prefix-size]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, WindowsAnnual}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--skip-gpu-driver-install]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, localuser}]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi}]
                    [--zones]

Beispiele

Erstellen Sie einen Knotenpool in einem vorhandenen AKS-Cluster mit aktiviertem kurzlebigen Betriebssystem.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Erstellen Sie einen Knotenpool mit aktivierter EncryptionAtHost-Funktion.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Erstellen eines Knotenpools mit einer bestimmten os-sku

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu

Erstellen Sie einen Knotenpool, der wasm-Workloads ausführen kann.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --workload-runtime WasmWasi

erstellen Sie einen Kubernetes-Cluster mit einer Momentaufnahme-ID.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

erstellen Sie einen Knotenpool mit einer Capacity Reservation Group(CRG)-ID.

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

Erstellen eines Knotenpools in einem vorhandenen AKS-Cluster mit Hostgruppen-ID

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

Erstellen eines Knotenpools mit ip-Zuordnungsmodus auf "StaticBlock" und Verwenden einer Pod-Subnetz-ID

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu --pod-subnet-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock

Erstellen eines Knotenpools vom Typ "VirtualMachines"

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --vm-set-type VirtualMachines --vm-sizes "Standard_D4s_v3,Standard_D8s_v3" --node-count 3

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--allowed-host-ports
Vorschau

Verfügbarmachen von Hostports im Knotenpool. Wenn angegeben, sollte das Format eine durch Trennzeichen getrennte Liste von Bereichen mit Protokoll sein, z. B. 80/TCP,443/TCP,4000-5000/TCP. Muss den VMSS-Agentpooltyp verwenden.

--asg-ids
Vorschau

Die IDs der Anwendungssicherheitsgruppen, zu denen die Netzwerkschnittstelle des Knotenpools gehören soll. Wenn angegeben, sollte das Format eine durch Trennzeichen getrennte Liste von IDs sein. Muss den VMSS-Agentpooltyp verwenden.

--crg-id
Vorschau

Die crg-ID, die zum Zuordnen des neuen Knotenpools zur vorhandenen Kapazitätsreservierungsgruppenressource verwendet wird. Muss den VMSS-Agentpooltyp verwenden.

--disable-windows-outbound-nat

Deaktivieren Sie Windows OutboundNAT im Windows-Agent-Knotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--drain-timeout

Wenn Knoten abwässern, wie viele Minuten warten, bis alle Pods entfernt werden.

--driver-type
Vorschau

Geben Sie den Typ des GPU-Treibers an, der beim Erstellen von Windows-Agentpools installiert werden soll. Gültige Werte sind "GRID" und "CUDA". Wenn nicht angegeben, wählt AKS den Treiber basierend auf der Systemkompatibilität aus. Diese Option kann nicht geändert werden, nachdem der AgentPool erstellt wurde. Der Standardwert ist vom System ausgewählt.

Zulässige Werte: CUDA, GRID
--enable-artifact-streaming
Vorschau

Aktivieren Sie das Artefaktstreaming für VirtualMachineScaleSets, die von einem Knotenpool verwaltet werden, um den Kaltstart von Containern auf einem Knoten über das Laden von On-Demand-Images zu beschleunigen. Um dieses Feature zu verwenden, müssen Containerimages auch das Artefaktstreaming auf ACR aktivieren. Wenn nicht angegeben, ist der Standardwert "false".

Standardwert: False
--enable-cluster-autoscaler -e

Aktivieren Sie die Clusterautoskaler. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--enable-custom-ca-trust

Aktivieren Sie benutzerdefinierte Zertifizierungsstellenvertrauensstellung im Agentknotenpool.

Standardwert: False
--enable-encryption-at-host

Aktivieren Sie EncryptionAtHost im Agentknotenpool.

Standardwert: False
--enable-fips-image

Verwenden Sie FIPS-fähiges Betriebssystem auf Agentknoten.

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

Aktivieren Sie die öffentliche IP des VMSS-Knotens. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--enable-secure-boot
Vorschau

Aktivieren sie den sicheren Start im Agentknotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--enable-ultra-ssd

Aktivieren Sie UltraSSD im Agentknotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--enable-vtpm
Vorschau

Aktivieren Sie vTPM im Agentknotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--eviction-policy

Die Eviction-Richtlinie des Spotknotenpools. Sie kann nur festgelegt werden, wenn "-priority" spot ist.

Zulässige Werte: Deallocate, Delete
Standardwert: Delete
--gateway-prefix-size
Vorschau

Die Größe von public IPPrefix, die an den Knotenpool für den Gatewaymodus angefügt ist. Der Knotenpool muss sich im Gatewaymodus befinden.

--gpu-instance-profile

GPU-Instanzprofil zur Partitionierung multi-gpu Nvidia GPUs.

Zulässige Werte: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

(VORSCHAU) Die vollqualifizierte dedizierte Hostgruppen-ID, die zum Bereitstellen des Agentknotenpools verwendet wird. Muss den VMSS-Agentpooltyp verwenden.

--if-match

Der angegebene Wert wird mit dem ETag des Agentpools verglichen, wenn er mit dem Vorgang übereinstimmt, wird fortgesetzt. Wenn sie nicht übereinstimmen, wird die Anforderung abgelehnt, um versehentliche Überschreibungen zu verhindern. Dies darf beim Erstellen eines neuen Agentpools nicht angegeben werden.

--if-none-match

Legen Sie auf '*' fest, damit ein neuer Agentpool erstellt werden kann, aber um zu verhindern, dass ein vorhandenes Agentpool aktualisiert wird. Andere Werte werden ignoriert.

--kubelet-config

Kubelet-Konfigurationen für Agentknoten.

--kubernetes-version -k

Version von Kubernetes zum Erstellen des Clusters, z. B. "1.7.12" oder "1.8.7".

Wert aus: `az aks get-versions`
--labels

Die Knotenbeschriftungen für den Knotenpool. Eine Syntax von Bezeichnungen finden Sie https://aka.ms/node-labels unter

--linux-os-config

Betriebssystemkonfigurationen für Linux-Agentknoten.

--max-count

Maximale Anzahl von Knoten, die für autoscaler verwendet werden, wenn "--enable-cluster-autoscaler" angegeben ist. Geben Sie den Wert im Bereich von [0, 1000] für den Benutzerknotenpool und [1.1000] für den Systemknotenpool an.

--max-pods -m

Maximale Anzahl von Pods, die auf einem Knoten bereitgestellt werden können

Wenn nicht angegeben, werden Die Standardwerte basierend auf dem Netzwerk-Plug-In. 30 für "azure", 110 für "kubenet" oder 250 für "none".

Standardwert: 0
--max-surge

Zusätzliche Knoten, die zum Beschleunigen des Upgrades verwendet werden. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 5 oder 33 %.

--message-of-the-day

Pfad zu einer Datei, die die gewünschte Nachricht des Tages enthält. Nur gültig für Linux-Knoten. Wird in /etc/motd geschrieben.

--min-count

Minimun-Knotenanzahl, die für autoscaler verwendet wird, wenn "--enable-cluster-autoscaler" angegeben ist. Geben Sie den Wert im Bereich von [0, 1000] für den Benutzerknotenpool und [1.1000] für den Systemknotenpool an.

--mode

Der Modus für einen Knotenpool, der die primäre Funktion eines Knotenpools definiert. Wenn sie als "System" festgelegt ist, bevorzugt AKS die Planung von System pods für Knotenpools mit Modus System. Weitere Informationen finden Sie unter https://aka.ms/aks/nodepool/mode.

Zulässige Werte: Gateway, System, User
Standardwert: User
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-count -c

Anzahl der Knoten im Kubernetes-Agentpool. Nach dem Erstellen eines Clusters können Sie die Größe des Knotenpools mit az aks scale.

Standardwert: 3
--node-osdisk-size

Größe in GiB des Betriebssystemdatenträgers für jeden Knoten im Agentpool. Mindestens 30 GiB.

Standardwert: 0
--node-osdisk-type

Betriebssystemdatenträgertyp, der für Computer in einem bestimmten Agentpool verwendet werden soll. Standardmäßig wird nach Möglichkeit "Ephemeral" in Verbindung mit vm-Größe und Betriebssystemdatenträgergröße verwendet. Möglicherweise wird dieser Pool nach der Erstellung nicht mehr geändert. ('Ephemeral' oder 'Managed').

Zulässige Werte: Ephemeral, Managed
--node-public-ip-prefix-id

Öffentliche IP-Präfix-ID, die zum Zuweisen öffentlicher IPs zu VMSS-Knoten verwendet wird. Muss den VMSS-Agentpooltyp verwenden.

--node-public-ip-tags

Die ipTags der öffentlichen Knoten-IPs. Muss den VMSS-Agentpooltyp verwenden.

--node-soak-duration

Die Zeit (in Minuten), die nach dem Entwässern eines Knotens und vor dem Neustellen des Knotens und dem Wechsel zum nächsten Knoten gewartet werden soll.

--node-taints

Die Knotentaints für den Knotenpool.

--node-vm-size -s

Größe virtueller Computer, die als Kubernetes-Knoten erstellt werden sollen.

--os-sku

Die Os-sku des Agentknotenpools. Ubuntu oder CBLMarin, wenn der Betriebssystemtyp Linux ist, ist der Standardwert Ubuntu, wenn nicht festgelegt; Windows2019, Windows2022 oder WindowsAnnual, wenn der Betriebssystemtyp Windows ist, ist der aktuelle Standardwert Windows2022, wenn nicht festgelegt.

Zulässige Werte: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, WindowsAnnual
--os-type

Der Betriebssystemtyp. Linux oder Windows. Windows wird für den VM-Satztyp "VirtualMachines" noch nicht unterstützt.

--pod-ip-allocation-mode

Legen Sie den IP-Zuordnungsmodus fest, um festzulegen, wie Pod-IPs aus dem Azure Pod-Subnetz den Knoten im AKS-Cluster zugewiesen werden. Die Wahl liegt zwischen dynamischen Batches einzelner IPs oder statischer Zuordnung einer Reihe von CIDR-Blöcken. Akzeptierte Werte sind "DynamicIndividual" oder "StaticBlock".

Wird zusammen mit dem "azure"-Netzwerk-Plug-In verwendet. Erfordert --pod-subnet-id.

Zulässige Werte: DynamicIndividual, StaticBlock
--pod-subnet-id

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

--ppg

Die ID einer PPG. Muss den VMSS-Agentpooltyp verwenden.

--priority

Die Priorität des Knotenpools.

Zulässige Werte: Regular, Spot
Standardwert: Regular
--scale-down-mode

Beschreibt, wie VMs zu Knotenpools hinzugefügt oder daraus entfernt werden.

Zulässige Werte: Deallocate, Delete
Standardwert: Delete
--skip-gpu-driver-install
Vorschau

Um die automatische Installation des GPU-Treibers von AKS in einem Knotenpool mithilfe der GPU-VM-Größe zu überspringen, wenn Kunden die GPU-Treiberinstallation selbst verwalten möchten. Wenn nicht angegeben, ist der Standardwert "false".

Standardwert: False
--snapshot-id

Die Quellmomentaufnahme-ID, die zum Erstellen dieses Knotenpools verwendet wird. Muss den VMSS-Agentpooltyp verwenden.

--spot-max-price

Sie kann nur festgelegt werden, wenn "-priority" spot ist. Geben Sie den Höchstpreis an, den Sie in US-Dollar bezahlen möchten. Mögliche Werte sind ein beliebiger Dezimalwert größer als Null oder -1, der angibt, dass der Standardpreis bei Bedarf hoch ist. Sie kann nur bis zu 5 Dezimalstellen enthalten.

Standardwert: nan
--ssh-access
Vorschau

Konfigurieren Sie die SSH-Einstellung für den Knotenpool. Verwenden Sie "disabled", um den SSH-Zugriff zu deaktivieren, "localuser", um den SSH-Zugriff mit privatem Schlüssel zu aktivieren.

Zulässige Werte: disabled, localuser
Standardwert: localuser
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--undrainable-node-behavior

Definieren Sie das Verhalten für unrainierbare Knoten während des Upgrades. Der Wert sollte "Cordon" oder "Schedule" sein. Der Standardwert ist "Schedule".

--vm-set-type

Vm-Satztyp des Agentpools. VirtualMachineScaleSets, AvailabilitySet oder VirtualMachines(Preview).

--vm-sizes
Vorschau

Durch Trennzeichen getrennte Liste der Größen. Der Agentpooltyp "VirtualMachines" muss verwendet werden.

--vnet-subnet-id

Die ID eines Subnetzes in einem vorhandenen VNET, in dem der Cluster bereitgestellt werden soll

--workload-runtime

Bestimmt den Typ der Workload, die ein Knoten ausführen kann. Standardmäßig wird OCIContainer verwendet.

Zulässige Werte: KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi
Standardwert: OCIContainer
--zones -z

Durch Leerzeichen getrennte Liste der Verfügbarkeitszonen, in denen Agentknoten platziert werden. Muss den VMSS-Agentpooltyp verwenden.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool delete

Löschen Sie den Agentpool im verwalteten Kubernetes-Cluster.

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

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool delete (aks-preview Erweiterung)

Löschen Sie den Agentpool im verwalteten Kubernetes-Cluster.

az aks nodepool delete --cluster-name
                       --name
                       --resource-group
                       [--if-match]
                       [--ignore-pod-disruption-budget]
                       [--no-wait]

Beispiele

Löschen eines Agentpools mit ignore-pod-disruption-budget

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --ignore-pod-disruption-budget=true

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--if-match

Der angegebene Wert wird mit dem ETag des Knotenpools verglichen, wenn er mit dem Vorgang übereinstimmt, wird fortgesetzt. Wenn sie nicht übereinstimmen, wird die Anforderung abgelehnt, um versehentliche Überschreibungen zu verhindern. Dies darf beim Erstellen eines neuen Agentpools nicht angegeben werden.

--ignore-pod-disruption-budget -i
Vorschau

(VORSCHAU) Das Budget "ignore-pod-disruption"-Budget löscht einen vorhandenen Knotenpool, ohne das Pod Disruption Budget in Betracht zu ziehen.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool delete-machines

Löschen Sie bestimmte Computer in einem Agentpool für einen verwalteten Cluster.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name
                                --resource-group
                                [--no-wait]

Beispiele

Löschen bestimmter Computer in einem Agentpool

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--machine-names

Durch Leerzeichen getrennte Liste der Computernamen aus dem Agentpool, die gelöscht werden sollen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool delete-machines (aks-preview Erweiterung)

Löschen Sie bestimmte Computer in einem Agentpool für einen verwalteten Cluster.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name
                                --resource-group
                                [--no-wait]

Beispiele

Löschen bestimmter Computer in einem Agentpool

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--machine-names

Durch Leerzeichen getrennte Liste der Computernamen aus dem Agentpool, die gelöscht werden sollen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool get-upgrades

Ruft die verfügbaren Upgradeversionen für einen Agentpool des Managed Kubernetes-Clusters ab.

az aks nodepool get-upgrades --cluster-name
                             --name
                             --resource-group

Beispiele

Ruft die verfügbaren Upgradeversionen für einen Agentpool des Managed Kubernetes-Clusters ab.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool get-upgrades (aks-preview Erweiterung)

Ruft die verfügbaren Upgradeversionen für einen Agentpool des Managed Kubernetes-Clusters ab.

az aks nodepool get-upgrades --cluster-name
                             --name
                             --resource-group

Beispiele

Ruft die verfügbaren Upgradeversionen für einen Agentpool des Managed Kubernetes-Clusters ab.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool list

Listet Knotenpools im Managed Kubernetes-Cluster auf. So rufen Sie eine Liste der Knoten im Befehl "Clusterausführung kubectl get nodes " ab.

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

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool list (aks-preview Erweiterung)

Listet Knotenpools im Managed Kubernetes-Cluster auf.

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

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool operation-abort

Abbrechen des letzten Ausgeführten Vorgangs auf nodepool.

az aks nodepool operation-abort --cluster-name
                                --name
                                --resource-group
                                [--no-wait]

Beispiele

Abbruchvorgang im Agentpool

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool operation-abort (aks-preview Erweiterung)

Abbrechen des letzten Ausgeführten Vorgangs auf nodepool.

az aks nodepool operation-abort --cluster-name
                                --name
                                --resource-group
                                [--aks-custom-headers]
                                [--no-wait]

Beispiele

Abbruchvorgang im Agentpool

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool scale

Skaliert den Knotenpool in einem Managed Kubernetes-Cluster.

az aks nodepool scale --cluster-name
                      --name
                      --resource-group
                      [--no-wait]
                      [--node-count]

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-count -c

Anzahl der Knoten im Kubernetes-Knotenpool.

Standardwert: 3
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool scale (aks-preview Erweiterung)

Skaliert den Knotenpool in einem Managed Kubernetes-Cluster.

az aks nodepool scale --cluster-name
                      --name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]
                      [--node-count]

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-count -c

Anzahl der Knoten im Kubernetes-Knotenpool.

Standardwert: 3
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool show

Zeigt die Details für einen Knotenpool im Managed Kubernetes-Cluster an.

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

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool show (aks-preview Erweiterung)

Zeigt die Details für einen Knotenpool im Managed Kubernetes-Cluster an.

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

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool start

Starten Sie den Agentpool im verwalteten Kubernetes-Cluster angehalten.

az aks nodepool start --cluster-name
                      --name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

Beispiele

Starten des Agentpools im verwalteten Cluster

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool start (aks-preview Erweiterung)

Starten Sie den Agentpool im verwalteten Kubernetes-Cluster angehalten.

az aks nodepool start --cluster-name
                      --name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

Beispiele

Starten des Agentpools im verwalteten Cluster

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool stop

Beenden Sie die Ausführung des Agentpools im verwalteten Kubernetes-Cluster.

az aks nodepool stop --cluster-name
                     --name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

Beispiele

Beenden des Agentpools im verwalteten Cluster

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool stop (aks-preview Erweiterung)

Beenden Sie die Ausführung des Agentpools im verwalteten Kubernetes-Cluster.

az aks nodepool stop --cluster-name
                     --name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

Beispiele

Beenden des Agentpools im verwalteten Cluster

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool update

Aktualisieren sie die Eigenschaften eines Knotenpools.

Aktualisieren Sie einen Knotenpool, um cluster-autoscaler zu aktivieren/zu deaktivieren oder min-count oder max.count zu ändern. Wird ohne optionale Argumente aufgerufen, wird versucht, den Knotenpool in den Zielzustand zu verschieben, ohne die aktuelle Konfiguration des Knotenpools zu ändern. Dies kann verwendet werden, um aus einem nicht erfolgreichen Zustand zu wechseln.

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-cluster-autoscaler]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, CBLMariner, Mariner}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--update-cluster-autoscaler]

Beispiele

Versöhnen Sie den Knotenpool wieder mit dem aktuellen Zustand.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Aktivieren der Cluster-Autoskaler innerhalb des Knotenanzahlsbereichs [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Deaktivieren der Cluster-Autoscaler für einen vorhandenen Cluster

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Aktualisieren Sie die Minenanzahl oder die maximale Anzahl für die Cluster-Autoskaler.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Durch Trennzeichen getrennte Schlüssel-Wert-Paare, um benutzerdefinierte Header anzugeben.

--allowed-host-ports

Verfügbarmachen von Hostports im Knotenpool. Wenn angegeben, sollte das Format eine durch Leerzeichen getrennte Liste von Bereichen mit Protokoll sein, z. B. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

Die IDs der Anwendungssicherheitsgruppen, zu denen die Netzwerkschnittstelle des Knotenpools gehören soll. Bei Angabe sollte das Format eine durch Leerzeichen getrennte Liste von IDs sein.

--disable-cluster-autoscaler -d

Deaktivieren Sie die Clusterautoskaler.

Standardwert: False
--disable-fips-image

Wechseln Sie zu nicht FIPS-aktivierten Betriebssystemen auf Agentknoten.

Standardwert: False
--disable-secure-boot

Deaktivieren Sie den sicheren Start auf einem vorhandenen vertrauenswürdigen Start-Agent-Knotenpool.

Standardwert: False
--disable-vtpm

Deaktivieren Sie vTPM für einen vorhandenen vertrauenswürdigen Start-Agent-Knotenpool.

Standardwert: False
--drain-timeout

Wenn Knoten abwässern, wie viele Minuten warten, bis alle Pods entfernt werden.

--enable-cluster-autoscaler -e

Aktivieren Sie die Clusterautoskaler.

Standardwert: False
--enable-fips-image

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

Standardwert: False
--enable-secure-boot

Aktivieren des sicheren Starts in einem vorhandenen vertrauenswürdigen Start-Agent-Knotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--enable-vtpm

Aktivieren Sie vTPM für einen vorhandenen vertrauenswürdigen Start-Agent-Knotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--labels

Die Knotenbeschriftungen für den Knotenpool. Eine Syntax von Bezeichnungen finden Sie https://aka.ms/node-labels unter

--max-count

Maximale Anzahl von Knoten, die für autoscaler verwendet werden, wenn "--enable-cluster-autoscaler" angegeben ist. Geben Sie den Wert im Bereich von [0, 1000] für den Benutzerknotenpool und [1.1000] für den Systemknotenpool an.

--max-surge

Zusätzliche Knoten, die zum Beschleunigen des Upgrades verwendet werden. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 5 oder 33 %.

--min-count

Mindestanzahl von Knoten, die für autoscaler verwendet werden, wenn "--enable-cluster-autoscaler" angegeben ist. Geben Sie den Wert im Bereich von [0, 1000] für den Benutzerknotenpool und [1.1000] für den Systemknotenpool an.

--mode

Der Modus für einen Knotenpool, der die primäre Funktion eines Knotenpools definiert. Wenn sie als "System" festgelegt ist, bevorzugt AKS die Planung von System pods für Knotenpools mit Modus System. Weitere Informationen finden Sie unter https://aka.ms/aks/nodepool/mode.

Zulässige Werte: System, User
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-soak-duration

Die Zeit (in Minuten), die nach dem Entwässern eines Knotens und vor dem Neustellen des Knotens und dem Wechsel zum nächsten Knoten gewartet werden soll.

--node-taints

Die Knotentaints für den Knotenpool. Sie können den vorhandenen Knoten taint eines Knotenpools aktualisieren oder einen neuen Knoten taint für einen Knotenpool erstellen. Übergeben Sie die leere Zeichenfolge "" , um alleTaints zu entfernen.

--os-sku

Die Os-sku des Agentknotenpools.

Zulässige Werte: AzureLinux, CBLMariner, Mariner
--scale-down-mode

Beschreiben, wie virtuelle Computer zu Knotenpools hinzugefügt oder daraus entfernt werden.

Zulässige Werte: Deallocate, Delete
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--update-cluster-autoscaler -u

Aktualisieren Sie die Minenanzahl oder die maximale Anzahl für die Cluster-Autoskaler.

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool update (aks-preview Erweiterung)

Aktualisieren sie die Eigenschaften eines Knotenpools.

Aktualisieren Sie einen Knotenpool, um cluster-autoscaler zu aktivieren/zu deaktivieren oder min-count oder max.count zu ändern. Wird ohne optionale Argumente aufgerufen, wird versucht, den Knotenpool in den Zielzustand zu verschieben, ohne die aktuelle Konfiguration des Knotenpools zu ändern. Dies kann verwendet werden, um aus einem nicht erfolgreichen Zustand zu wechseln.

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--dcat]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-custom-ca-trust]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {Gateway, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, Ubuntu}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, localuser}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]
                       [--yes]

Beispiele

Versöhnen Sie den Knotenpool wieder mit dem aktuellen Zustand.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Aktivieren der Cluster-Autoskaler innerhalb des Knotenanzahlsbereichs [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Deaktivieren der Cluster-Autoscaler für einen vorhandenen Cluster

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Aktualisieren Sie die Minenanzahl oder die maximale Anzahl für die Cluster-Autoskaler.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Ändern eines Knotenpools in den Systemmodus

az aks nodepool update --mode System -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--allowed-host-ports
Vorschau

Verfügbarmachen von Hostports im Knotenpool. Wenn angegeben, sollte das Format eine durch Trennzeichen getrennte Liste von Bereichen mit Protokoll sein, z. B. 80/TCP,443/TCP,4000-5000/TCP. Muss den VMSS-Agentpooltyp verwenden.

--asg-ids
Vorschau

Die IDs der Anwendungssicherheitsgruppen, zu denen die Netzwerkschnittstelle des Knotenpools gehören soll. Wenn angegeben, sollte das Format eine durch Trennzeichen getrennte Liste von IDs sein. Muss den VMSS-Agentpooltyp verwenden.

--dcat --disable-custom-ca-trust

Deaktivieren Sie die benutzerdefinierte Zertifizierungsstellenvertrauensstellung im Agentknotenpool.

Standardwert: False
--disable-cluster-autoscaler -d

Deaktivieren Sie die Clusterautoskaler.

Standardwert: False
--disable-fips-image

Wechseln Sie zu nicht FIPS-aktivierten Betriebssystemen auf Agentknoten.

Standardwert: False
--disable-secure-boot
Vorschau

Deaktivieren Sie den sicheren Start auf einem vorhandenen vertrauenswürdigen Start-Agent-Knotenpool.

Standardwert: False
--disable-vtpm
Vorschau

Deaktivieren Sie vTPM für einen vorhandenen vertrauenswürdigen Start-Agent-Knotenpool.

Standardwert: False
--drain-timeout

Wenn Knoten abwässern, wie viele Minuten warten, bis alle Pods entfernt werden.

--enable-artifact-streaming
Vorschau

Aktivieren Sie das Artefaktstreaming für VirtualMachineScaleSets, die von einem Knotenpool verwaltet werden, um den Kaltstart von Containern auf einem Knoten über das Laden von On-Demand-Images zu beschleunigen. Um dieses Feature zu verwenden, müssen Containerimages auch das Artefaktstreaming auf ACR aktivieren. Wenn nicht angegeben, ist der Standardwert "false".

Standardwert: False
--enable-cluster-autoscaler -e

Aktivieren Sie die Clusterautoskaler. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--enable-custom-ca-trust

Aktivieren Sie benutzerdefinierte Zertifizierungsstellenvertrauensstellung im Agentknotenpool.

Standardwert: False
--enable-fips-image

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

Standardwert: False
--enable-secure-boot
Vorschau

Aktivieren des sicheren Starts in einem vorhandenen vertrauenswürdigen Start-Agent-Knotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--enable-vtpm
Vorschau

Aktivieren Sie vTPM für einen vorhandenen vertrauenswürdigen Start-Agent-Knotenpool. Muss den VMSS-Agentpooltyp verwenden.

Standardwert: False
--if-match

Der angegebene Wert wird mit dem ETag des Knotenpools verglichen, wenn er mit dem Vorgang übereinstimmt, wird fortgesetzt. Wenn sie nicht übereinstimmen, wird die Anforderung abgelehnt, um versehentliche Überschreibungen zu verhindern. Dies darf beim Erstellen eines neuen Agentpools nicht angegeben werden.

--if-none-match

Legen Sie auf '*' fest, damit ein neuer Knotenpool erstellt werden kann, aber um zu verhindern, dass ein vorhandener Knotenpool aktualisiert wird. Andere Werte werden ignoriert.

--labels

Die Knotenbeschriftungen für den Knotenpool. Eine Syntax von Bezeichnungen finden Sie https://aka.ms/node-labels unter

--max-count

Maximale Anzahl von Knoten, die für autoscaler verwendet werden, wenn "--enable-cluster-autoscaler" angegeben ist. Geben Sie den Wert im Bereich von [0, 1000] für den Benutzerknotenpool und [1.1000] für den Systemknotenpool an.

--max-surge

Zusätzliche Knoten, die zum Beschleunigen des Upgrades verwendet werden. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 5 oder 33 %.

--min-count

Minimun-Knotenanzahl, die für autoscaler verwendet wird, wenn "--enable-cluster-autoscaler" angegeben ist. Geben Sie den Wert im Bereich von [0, 1000] für den Benutzerknotenpool und [1.1000] für den Systemknotenpool an.

--mode

Der Modus für einen Knotenpool, der die primäre Funktion eines Knotenpools definiert. Wenn sie als "System" festgelegt ist, bevorzugt AKS die Planung von System pods für Knotenpools mit Modus System. Weitere Informationen finden Sie unter https://aka.ms/aks/nodepool/mode.

Zulässige Werte: Gateway, System, User
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-soak-duration

Die Zeit (in Minuten), die nach dem Entwässern eines Knotens und vor dem Neustellen des Knotens und dem Wechsel zum nächsten Knoten gewartet werden soll.

--node-taints

Die Knotentaints für den Knotenpool.

--os-sku

Die Os-sku des Agentknotenpools.

Zulässige Werte: AzureLinux, Ubuntu
--scale-down-mode

Beschreibt, wie VMs zu Knotenpools hinzugefügt oder daraus entfernt werden.

Zulässige Werte: Deallocate, Delete
--ssh-access
Vorschau

Aktualisieren Sie die SSH-Einstellung für den Knotenpool. Verwenden Sie "disabled", um den SSH-Zugriff zu deaktivieren, "localuser", um den SSH-Zugriff mit privatem Schlüssel zu aktivieren.

Zulässige Werte: disabled, localuser
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--undrainable-node-behavior

Definieren Sie das Verhalten für unrainierbare Knoten während des Upgrades. Der Wert sollte "Cordon" oder "Schedule" sein. Der Standardwert ist "Schedule".

--update-cluster-autoscaler -u

Aktualisieren Sie die Minenanzahl oder die maximale Anzahl für die Cluster-Autoskaler.

Standardwert: False
--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool upgrade

Führt ein Upgrade für den Knotenpool in einem Managed Kubernetes-Cluster durch.

az aks nodepool upgrade --cluster-name
                        --name
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--kubernetes-version]
                        [--max-surge]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--yes]

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Durch Trennzeichen getrennte Schlüssel-Wert-Paare, um benutzerdefinierte Header anzugeben.

--drain-timeout

Wenn Knoten abwässern, wie lange gewartet werden muss, bis alle Pods entfernt werden.

--kubernetes-version -k

Version von Kubernetes zum Upgrade des Knotenpools auf ,, z. B. "1.16.9".

--max-surge

Zusätzliche Knoten, die zum Beschleunigen des Upgrades verwendet werden. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 5 oder 33 % (sich gegenseitig ausschließend mit "--node-image-only". Siehe "az aks nodepool update --max-surge", um den maximalen Anstieg vor dem Upgrade mit "--node-image-only" zu aktualisieren.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-image-only

Nur upgraden Sie das Knotenimage des Agentpools.

Standardwert: False
--node-soak-duration

Die Zeit (in Minuten), die nach dem Entwässern eines Knotens und vor dem Neustellen des Knotens und dem Wechsel zum nächsten Knoten gewartet werden soll.

--snapshot-id

Die Quellmomentaufnahme-ID, die zum Upgrade dieses Knotenpools verwendet wird.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool upgrade (aks-preview Erweiterung)

Führt ein Upgrade für den Knotenpool in einem Managed Kubernetes-Cluster durch.

az aks nodepool upgrade --cluster-name
                        --name
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-surge]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--yes]

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--aks-custom-headers

Senden von benutzerdefinierten Kopfzeilen. Wenn angegeben, sollte das Format Key1=Wert1;Key2=Wert2 sein.

--drain-timeout

Wenn Knoten abwässern, wie viele Minuten warten, bis alle Pods entfernt werden.

--if-match

Der angegebene Wert wird mit dem ETag des Knotenpools verglichen, wenn er mit dem Vorgang übereinstimmt, wird fortgesetzt. Wenn sie nicht übereinstimmen, wird die Anforderung abgelehnt, um versehentliche Überschreibungen zu verhindern. Dies darf beim Erstellen eines neuen Agentpools nicht angegeben werden. Bei Upgradeknoten-Imageversionsanforderungen wird dies ignoriert.

--if-none-match

Legen Sie auf '*' fest, damit ein neuer Knotenpool erstellt werden kann, aber um zu verhindern, dass ein vorhandener Knotenpool aktualisiert wird. Andere Werte werden ignoriert.

--kubernetes-version -k

Version von Kubernetes zum Upgrade des Knotenpools auf "1.11.12".

--max-surge

Zusätzliche Knoten, die zum Beschleunigen des Upgrades verwendet werden. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 5 oder 33 %.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-image-only

Nur upgraden Sie das Knotenimage des Agentpools.

Standardwert: False
--node-soak-duration

Die Zeit (in Minuten), die nach dem Entwässern eines Knotens und vor dem Neustellen des Knotens und dem Wechsel zum nächsten Knoten gewartet werden soll.

--snapshot-id

Die Quellmomentaufnahme-ID, die zum Upgrade dieses Knotenpools verwendet wird. Muss den VMSS-Agentpooltyp verwenden.

--undrainable-node-behavior

Definieren Sie das Verhalten für unrainierbare Knoten während des Upgrades. Der Wert sollte "Cordon" oder "Schedule" sein. Der Standardwert ist "Schedule".

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az aks nodepool wait

Warten Sie, bis ein Knotenpool einen gewünschten Zustand erreicht.

Wenn ein Vorgang in einem Knotenpool unterbrochen oder mit --no-waitdiesem gestartet wurde, verwenden Sie diesen Befehl, um darauf zu warten, bis er abgeschlossen ist.

az aks nodepool wait --cluster-name
                     --name
                     --resource-group
                     [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--interval]
                     [--timeout]
                     [--updated]

Beispiele

Warten Sie, bis ein Knotenpool einen gewünschten Zustand erreicht, und fordern Sie alle Minuten bis zu dreißig Minuten ab.

az aks nodepool wait --created --interval 60 --cluster-name MyManagedCluster --resource-group MyResourceGroup --nodepool-name MyNodePool --timeout 1800

Erforderliche Parameter

--cluster-name

Den Clusternamen.

--name --nodepool-name -n

Der Name des Knotenpools.

--resource-group -g

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

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--interval

Abrufintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.