Freigeben über


az aks nodepool

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.

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 GA
az aks nodepool add (aks-preview Erweiterung)

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

Extension GA
az aks nodepool delete

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

Core GA
az aks nodepool delete (aks-preview Erweiterung)

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

Extension GA
az aks nodepool delete-machines

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

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

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

Extension GA
az aks nodepool get-upgrades

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

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

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

Extension GA
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 GA
az aks nodepool list (aks-preview Erweiterung)

Listet Knotenpools im Managed Kubernetes-Cluster auf.

Extension GA
az aks nodepool manual-scale

Befehle zum Verwalten von nodepool virtualMachineProfile.scale.manual.

Kern und Erweiterung GA
az aks nodepool manual-scale add

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

Core GA
az aks nodepool manual-scale add (aks-preview Erweiterung)

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

Extension GA
az aks nodepool manual-scale delete

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

Core GA
az aks nodepool manual-scale delete (aks-preview Erweiterung)

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

Extension GA
az aks nodepool manual-scale update

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

Core GA
az aks nodepool manual-scale update (aks-preview Erweiterung)

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

Extension GA
az aks nodepool operation-abort

Abbrechen des letzten Ausgeführten Vorgangs auf nodepool.

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

Abbrechen des letzten Ausgeführten Vorgangs auf nodepool.

Extension GA
az aks nodepool scale

Skaliert den Knotenpool in einem Managed Kubernetes-Cluster.

Core GA
az aks nodepool scale (aks-preview Erweiterung)

Skaliert den Knotenpool in einem Managed Kubernetes-Cluster.

Extension GA
az aks nodepool show

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

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

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

Extension GA
az aks nodepool snapshot

Befehle zum Verwalten von Nodepool-Momentaufnahmen.

Kern und Erweiterung GA
az aks nodepool snapshot create

Erstellen Sie eine Nodepool-Momentaufnahme.

Core GA
az aks nodepool snapshot create (aks-preview Erweiterung)

Erstellen Sie eine Nodepool-Momentaufnahme.

Extension GA
az aks nodepool snapshot delete

Löschen sie eine Nodepool-Momentaufnahme.

Core GA
az aks nodepool snapshot delete (aks-preview Erweiterung)

Löschen sie eine Nodepool-Momentaufnahme.

Extension GA
az aks nodepool snapshot list

Knotenpoolmomentaufnahmen auflisten.

Core GA
az aks nodepool snapshot list (aks-preview Erweiterung)

Knotenpoolmomentaufnahmen auflisten.

Extension GA
az aks nodepool snapshot show

Zeigen Sie die Details einer Nodepool-Momentaufnahme an.

Core GA
az aks nodepool snapshot show (aks-preview Erweiterung)

Zeigen Sie die Details einer Nodepool-Momentaufnahme an.

Extension GA
az aks nodepool snapshot update

Aktualisieren von Tags in einer Momentaufnahme eines Knotenpools.

Core GA
az aks nodepool snapshot update (aks-preview Erweiterung)

Aktualisieren von Tags in einer Momentaufnahme eines Knotenpools.

Extension GA
az aks nodepool snapshot wait

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

Core GA
az aks nodepool start

Starten Sie den Agentpool im verwalteten Kubernetes-Cluster angehalten.

Core GA
az aks nodepool start (aks-preview Erweiterung)

Starten Sie den Agentpool im verwalteten Kubernetes-Cluster angehalten.

Extension GA
az aks nodepool stop

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

Core GA
az aks nodepool stop (aks-preview Erweiterung)

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

Extension GA
az aks nodepool update

Aktualisieren sie die Eigenschaften eines Knotenpools.

Core GA
az aks nodepool update (aks-preview Erweiterung)

Aktualisieren sie die Eigenschaften eines Knotenpools.

Extension GA
az aks nodepool upgrade

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

Core GA
az aks nodepool upgrade (aks-preview Erweiterung)

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

Extension GA
az aks nodepool wait

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

Core GA

az aks nodepool add

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

