Partager via

az aks machine

Note

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. Apprenez-en davantage sur les extensions.

Obtenez des informations sur les machines dans un pool de nœuds d’un cluster managé.

Commandes

Nom Description Type État
az aks machine add

Ajoutez une machine au pool de nœuds spécifié.

 Extension GA
az aks machine list

Obtenez des informations sur les adresses IP, le nom d’hôte de toutes les machines d’un pool d’agents.

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

Répertoriez les détails de toutes les machines d’un pool d’agents.

 Extension GA
az aks machine show

Afficher les adresses IP, nom d’hôte d’un ordinateur spécifique dans un pool d’agents pour un cluster managé.

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

Affichez les détails d’un ordinateur spécifique dans un pool d’agents d’un cluster managé.

 Extension GA
az aks machine update

Mettez à jour l’ordinateur spécifié dans un pool d’agents.

 Extension GA

az aks machine add

Ajoutez une machine au pool de nœuds spécifié.

az aks machine add --cluster-name
                   --nodepool-name
                   --resource-group
                   [--disable-fips-image]
                   [--enable-fips-image]
                   [--enable-node-public-ip]
                   [--kubernetes-version]
                   [--machine-name]
                   [--no-wait]
                   [--node-public-ip-prefix-id]
                   [--node-public-ip-tags]
                   [--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual}]
                   [--os-type]
                   [--pod-subnet-id]
                   [--priority {Regular, Spot}]
                   [--tags]
                   [--vm-size]
                   [--vnet-subnet-id]
                   [--zones]

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--nodepool-name

Nom du pool d’agents d’un cluster managé.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--disable-fips-image

Basculez pour utiliser le système d’exploitation non compatible FIPS sur l’ordinateur.

Propriété Valeur
Valeur par défaut: False
--enable-fips-image

Basculez pour utiliser le système d’exploitation compatible FIPS sur l’ordinateur.

Propriété Valeur
Valeur par défaut: False
--enable-node-public-ip

Activez l’adresse IP publique de l’ordinateur.

Propriété Valeur
Valeur par défaut: False
--kubernetes-version

Version de Kubernetes à utiliser pour créer la machine, telle que « 1.7.12 » ou « 1.8.7 ».

--machine-name

Nom d’hôte de la machine.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-public-ip-prefix-id

ID de préfixe IP public utilisé pour affecter des adresses IP publiques à la machine.

--node-public-ip-tags

IpTags de l’ordinateur adresses IP publiques.

--os-sku

Référence os-sku du pool de nœuds de l’agent.

Propriété Valeur
Valeurs acceptées: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual
--os-type

Type de système d’exploitation de l’ordinateur.

--pod-subnet-id

ID d’un sous-réseau dans un réseau virtuel existant dans lequel attribuer des pods sur la machine (nécessite un plug-in réseau Azure).

--priority

Priorité de l’ordinateur.

Propriété Valeur
Valeurs acceptées: Regular, Spot
--tags

Balises de l’ordinateur.

--vm-size

Taille de la machine.

--vnet-subnet-id

ID d’un sous-réseau dans un réseau virtuel existant dans lequel déployer l’ordinateur.

--zones -z

Liste séparée par l’espace des zones de disponibilité où une machine sera placée.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks machine list

Modifier

Obtenez des informations sur les adresses IP, le nom d’hôte de toutes les machines d’un pool d’agents.

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

Exemples

Obtenir des informations sur les adresses IP, le nom d’hôte, les zones de disponibilité pour toutes les machines d’un pool d’agents

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

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--nodepool-name

Nom du pool d’agents d’un cluster managé.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks machine list (aks-preview extension)

Répertoriez les détails de toutes les machines d’un pool d’agents.

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

Exemples

Répertorier les détails de toutes les machines d’un pool d’agents

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

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--nodepool-name

Nom du pool d’agents d’un cluster managé.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks machine show

Modifier

Afficher les adresses IP, nom d’hôte d’un ordinateur spécifique dans un pool d’agents pour un cluster managé.

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

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--machine-name

Nom de l’ordinateur dans le pool d’agents d’un cluster managé.

--nodepool-name

Nom du pool d’agents d’un cluster managé.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks machine show (aks-preview extension)

Affichez les détails d’un ordinateur spécifique dans un pool d’agents d’un cluster managé.

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

Exemples

Affichez les détails d’un ordinateur spécifique dans un pool d’agents d’un cluster managé.

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

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--machine-name

Nom de l’ordinateur.

--nodepool-name

Nom du pool d’agents d’un cluster managé.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks machine update

Mettez à jour l’ordinateur spécifié dans un pool d’agents.

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

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--nodepool-name

Nom du pool d’agents d’un cluster managé.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--labels

Étiquettes de l’ordinateur.

--machine-name

Nom d’hôte de la machine.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-taints

Les teintes de la machine.

--tags

Balises de l’ordinateur.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False