az aksarc

Note

Diese Referenz ist Teil der erweiterung aksarc für die Azure CLI (Version 2.77.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az aksarc-Befehl zum ersten Mal ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten von bereitgestellten Clustern.

Befehle

Name Beschreibung Typ Status
az aksarc create

Erstellt den bereitgestellten Cluster.

 Extension GA
az aksarc delete

Löscht den bereitgestellten Cluster.

 Extension GA
az aksarc deploy

Stellen Sie einen vollständigen AKS-Baremetalcluster auf einem oder mehreren vorhandenen Arc-for-Servers (BareMetal)-Hosts bereit.

 Extension GA
az aksarc get-credentials

Rufen Sie die lokale Kubeconfig des bereitgestellten Clusters ab.

 Extension GA
az aksarc get-logs

Sammeln Sie Protokolle aus bereitgestellten Clustern und der zugrunde liegenden Infrastruktur.

 Extension GA
az aksarc get-upgrades

Rufen Sie die für den bereitgestellten Cluster verfügbaren Upgradeversionen ab.

 Extension GA
az aksarc get-versions

Auflisten der unterstützten Kubernetes-Versionen am angegebenen benutzerdefinierten Speicherort.

 Extension GA
az aksarc list

Listet die bereitgestellten Cluster in einer Ressourcengruppe oder in einem Abonnement auf.

 Extension GA
az aksarc logs

Deprecated. Verwenden Sie stattdessen "az aksarc get-logs".

 Extension GA
az aksarc logs hci

Sammeln Sie Protokolle aus bereitgestellten Clustern und der zugrunde liegenden Infrastruktur.

 Extension Deprecated
az aksarc nodepool

Verwalten von Knotenpools in einem bereitgestellten Cluster.

 Extension GA
az aksarc nodepool add

Fügt einen Knotenpool im bereitgestellten Cluster hinzu.

 Extension GA
az aksarc nodepool delete

Löscht den Knotenpool im bereitgestellten Cluster.

 Extension GA
az aksarc nodepool list

Listet alle Knotenpools im bereitgestellten Cluster auf.

 Extension GA
az aksarc nodepool scale

Skaliert den Knotenpool im bereitgestellten Cluster.

 Extension GA
az aksarc nodepool show

Ruft den Knotenpool im bereitgestellten Cluster ab.

 Extension GA
az aksarc nodepool update

Aktualisieren sie einen Knotenpool im bereitgestellten Cluster.

 Extension GA
az aksarc notice

AusgabeHINWEIS-Datei an vom Benutzer angegebene Dateipfad.

 Extension GA
az aksarc release

Verwalten von VHD-Images für bereitgestellte Cluster.

 Extension Preview
az aksarc release download

Lädt die VHD-Bilder aus einer Version herunter.

 Extension Preview
az aksarc release save

Stellt die heruntergeladenen VHD-Bilder für die Arc-Ressourcenbrücke bereit.

 Extension Preview
az aksarc show

Ruft den bereitgestellten Cluster ab.

 Extension GA
az aksarc undeploy

Zerreißen Sie einen AKS-Baremetalcluster, der zuvor von "az aksarc deploy" erstellt wurde.

 Extension GA
az aksarc update

Aktualisiert den bereitgestellten Cluster.

 Extension GA
az aksarc upgrade

Aktualisiert den bereitgestellten Cluster.

 Extension GA
az aksarc vmsize

Verwalten sie VIRTUELLE Computer-SKUs für bereitgestellte Cluster.

 Extension GA
az aksarc vmsize list

Listet die unterstützten Größen des virtuellen Computers am angegebenen benutzerdefinierten Speicherort auf.

 Extension GA
az aksarc vnet

Verwalten sie virtuelle Netzwerke für bereitgestellte Cluster.

 Extension GA
az aksarc vnet create

Erstellt das virtuelle Netzwerk.

 Extension GA
az aksarc vnet delete

Löscht das virtuelle Netzwerk.

 Extension GA
az aksarc vnet list

Listet die virtuellen Netzwerke nach Ressourcengruppe oder Abonnement auf.

 Extension GA
az aksarc vnet show

Ruft das virtuelle Netzwerk ab.

 Extension GA

az aksarc create

Erstellt den bereitgestellten Cluster.

az aksarc create --custom-location
                 --name
                 --resource-group
                 --vnet-id --vnet-ids
                 [--aad-admin-group-object-ids]
                 [--acquire-policy-token]
                 [--ca-certs --custom-ca-trust-certificates]
                 [--ca-profile --cluster-autoscaler-profile]
                 [--change-reference]
                 [--control-plane-count --control-plane-node-count]
                 [--control-plane-ip]
                 [--control-plane-vm-size]
                 [--disable-nfs-driver]
                 [--disable-smb-driver]
                 [--enable-ahub]
                 [--enable-ai-toolchain-operator --enable-kaito]
                 [--enable-azure-rbac]
                 [--enable-cluster-autoscaler]
                 [--enable-oidc-issuer]
                 [--enable-wi --enable-workload-identity]
                 [--gateway-id]
                 [--generate-ssh-keys]
                 [--gpu-count-per-node]
                 [--kubernetes-version]
                 [--load-balancer-count]
                 [--location]
                 [--max-count]
                 [--max-pods]
                 [--min-count]
                 [--no-wait]
                 [--node-count]
                 [--node-vm-size]
                 [--nodepool-labels]
                 [--nodepool-taints]
                 [--pod-cidr]
                 [--ssh-auth-ips --ssh-authorized-ip-ranges]
                 [--ssh-key-value]
                 [--tags]
                 [--validate]

Beispiele

PutProvisionedCluster

az aksarc create --resource-group sample-rg --custom-location sample-cl --name sample-aksarccluster --vnet-ids "vnet-arm-id"

Erforderliche Parameter

--custom-location

Name oder ID des benutzerdefinierten Speicherorts, der für den bereitgestellten Cluster verwendet werden soll.

--name -n

Name des bereitgestellten Clusters.

--resource-group -g

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

--vnet-id --vnet-ids

ARM-Ressourcen-ID des virtuellen Aksarc-Netzwerks oder Azure Local logischen Netzwerks.

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.

--aad-admin-group-object-ids -i

Durch Trennzeichen getrennte Liste von Aad-Gruppenobjekt-IDs, die als Clusteradministrator für den bereitgestellten Cluster festgelegt werden.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--ca-certs --custom-ca-trust-certificates

Pfad zu einer Datei, die benutzerdefinierte Zertifizierungsstellen-Vertrauenszertifikate für das Sicherheitsprofil enthält. Die Datei kann mehrere PEM-Formatzertifikate (bis zu 10) enthalten. Jedes Zertifikat wird base64 codiert und dem Vertrauensspeicher auf allen Knoten hinzugefügt.

--ca-profile --cluster-autoscaler-profile

Durch Leerzeichen getrennte Liste der Schlüssel=Wertpaare zum Konfigurieren der Cluster-Autoskalierung. Übergeben Sie eine leere Zeichenfolge, um das Profil zu löschen.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--control-plane-count --control-plane-node-count

Anzahl der Steuerebenenknoten.

--control-plane-ip

Kubernetes APIServer IPAddress. Die IPAddress sollte von Azure Resource Bridge Appliance routingfähig sein, VM.It Teil des Netzwerksubnetz sein sollte, auf das verwiesen wird. Die Clustererstellung schlägt möglicherweise fehl oder timeout, wenn eine nicht routingfähige IPAddress übergeben wird.

--control-plane-vm-size

VM-Größe der Steuerungsebene.

--disable-nfs-driver

Deaktivieren Sie den NFS-Treiber für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--disable-smb-driver

Deaktivieren Sie den SMB-Treiber für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--enable-ahub

Aktivieren Sie Azure Hybridbenutzervorteile (Hybrid User Benefits, AHUB) für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--enable-ai-toolchain-operator --enable-kaito

Aktivieren Sie den KI-Toolchainoperator für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--enable-azure-rbac

Aktivieren Sie Azure RBAC, um Autorisierungsprüfungen auf dem Cluster zu steuern.

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

Aktivieren Sie die automatische Clusterskalierung für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--enable-oidc-issuer

Aktivieren Sie den OIDC-Aussteller.

Eigenschaft Wert
Standardwert: False
--enable-wi --enable-workload-identity

Aktivieren Sie das Workload-Identitäts-Addon.

Eigenschaft Wert
Standardwert: False
--gateway-id

Gateway arm ID des bereitgestellten Clusters.

--generate-ssh-keys

Generieren Sie ssh-Schlüsselpaar, falls nicht vorhanden.

Eigenschaft Wert
Standardwert: False
--gpu-count-per-node

Anzahl der gpus, die an einen Knoten angefügt sind.

--kubernetes-version -k

Die Kubernetes-Version des bereitgestellten Clusters.

--load-balancer-count

Anzahl der Lastenausgleichsknoten.

--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--max-count

Die maximale Anzahl von Knoten für die automatische Skalierung.

--max-pods -m

Maximale Anzahl von Pods, die auf einem Knoten ausgeführt werden können.

--min-count

Die Mindestanzahl der Knoten für die automatische Skalierung.

--no-wait

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

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

Anzahl der Knoten, die im Knotenpool erstellt werden sollen.

Eigenschaft Wert
Standardwert: 1
--node-vm-size

VM-Größe der Knoten im Knotenpool.

--nodepool-labels

Leerzeichentrennte Beschriftungen: key[=value] [key[=value] ...].

--nodepool-taints

Durch Trennzeichen getrennte Liste der Knotenpool-Taints.

--pod-cidr

Die CIDR-Notations-IP reicht aus, aus denen Pod-IPs zugewiesen werden sollen.

--ssh-auth-ips --ssh-authorized-ip-ranges

Durch Trennzeichen getrennte Liste von IP-Adressen oder CIDR, die eine Ssh-Verbindung mit der Cluster-VM zulassen.

--ssh-key-value

Pfad zum öffentlichen SSH-Schlüssel, der in die Steuerebene eingefügt werden soll.

Eigenschaft Wert
Standardwert: ~\.ssh\id_rsa.pub
--tags

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

--validate

Überprüfen Sie die Eingabeparameter des Clusters, ohne den Cluster tatsächlich zu erstellen.

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

Löscht den bereitgestellten Cluster.

az aksarc delete --name
                 --resource-group
                 [--acquire-policy-token]
                 [--change-reference]
                 [--no-wait]
                 [--yes]

Beispiele

DeleteProvisionedCluster

az aksarc delete --name "sample-aksarccluster" --resource-group "sample-rg"

Erforderliche Parameter

--name -n

Name des bereitgestellten Clusters.

--resource-group -g

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

Optionale Parameter

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

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--no-wait

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

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

Stellen Sie einen vollständigen AKS-Baremetalcluster auf einem oder mehreren vorhandenen Arc-for-Servers (BareMetal)-Hosts bereit.

Stellt einen vollständigen AKS-Baremetalcluster auf einem oder mehreren vorhandenen Arc-for-Servers (BareMetal)-Hosts bereit. Die einzige erforderliche Eingabe ist die Liste der Arc-fähigen Computernamen, aus denen der Cluster besteht. Die Hosts müssen bereits Arc-for-Servers aktiviert sein.

az aksarc deploy --arc-machine-name --arc-machine-names --machine-names
                 --resource-group
                 [--acquire-policy-token]
                 [--change-reference]
                 [--enable-wi --enable-workload-identity]
                 [--hci-rp-object-id]
                 [--kubernetes-version]
                 [--no-wait]
                 [--validate]
                 [--yes]

Beispiele

Bereitstellen eines Einzelknoten-AKS-Baremetalclusters

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost

Bereitstellen eines Mehrknoten-AKS-Baremetalclusters

az aksarc deploy --resource-group sample-rg --arc-machine-names host1 host2 host3

Bereitstellen mit aktivierter WorkloadIdentity-Unterstützung

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --enable-workload-identity

Bereitstellen eines bestimmten Kubernetes-Versionspakets

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --kubernetes-version 1.35.5-20260701

Bereitstellen ohne Microsoft Graph Nachschlagevorgang

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --hci-rp-object-id <hci-rp-object-id>

Überprüfen ohne Bereitstellung

az aksarc deploy --resource-group sample-rg --arc-machine-names host1 host2 --validate

Erforderliche Parameter

--arc-machine-name --arc-machine-names --machine-names -m

Durch Leerzeichen getrennte Namen der vorhandenen Arc-fähigen Computer (Arc-for-Servers) in der Ressourcengruppe, um den Clustergerätepool zu bilden. Stellen Sie einen für einen Pool mit einem einzigen Knoten oder mehrere für einen Pool mit mehreren Knoten bereit. Dies ist die einzige erforderliche Eingabe; alle anderen Clusterressourcen werden automatisch abgeleitet.

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

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--enable-wi --enable-workload-identity

Aktivieren Sie die Workloadidentität und den für Azure IoT Einsatz erforderlichen OIDC-Aussteller.

Eigenschaft Wert
Standardwert: False
--hci-rp-object-id

Mandantenspezifische Objekt-ID des Microsoft. Dienstprinzipal des AzureStackHCI-Ressourcenanbieters. Wenn sie weggelassen wird, verwendet die CLI HCI_RP_OBJECT_ID, wenn sie festgelegt ist, und greift dann auf Microsoft Graph zurück.

--kubernetes-version -k

Kubernetes versionsgesteuertes Bundle für den Cluster, z. B. 1.35.5-20260701. Wenn sie weggelassen wird, wählt der AKS Arc-Operator die aktuelle Standardversion aus.

--no-wait

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

Eigenschaft Wert
Standardwert: False
--validate

Überprüfen Sie die Bereitstellungsvorlage, ohne tatsächlich bereitzustellen.

Eigenschaft Wert
Standardwert: False
--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 aksarc get-credentials

Rufen Sie die lokale Kubeconfig des bereitgestellten Clusters ab.

az aksarc get-credentials --name
                          --resource-group
                          [--acquire-policy-token]
                          [--admin]
                          [--change-reference]
                          [--context]
                          [--file]
                          [--overwrite-existing]

Beispiele

GetAdminCredential

az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg" --admin

GetAADUserCredential

az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg"

Erforderliche Parameter

--name -n

Name des bereitgestellten Clusters.

--resource-group -g

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

Optionale Parameter

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

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--admin -a

Abrufen von Clusteradministratoranmeldeinformationen.

Eigenschaft Wert
Standardwert: False
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--context

Wenn angegeben, überschreiben Sie den Standardkontextnamen.

--file -f

Kubernetes-Konfigurationsdatei, die aktualisiert werden soll. Falls nicht angegeben, wird die Datei "~/.kube/config" aktualisiert.

Eigenschaft Wert
Standardwert: ~\.kube\config
--overwrite-existing

Überschreiben Sie alle vorhandenen Clustereinträge mit demselben Namen.

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 aksarc get-logs

Sammeln Sie Protokolle aus bereitgestellten Clustern und der zugrunde liegenden Infrastruktur.

az aksarc get-logs [--acquire-policy-token]
                   [--change-reference]
                   [--credentials-dir --ssh-key]
                   [--ip --ips]
                   [--kubeconfig]
                   [--out-dir]

Beispiele

Sammeln von Protokollen mit IP-Adresse und SSH-Anmeldeinformationen

az aksarc get-logs --ip 192.168.200.31 192.168.200.32 --ssh-key ~/.ssh --out-dir ./logs

Sammeln von Protokollen mit kubeconfig- und SSH-Anmeldeinformationen, kubeconfig wird nur zum Sammeln von IP-Adressen verwendet, und der Dateipfad mit ssh-Schlüssel wird anstelle des Verzeichnisses verwendet.

az aksarc get-logs --kubeconfig ~/.kube/config --ssh-key ~/.ssh/id_rsa --out-dir ./logs

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.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--credentials-dir --ssh-key

Pfad zu SSH-Anmeldeinformationen zum Herstellen einer Verbindung mit Knoten, entweder id_rsa Datei oder Verzeichnis wird akzeptiert.

--ip --ips

IP-Adressen von Knoten (Steuerebenenknoten oder Arbeitsknoten), aus denen Protokolle gesammelt werden müssen.

--kubeconfig

Pfad zur Kubeconfig-Datei, um eine Verbindung mit dem Cluster herzustellen.

--out-dir

Ausgabeverzeichnis zum Speichern gesammelter Protokolle. Wenn nicht angegeben, werden Protokolle im aktuellen Verzeichnis gespeichert.

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 aksarc get-upgrades

Rufen Sie die für den bereitgestellten Cluster verfügbaren Upgradeversionen ab.

az aksarc get-upgrades --name
                       --resource-group
                       [--acquire-policy-token]
                       [--change-reference]

Beispiele

Abrufen der verfügbaren Upgradeversionen für den hybrid bereitgestellten AKS-Cluster

az aksarc get-upgrades --name "samplecluster" --resource-group "sample-rg"

Erforderliche Parameter

--name -n

Name des bereitgestellten Clusters.

--resource-group -g

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

Optionale Parameter

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

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
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 aksarc get-versions

Auflisten der unterstützten Kubernetes-Versionen am angegebenen benutzerdefinierten Speicherort.

az aksarc get-versions --custom-location
                       [--acquire-policy-token]
                       [--change-reference]
                       [--resource-group]

Beispiele

VMListSkus

az aksarc get-versions -g sample-rg --custom-location sample-cl

Erforderliche Parameter

--custom-location

Der Name des benutzerdefinierten Speicherorts, der zum Anzeigen der unterstützten k8s-Versionen verwendet werden soll.

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.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--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 aksarc list

Listet die bereitgestellten Cluster in einer Ressourcengruppe oder in einem Abonnement auf.

az aksarc list [--resource-group]

Beispiele

ListProvisionedClusterByResourceGroup

az aksarc list --resource-group "sample-rg"

ListProvisionedClusterBySubscription

az aksarc list

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.

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

AusgabeHINWEIS-Datei an vom Benutzer angegebene Dateipfad.

az aksarc notice --output-filepath
                 [--acquire-policy-token]
                 [--change-reference]

Beispiele

GetNoticeFile

az aksarc notice --output-filepath "./Notice"

Erforderliche Parameter

--output-filepath

Ausgabedateipfad für DIE NOTICE-Datei.

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.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
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 aksarc show

Ruft den bereitgestellten Cluster ab.

az aksarc show --name
               --resource-group

Beispiele

GetProvisionedCluster

az aksarc show --name "sample-aksarccluster" --resource-group "sample-rg"

Erforderliche Parameter

--name -n

Name des bereitgestellten Clusters.

--resource-group -g

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

Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

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

--verbose

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

Eigenschaft Wert
Standardwert: False

az aksarc undeploy

Zerreißen Sie einen AKS-Baremetalcluster, der zuvor von "az aksarc deploy" erstellt wurde.

Zerreißt einen AKS-Baremetalcluster, der zuvor von "az aksarc deploy" erstellt wurde, entfernt alle zugehörigen Ressourcen. Wenn der Abbruch unvollständig bleibt, führen Sie den Befehl erneut aus, um den Vorgang zu wiederholen.

az aksarc undeploy --arc-machine-name --arc-machine-names --machine-names
                   --resource-group
                   [--acquire-policy-token]
                   [--change-reference]
                   [--yes]

Beispiele

Aufheben der Bereitstellung von AKS Arc-Ressourcen für die angegebenen Arc-Computer

az aksarc undeploy --resource-group sample-rg --arc-machine-names host1 host2 host3

Erforderliche Parameter

--arc-machine-name --arc-machine-names --machine-names -m

Leerzeichentrennte Namen der Arc-Computer, deren AKS Arc-Bereitstellung heruntergerissen werden soll. Ressourcennamen werden automatisch von ihnen abgeleitet.

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

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--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 aksarc update

Aktualisiert den bereitgestellten Cluster.

az aksarc update --name
                 --resource-group
                 [--aad-admin-group-object-ids]
                 [--acquire-policy-token]
                 [--ca-certs --custom-ca-trust-certificates]
                 [--ca-profile --cluster-autoscaler-profile]
                 [--change-reference]
                 [--control-plane-count --control-plane-node-count]
                 [--control-plane-vm-size]
                 [--disable-ahub]
                 [--disable-ai-toolchain-operator --disable-kaito]
                 [--disable-cluster-autoscaler]
                 [--disable-gateway]
                 [--disable-nfs-driver]
                 [--disable-smb-driver]
                 [--enable-ahub]
                 [--enable-ai-toolchain-operator --enable-kaito]
                 [--enable-cluster-autoscaler]
                 [--enable-nfs-driver]
                 [--enable-smb-driver]
                 [--gateway-id]
                 [--max-count]
                 [--min-count]
                 [--tags]
                 [--update-cluster-autoscaler]
                 [--yes]

Beispiele

UpdateProvisionedCluster

az aksarc update --tags additionalProperties="sample" --name "sample-aksarccluster" --resource-group "sample-rg"

Aktivieren Sie Azure Hybridbenutzervorteile-Feature für einen bereitgestellten Cluster.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --enable-ahub

Deaktivieren Sie Azure Hybridbenutzervorteile-Feature für einen bereitgestellten Cluster.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg"--disable-ahub

Knoten der Steuerebene skalieren

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --control-plane-node-count 5

Erforderliche Parameter

--name -n

Name des bereitgestellten Clusters.

--resource-group -g

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

Optionale Parameter

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

--aad-admin-group-object-ids -i

Durch Trennzeichen getrennte Liste von Aad-Gruppenobjekt-IDs, die als Clusteradministrator für den bereitgestellten Cluster festgelegt werden.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--ca-certs --custom-ca-trust-certificates

Pfad zu einer Datei, die benutzerdefinierte Zertifizierungsstellen-Vertrauenszertifikate für das Sicherheitsprofil enthält. Die Datei kann mehrere PEM-Formatzertifikate (bis zu 10) enthalten. Jedes Zertifikat wird base64 codiert und dem Vertrauensspeicher auf allen Knoten hinzugefügt.

--ca-profile --cluster-autoscaler-profile

Durch Leerzeichen getrennte Liste der Schlüssel=Wertpaare zum Konfigurieren der Cluster-Autoskalierung. Übergeben Sie eine leere Zeichenfolge, um das Profil zu löschen.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--control-plane-count --control-plane-node-count

Anzahl der Knoten, auf die die Steuerebene skaliert werden soll.

--control-plane-vm-size

VM-Größe der Steuerungsebene.

--disable-ahub

Deaktivieren Sie Azure Hybridbenutzervorteile (Hybrid User Benefits, AHUB) für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--disable-ai-toolchain-operator --disable-kaito

Deaktivieren Sie den KI-Toolchainoperator für den bereitgestellten Cluster.

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

Deaktivieren Sie die automatische Clusterskalierung für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--disable-gateway

Deaktivieren Sie das Gateway für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--disable-nfs-driver

Deaktivieren Sie den NFS-Treiber für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--disable-smb-driver

Deaktivieren Sie den SMB-Treiber für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--enable-ahub

Aktivieren Sie Azure Hybridbenutzervorteile (Hybrid User Benefits, AHUB) für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--enable-ai-toolchain-operator --enable-kaito

Aktivieren Sie den KI-Toolchainoperator für den bereitgestellten Cluster.

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

Aktivieren Sie die automatische Clusterskalierung für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--enable-nfs-driver

Aktivieren Sie den NFS-Treiber für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--enable-smb-driver

Aktivieren Sie den SMB-Treiber für den bereitgestellten Cluster.

Eigenschaft Wert
Standardwert: False
--gateway-id

Gateway arm ID des bereitgestellten Clusters.

--max-count

Die maximale Anzahl von Knoten für die automatische Skalierung.

--min-count

Die Mindestanzahl der Knoten für die automatische Skalierung.

--tags

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

--update-cluster-autoscaler -u

Aktualisieren Sie die automatische Clusterskala für den bereitgestellten Cluster.

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

Aktualisiert den bereitgestellten Cluster.

az aksarc upgrade --name
                  --resource-group
                  [--acquire-policy-token]
                  [--change-reference]
                  [--kubernetes-version]
                  [--no-wait]
                  [--yes]

Beispiele

UpgradeProvisionedCluster

az aksarc upgrade --name "sample-aksarccluster" --resource-group "sample-rg" --kubernetes-version "1.22.2"

Erforderliche Parameter

--name -n

Name des bereitgestellten Clusters.

--resource-group -g

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

Optionale Parameter

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

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--kubernetes-version -k

Die Kubernetes-Version des bereitgestellten Clusters.

--no-wait

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

Eigenschaft Wert
Standardwert: False
--yes

Kennzeichnen, um Bestätigungsaufforderungen zu deaktivieren.

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