az aks nodepool add --cluster-name
                    --name --nodepool-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}]
                    [--gateway-prefix-size]
                    [--gpu-driver {Install, None}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--localdns-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--max-unavailable]
                    [--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, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataVmIsolation}]
                    [--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"

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/SubID/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 MyNodePool --cluster-name MyMC --vm-set-type VirtualMachines --vm-sizes "VMSize1,VMSize2" --node-count 3

Erstellen Sie einen Knotenpool mit aktivierter KataVmIsolation.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku AzureLinux --vm-size Standard_D4s_v3 --workload-runtime KataVmIsolation --node-count 1

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

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

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

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

Enable EncryptionAtHost, standardwert is false.

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

Verwenden Sie FIPS-fähiges Betriebssystem auf Agentknoten.

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

Aktivieren Sie die öffentliche IP des VMSS- oder VMs-Knotens.

Eigenschaft Wert
Standardwert: False
--enable-secure-boot

Aktivieren sie den sicheren Start im Agentknotenpool. Muss VMSS- oder VMs-Agent-Pooltyp verwenden.

Eigenschaft Wert
Standardwert: False
--enable-ultra-ssd

UltraSSD aktivieren, Standardwert ist "false".

Eigenschaft Wert
Standardwert: False
--enable-vtpm

Aktivieren Sie vTPM im Agentknotenpool. Muss VMSS- oder VMs-Agent-Pooltyp verwenden.

Eigenschaft Wert
Standardwert: False
--eviction-policy

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

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

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

Gibt an, ob der Treiber für den GPU-Knotenpool installiert werden soll. Mögliche Werte sind "Install" oder "None". Der Standardwert ist "Installieren".

Eigenschaft Wert
Zulässige Werte: Install, None
--gpu-instance-profile

GPU-Instanzprofil zur Partitionierung multi-gpu Nvidia GPUs.

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

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

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

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

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

--localdns-config

Legen Sie das localDNS-Profil für einen Knotenpool mit einer JSON-Konfigurationsdatei fest.

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

--max-unavailable

Die maximale Anzahl oder der Prozentsatz der Knoten, die während des Upgrades gleichzeitig nicht verfügbar sein können. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

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

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.

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

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

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

Eigenschaft Wert
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').

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

Öffentliche IP-Präfix-ID, die zum Zuweisen öffentlicher IPs zu VMSS- oder VMs-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. Wenn der Benutzer keins angibt, wählt der Server für ihn eine Standard-VM-Größe aus.

--os-sku

Die Betriebssystem-SKU des Agentknotenpools. Ubuntu, Ubuntu2204, AzureLinux oder AzureLinux3 für Linux. Windows2019 oder Windows2022 für Windows.

Eigenschaft Wert
Zulässige Werte: AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022
--os-type

Der Betriebssystemtyp. Linux oder Windows.

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

Eigenschaft Wert
Zulässige Werte: DynamicIndividual, StaticBlock
--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.

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

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

Eigenschaft Wert
Standardwert: Delete
Zulässige Werte: Deallocate, 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 up-to wird. Sie kann nur bis zu 5 Dezimalstellen enthalten.

Eigenschaft Wert
Standardwert: nan
--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".

Eigenschaft Wert
Standardwert: Schedule
--vm-set-type

Vm-Satztyp des Agentpools. VirtualMachineScaleSets oder AvailabilitySet oder VirtualMachines. Standardwert ist "VirtualMachineScaleSets".

--vm-sizes

Durch Trennzeichen getrennte Liste von VM-Größen. Nur gültig für VirtualMachines-Knotenpool. Wenn --vm-sizes nicht angegeben, aber --node-vm-size angegeben, wird der Wert verwendet --node-vm-size . Wenn keine davon angegeben ist, werden standardmäßig Standard_DS2_v2 für Linux oder Standard_D2s_v3 für Windows verwendet.

--vnet-subnet-id

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

--workload-runtime

Legen Sie die Workloadlaufzeit fest.

Azure bietet eine andere Workload-Runtime, um Kata unterstützte Workloads in Ihren Nodepools zu aktivieren. Die folgenden Werte können angegeben werden:

  • "KataVmIsolation" für Kata.
Eigenschaft Wert
Zulässige Werte: KataVmIsolation
--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

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 nodepool add (aks-preview Erweiterung)

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

az aks nodepool add --cluster-name
                    --name --nodepool-name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--batch-soak-duration]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-batch-size]
                    [--drain-timeout]
                    [--drain-timeout-bg]
                    [--driver-type {CUDA, GRID}]
                    [--enable-artifact-streaming]
                    [--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}]
                    [--final-soak-duration]
                    [--gateway-prefix-size]
                    [--gpu-driver {Install, None}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--localdns-config]
                    [--max-blocked-nodes]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--max-unavailable]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, Machines, ManagedSystem, 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, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, entraid, localuser}]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--upgrade-strategy {BlueGreen, Rolling}]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, KataVmIsolation, 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

