Compartilhar via

az aks machine

Note

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Obtenha informações sobre máquinas em um pool de nós de clusters gerenciados.

Comandos

Nome Description Tipo Status
az aks machine add

Adicione um computador ao pool de nós especificado.

 Extension GA
az aks machine list

Obtenha informações sobre endereços IP, nome do host para todos os computadores em um pool de agentes.

 Core GA
az aks machine list (aks-preview extensão)

Liste os detalhes de todos os computadores em um agentpool.

 Extension GA
az aks machine show

Mostrar endereços IP, nome do host para um computador específico em um pool de agentes para um cluster gerenciado.

 Core GA
az aks machine show (aks-preview extensão)

Mostrar os detalhes de um computador específico em um agentpool de um managedcluster.

 Extension GA
az aks machine update

Atualize o computador especificado em um agentpool.

 Extension GA

az aks machine add

Adicione um computador ao pool de nós especificado.

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]

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--nodepool-name

Nome do agentpool de um cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--disable-fips-image

Alterne para usar o sistema operacional não habilitado para FIPS no computador.

Propriedade Valor
Valor padrão: False
--enable-fips-image

Alterne para usar o sistema operacional habilitado para FIPS no computador.

Propriedade Valor
Valor padrão: False
--enable-node-public-ip

Habilite o IP público do computador.

Propriedade Valor
Valor padrão: False
--kubernetes-version

Versão do Kubernetes a ser usada para criar o computador, como "1.7.12" ou "1.8.7".

--machine-name

Nome do host da máquina.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--node-public-ip-prefix-id

ID do prefixo IP público usada para atribuir IPs públicos ao computador.

--node-public-ip-tags

Os ipTags dos IPs públicos da máquina.

--os-sku

O os-sku do pool de nós do agente.

Propriedade Valor
Valores aceitos: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual
--os-type

O tipo de sistema operacional do computador.

--pod-subnet-id

A ID de uma sub-rede em uma VNet existente na qual atribuir pods no computador (requer plug-in de rede do azure).

--priority

A prioridade do computador.

Propriedade Valor
Valores aceitos: Regular, Spot
--tags

As marcas do computador.

--vm-size

O tamanho do computador.

--vnet-subnet-id

A ID de uma sub-rede em uma VNet existente na qual implantar o computador.

--zones -z

Lista separada por espaço de zonas de disponibilidade em que um computador será colocado.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks machine list

Editar

Obtenha informações sobre endereços IP, nome do host para todos os computadores em um pool de agentes.

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

Exemplos

Obter informações sobre endereços IP, nome do host, zonas de disponibilidade para todos os computadores em um agentpool

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--nodepool-name

Nome do agentpool de um cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks machine list (aks-preview extensão)

Liste os detalhes de todos os computadores em um agentpool.

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

Exemplos

Listar os detalhes de todos os computadores em um agentpool

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--nodepool-name

Nome do agentpool de um cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks machine show

Editar

Mostrar endereços IP, nome do host para um computador específico em um pool de agentes para um cluster gerenciado.

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--machine-name

Nome do computador no agentpool de um cluster gerenciado.

--nodepool-name

Nome do agentpool de um cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks machine show (aks-preview extensão)

Mostrar os detalhes de um computador específico em um agentpool de um managedcluster.

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

Exemplos

Mostrar os detalhes de um computador específico em um agentpool de um managedcluster.

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--machine-name

Nome do computador.

--nodepool-name

Nome do agentpool de um cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks machine update

Atualize o computador especificado em um agentpool.

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--nodepool-name

Nome do agentpool de um cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--labels

Os rótulos do computador.

--machine-name

Nome do host da máquina.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--node-taints

As manchas da máquina.

--tags

As marcas do computador.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False