Erstellen eines Knotenpools mit dem ManagedSystem-Modus

az aks nodepool add -g MyResourceGroup -n managedsystem1 --cluster-name MyManagedCluster --mode ManagedSystem

Erstellen eines Knotenpools mit blaugrüner Upgradestrategie und Standardparametern

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --upgrade-strategy BlueGreen

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

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

--batch-soak-duration

Wartezeit (in Minuten) nach dem Entladen eines Batches von Knoten, bevor Sie mit dem nächsten Batch fortfahren. Der Standardwert ist 15 Minuten. Nur für blaugrüne Upgrades.

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

Eigenschaft Wert
Standardwert: False
--drain-batch-size

Anzahl oder Prozentsatz der Knoten, die pro Batch während blaugrüner Upgrades entwässert werden sollen. Akzeptiert eine ganze Zahl (z. B. '5') oder einen Prozentsatz (z. B. '50%'). Der Standardwert ist 10%.

Gibt an, wie viele Knoten während eines blaugrünen Upgrades in jedem Batch abgelassen werden sollen. Muss ein Wert ungleich Null sein, entweder als ganze Zahl (z. B. '5') oder als Prozentsatz (z. B. '50%') der blauen Gesamtknoten am Anfang des Upgrades. Bruchknoten werden aufgerundet. Weitere Details und bewährte Methoden finden Sie unter https://v4.hkg1.meaqua.org/en-us/azure/aks/upgrade-cluster.

--drain-timeout

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

--drain-timeout-bg

Timeout (in Minuten) zum Entfernen von Pods und ordnungsgemäßer Beendigung pro Knoten während blaugrüner Upgrades. Der Standardwert ist 30 Minuten.

Maximale Zeit (in Minuten), bis die Pod-Eviction und die ordnungsgemäße Beendigung pro Knoten während blaugrüner Upgrades gewartet werden. Honors pod disruption budgets. Wenn dies überschritten wird, schlägt das Upgrade fehl. Der Standardwert ist 30 Minuten.

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

Eigenschaft Wert
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".

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

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

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

Aktivieren Sie EncryptionAtHost im Agentknotenpool.

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

Verwenden Sie FIPS-fähiges Betriebssystem auf Agentknoten.

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

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

Eigenschaft Wert
Standardwert: False
--enable-secure-boot
Vorschau

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

Eigenschaft Wert
Standardwert: False
--enable-ultra-ssd

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

Eigenschaft Wert
Standardwert: False
--enable-vtpm
Vorschau

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

Eigenschaft Wert
Standardwert: False
--eviction-policy

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

Eigenschaft Wert
Standardwert: Delete
Zulässige Werte: Deallocate, Delete
--final-soak-duration

Wartezeit (in Minuten), nachdem alle alten Knoten entwässert wurden, bevor sie entfernt werden. Der Standardwert ist 60 Minuten. Nur für blaugrüne Upgrades.

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

Gibt an, ob der Treiber für den GPU-Knotenpool installiert werden soll. Mögliche Werte sind "Install" oder "None". Der Standardwert ist "Installieren".

Eigenschaft Wert
Zulässige Werte: Install, None
--gpu-instance-profile

GPU-Instanzprofil zur Partitionierung multi-gpu Nvidia GPUs.

Eigenschaft Wert
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".

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

--localdns-config

Legen Sie das localDNS-Profil für einen Knotenpool mit einer JSON-Konfigurationsdatei fest.

--max-blocked-nodes

Die maximale Anzahl oder der Prozentsatz der zusätzlichen Knoten, die während eines Upgrades im Agentpool blockiert werden dürfen, wenn das Verhalten eines nicht zulässigen Knotens Cordon ist. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

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

Eigenschaft Wert
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 %.

--max-unavailable

Die maximale Anzahl oder der Prozentsatz der Knoten, die während des Upgrades gleichzeitig nicht verfügbar sein können. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

--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. Wenn diese Eigenschaft als "ManagedSystem" festgelegt ist, werden alle anderen Eigenschaften außer Name und Modus von AKS zurückgesetzt und verwaltet. Weitere Informationen finden Sie unter https://aka.ms/aks/nodepool/mode.

Eigenschaft Wert
Standardwert: User
Zulässige Werte: Gateway, Machines, ManagedSystem, System, User
--no-wait

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

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

Eigenschaft Wert
Standardwert: 3
--node-osdisk-size

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

Eigenschaft Wert
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').

Eigenschaft Wert
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. Wenn der Benutzer keins angibt, wählt der Server für ihn eine Standard-VM-Größe aus.

--os-sku

Die Os-sku des Agentknotenpools. Ubuntu, Ubuntu2204, Ubuntu2404, CBLMarin, AzureLinux, AzureLinux3, AzureLinuxOSGuard, AzureLinux3OSGuard oder Flatcar, wenn os-type Linux ist, standard ist Ubuntu, wenn nicht festgelegt; Windows2019, Windows2022, Windows2025 oder WindowsAnnual, wenn der Betriebssystemtyp Windows ist, ist der aktuelle Standardwert Windows2022, falls nicht festgelegt.

Eigenschaft Wert
Zulässige Werte: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, 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.

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

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

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

Eigenschaft Wert
Standardwert: Delete
Zulässige Werte: Deallocate, Delete
--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 up-to wird. Sie kann nur bis zu 5 Dezimalstellen enthalten.

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

Eigenschaft Wert
Standardwert: localuser
Zulässige Werte: disabled, entraid, 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".

--upgrade-strategy

Upgradestrategie für den Knotenpool. Zulässige Werte sind "Rolling" oder "BlueGreen". Der Standardwert ist "Roll".

Eigenschaft Wert
Zulässige Werte: BlueGreen, Rolling
--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.

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

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

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

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

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

Beispiele

Löschen eines Agentpools mit ignore-pdb

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --if-match etag --ignore-pdb

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

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

Löschen Sie einen vorhandenen Knotenpool, ohne das Pod Disruption Budget in Betracht zu ziehen.

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 nodepool delete (aks-preview Erweiterung)

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

az aks nodepool delete --cluster-name
                       --name --nodepool-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

Der Clustername.

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

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

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

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

Eigenschaft Wert
Standardwert: False
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 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 --nodepool-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

Der Clustername.

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

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 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 --nodepool-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

Der Clustername.

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

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 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 --nodepool-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

Der Clustername.

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

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

Der Clustername.

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

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

Der Clustername.

--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 nodepool list (aks-preview Erweiterung)

Listet Knotenpools im Managed Kubernetes-Cluster auf.

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

Erforderliche Parameter

--cluster-name

Der Clustername.

--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 nodepool operation-abort

Abbrechen des letzten Ausgeführten Vorgangs auf nodepool.

az aks nodepool operation-abort --cluster-name
                                --name --nodepool-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

Der Clustername.

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

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 nodepool operation-abort (aks-preview Erweiterung)

Abbrechen des letzten Ausgeführten Vorgangs auf nodepool.

az aks nodepool operation-abort --cluster-name
                                --name --nodepool-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

Der Clustername.

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

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

--aks-custom-headers

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 nodepool scale

Skaliert den Knotenpool in einem Managed Kubernetes-Cluster.

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

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
--node-count -c

Anzahl der Knoten im Kubernetes-Knotenpool.

Eigenschaft Wert
Standardwert: 3
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 nodepool scale (aks-preview Erweiterung)

Skaliert den Knotenpool in einem Managed Kubernetes-Cluster.

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

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

--aks-custom-headers

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
--node-count -c

Anzahl der Knoten im Kubernetes-Knotenpool.

Eigenschaft Wert
Standardwert: 3
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 nodepool show

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

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

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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 nodepool show (aks-preview Erweiterung)

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

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

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

Starten Sie den Agentpool im verwalteten Kubernetes-Cluster angehalten.

az aks nodepool start --cluster-name
                      --name --nodepool-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

Der Clustername.

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

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

--aks-custom-headers

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 nodepool start (aks-preview Erweiterung)

Starten Sie den Agentpool im verwalteten Kubernetes-Cluster angehalten.

az aks nodepool start --cluster-name
                      --name --nodepool-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

Der Clustername.

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

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

--aks-custom-headers

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 nodepool stop

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

az aks nodepool stop --cluster-name
                     --name --nodepool-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

Der Clustername.

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

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

--aks-custom-headers

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 nodepool stop (aks-preview Erweiterung)

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

az aks nodepool stop --cluster-name
                     --name --nodepool-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

Der Clustername.

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

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

--aks-custom-headers

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

--no-wait

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

Eigenschaft Wert
Standardwert: False
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 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 --nodepool-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]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--localdns-config]
                       [--max-count]
                       [--max-surge]
                       [--max-unavailable]
                       [--min-count]
                       [--mode {Gateway, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, AzureLinux3, Ubuntu, Ubuntu2204}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--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

Der Clustername.

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

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

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

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

Wechseln Sie zu nicht FIPS-aktivierten Betriebssystemen auf Agentknoten.

Eigenschaft Wert
Standardwert: False
--disable-secure-boot

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

Eigenschaft Wert
Standardwert: False
--disable-vtpm

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

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

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

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

Eigenschaft Wert
Standardwert: False
--enable-secure-boot

Aktivieren des sicheren Starts in einem vorhandenen vertrauenswürdigen Start-Agent-Knotenpool. Muss VMSS- oder VMs-Agent-Pooltyp verwenden.

Eigenschaft Wert
Standardwert: False
--enable-vtpm

Aktivieren Sie vTPM für einen vorhandenen vertrauenswürdigen Start-Agent-Knotenpool. Muss VMSS- oder VMs-Agent-Pooltyp verwenden.

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

--localdns-config

Legen Sie das localDNS-Profil für einen Knotenpool mit einer JSON-Konfigurationsdatei fest.

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

--max-unavailable

Die maximale Anzahl oder der Prozentsatz der Knoten, die während des Upgrades gleichzeitig nicht verfügbar sein können. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

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

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

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

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

Eigenschaft Wert
Zulässige Werte: AzureLinux, AzureLinux3, Ubuntu, Ubuntu2204
--scale-down-mode

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

Eigenschaft Wert
Zulässige Werte: Deallocate, Delete
--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.

Eigenschaft Wert
Standardwert: False
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 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 --nodepool-name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--batch-soak-duration]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-batch-size]
                       [--drain-timeout]
                       [--drain-timeout-bg]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--final-soak-duration]
                       [--gpu-driver {Install, None}]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--localdns-config]
                       [--max-blocked-nodes]
                       [--max-count]
                       [--max-surge]
                       [--max-unavailable]
                       [--min-count]
                       [--mode {Gateway, Machines, ManagedSystem, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--node-vm-size]
                       [--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, Flatcar, Ubuntu, Ubuntu2204, Ubuntu2404}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, entraid, localuser}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]
                       [--upgrade-strategy {BlueGreen, Rolling}]
                       [--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

Aktualisieren der Vm-Größe der automatischen Skalierung des Clusters, der Minenanzahl und der maximalen Anzahl für den Knotenpool virtueller Computer

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --update-cluster-autoscaler --node-vm-size "Standard_D2s_v3" --min-count 2 --max-count 4

Aktualisieren eines Knotenpools mit blaugrünen Upgradeeinstellungen

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --drain-batch-size 50% --drain-timeout-bg 5 --batch-soak-duration 10 --final-soak-duration 10

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

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

--batch-soak-duration

Wartezeit (in Minuten) nach dem Entladen eines Batches von Knoten, bevor Sie mit dem nächsten Batch fortfahren. Der Standardwert ist 15 Minuten. Nur für blaugrüne Upgrades.

--disable-cluster-autoscaler -d

Deaktivieren Sie die Clusterautoskaler.

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

Wechseln Sie zu nicht FIPS-aktivierten Betriebssystemen auf Agentknoten.

Eigenschaft Wert
Standardwert: False
--disable-secure-boot
Vorschau

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

Eigenschaft Wert
Standardwert: False
--disable-vtpm
Vorschau

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

Eigenschaft Wert
Standardwert: False
--drain-batch-size

Anzahl oder Prozentsatz der Knoten, die pro Batch während blaugrüner Upgrades entwässert werden sollen. Akzeptiert eine ganze Zahl (z. B. '5') oder einen Prozentsatz (z. B. '50%'). Der Standardwert ist 10%.

Gibt an, wie viele Knoten während eines blaugrünen Upgrades in jedem Batch abgelassen werden sollen. Muss ein Wert ungleich Null sein, entweder als ganze Zahl (z. B. '5') oder als Prozentsatz (z. B. '50%') der blauen Gesamtknoten am Anfang des Upgrades. Bruchknoten werden aufgerundet. Weitere Details und bewährte Methoden finden Sie unter: https://v4.hkg1.meaqua.org/en-us/azure/aks/upgrade-cluster.

--drain-timeout

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

--drain-timeout-bg

Timeout (in Minuten) zum Entfernen von Pods und ordnungsgemäßer Beendigung pro Knoten während blaugrüner Upgrades. Der Standardwert ist 30 Minuten.

Maximale Zeit (in Minuten), bis die Pod-Eviction und die ordnungsgemäße Beendigung pro Knoten während blaugrüner Upgrades gewartet werden. Honors pod disruption budgets. Wenn dies überschritten wird, schlägt das Upgrade fehl. Der Standardwert ist 30 Minuten.

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

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

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

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

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

Eigenschaft Wert
Standardwert: False
--enable-secure-boot
Vorschau

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

Eigenschaft Wert
Standardwert: False
--enable-vtpm
Vorschau

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

Eigenschaft Wert
Standardwert: False
--final-soak-duration

Wartezeit (in Minuten), nachdem alle alten Knoten entwässert wurden, bevor sie entfernt werden. Der Standardwert ist 60 Minuten. Nur für blaugrüne Upgrades.

--gpu-driver

Gibt an, ob der Treiber für den GPU-Knotenpool installiert werden soll. Mögliche Werte sind "Install" oder "None".

Eigenschaft Wert
Zulässige Werte: Install, None
--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

--localdns-config

Legen Sie das localDNS-Profil für einen Knotenpool mit einer JSON-Konfigurationsdatei fest.

--max-blocked-nodes

Die maximale Anzahl oder der Prozentsatz der zusätzlichen Knoten, die während eines Upgrades im Agentpool blockiert werden dürfen, wenn das Verhalten eines nicht zulässigen Knotens Cordon ist. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

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

--max-unavailable

Die maximale Anzahl oder der Prozentsatz der Knoten, die während des Upgrades gleichzeitig nicht verfügbar sein können. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

--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. Wenn diese Eigenschaft als "ManagedSystem" festgelegt ist, werden alle anderen Eigenschaften außer Name und Modus von AKS abgelehnt und verwaltet. Weitere Informationen finden Sie unter https://aka.ms/aks/nodepool/mode.

Eigenschaft Wert
Zulässige Werte: Gateway, Machines, ManagedSystem, System, User
--no-wait

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

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

--node-vm-size -s

VM-Größe für Kubernetes-Knoten. Nur konfigurierbar, wenn die Einstellungen für die automatische Skalierung eines VirtualMachines-Knotenpools aktualisiert werden.

--os-sku

Die Os-sku des Agentknotenpools.

Eigenschaft Wert
Zulässige Werte: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, Flatcar, Ubuntu, Ubuntu2204, Ubuntu2404
--scale-down-mode

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

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

Eigenschaft Wert
Zulässige Werte: disabled, entraid, 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.

Eigenschaft Wert
Standardwert: False
--upgrade-strategy

Upgradestrategie für den Knotenpool. Zulässige Werte sind "Rolling" oder "BlueGreen". Der Standardwert ist "Roll".

Eigenschaft Wert
Zulässige Werte: BlueGreen, Rolling
--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
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 nodepool upgrade

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

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

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

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

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

--max-unavailable

Die maximale Anzahl oder der Prozentsatz der Knoten, die während des Upgrades gleichzeitig nicht verfügbar sein können. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

--no-wait

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

Eigenschaft Wert
Standardwert: False
--node-image-only

Nur upgraden Sie das Knotenimage des Agentpools.

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

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

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
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 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 --nodepool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--batch-soak-duration]
                        [--drain-batch-size]
                        [--drain-timeout]
                        [--drain-timeout-bg]
                        [--final-soak-duration]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-blocked-nodes]
                        [--max-surge]
                        [--max-unavailable]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--upgrade-strategy {BlueGreen, Rolling}]
                        [--yes]

Erforderliche Parameter

--cluster-name

Der Clustername.

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

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

--aks-custom-headers

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

--batch-soak-duration

Wartezeit (in Minuten) nach dem Entladen eines Batches von Knoten, bevor Sie mit dem nächsten Batch fortfahren. Der Standardwert ist 15 Minuten. Nur für blaugrüne Upgrades.

--drain-batch-size

Anzahl oder Prozentsatz der Knoten, die pro Batch während blaugrüner Upgrades entwässert werden sollen. Akzeptiert eine ganze Zahl (z. B. '5') oder einen Prozentsatz (z. B. '50%'). Der Standardwert ist 10%.

Gibt an, wie viele Knoten während eines blaugrünen Upgrades in jedem Batch abgelassen werden sollen. Muss ein Wert ungleich Null sein, entweder als ganze Zahl (z. B. '5') oder als Prozentsatz (z. B. '50%') der blauen Gesamtknoten am Anfang des Upgrades. Bruchknoten werden aufgerundet. Weitere Details und bewährte Methoden finden Sie unter: https://v4.hkg1.meaqua.org/en-us/azure/aks/upgrade-cluster.

--drain-timeout

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

--drain-timeout-bg

Timeout (in Minuten) zum Entfernen von Pods und ordnungsgemäßer Beendigung pro Knoten während blaugrüner Upgrades. Der Standardwert ist 30 Minuten.

Maximale Zeit (in Minuten), bis die Pod-Eviction und die ordnungsgemäße Beendigung pro Knoten während blaugrüner Upgrades gewartet werden. Honors pod disruption budgets. Wenn dies überschritten wird, schlägt das Upgrade fehl. Der Standardwert ist 30 Minuten.

--final-soak-duration

Wartezeit (in Minuten), nachdem alle alten Knoten entwässert wurden, bevor sie entfernt werden. Der Standardwert ist 60 Minuten. Nur für blaugrüne Upgrades.

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

Die maximale Anzahl oder der Prozentsatz der zusätzlichen Knoten, die während eines Upgrades im Agentpool blockiert werden dürfen, wenn das Verhalten eines nicht zulässigen Knotens Cordon ist. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

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

--max-unavailable

Die maximale Anzahl oder der Prozentsatz der Knoten, die während des Upgrades gleichzeitig nicht verfügbar sein können. Wenn angegeben, stellt sie die verwendete Zahl oder den verwendeten Prozentsatz dar, z. B. 1 oder 5%.

--no-wait

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

Eigenschaft Wert
Standardwert: False
--node-image-only

Nur upgraden Sie das Knotenimage des Agentpools.

Eigenschaft Wert
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".

--upgrade-strategy

Upgradestrategie für den Knotenpool. Zulässige Werte sind "Rolling" oder "BlueGreen". Der Standardwert ist "Roll".

Eigenschaft Wert
Zulässige Werte: BlueGreen, Rolling
--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
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 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 --nodepool-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

Der Clustername.

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

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

--created

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

Eigenschaft Wert
Parametergruppe: Wait Condition Arguments
Standardwert: False
--custom

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

Eigenschaft Wert
Parametergruppe: Wait Condition Arguments
--deleted

Warten Sie, bis sie gelöscht wurde.

Eigenschaft Wert
Parametergruppe: Wait Condition Arguments
Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Eigenschaft Wert
Parametergruppe: Wait Condition Arguments
Standardwert: False
--interval

Abrufintervall in Sekunden.

Eigenschaft Wert
Parametergruppe: Wait Condition Arguments
Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Eigenschaft Wert
Parametergruppe: Wait Condition Arguments
Standardwert: 3600
--updated

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

Eigenschaft Wert
Parametergruppe: Wait Condition Arguments
Standardwert: False
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