Partilhar via

az aks machine

Note

Este 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

Name Description Tipo Status
az aks machine add

Adicione uma máquina ao pool de nós especificado.

 Extension disponibilidade geral
az aks machine list

Obtenha informações sobre endereços IP, nome do host para todas as máquinas em um pool de agentes.

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

Liste os detalhes de todas as máquinas em um pool de agentes.

 Extension disponibilidade geral
az aks machine show

Mostrar endereços IP, nome do host para uma máquina específica em um agentpool para um managedcluster.

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

Mostrar os detalhes de uma máquina específica em um conjunto de agentes de um cluster gerenciado.

 Extension disponibilidade geral
az aks machine update

Atualize a máquina especificada em um pool de agentes.

 Extension disponibilidade geral

az aks machine add

Adicione uma máquina 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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--disable-fips-image

Mude para usar SO não habilitado para FIPS na máquina.

Propriedade Valor
Default value: False
--enable-fips-image

Mude para usar o sistema operacional habilitado para FIPS na máquina.

Propriedade Valor
Default value: False
--enable-node-public-ip

Habilite o IP público da máquina.

Propriedade Valor
Default value: False
--kubernetes-version

Versão do Kubernetes para usar na criação da máquina, como "1.7.12" ou "1.8.7".

--machine-name

Nome do host da máquina.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--node-public-ip-prefix-id

ID de prefixo IP público usado para atribuir IPs públicos à máquina.

--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 aceites: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual
--os-type

O tipo de sistema operacional da máquina.

--pod-subnet-id

A ID de uma sub-rede em uma VNet existente na qual atribuir pods na máquina (requer plug-in de rede azure).

--priority

A prioridade da máquina.

Propriedade Valor
Valores aceites: Regular, Spot
--tags

As tags da máquina.

--vm-size

O tamanho da máquina.

--vnet-subnet-id

A ID de uma sub-rede em uma VNet existente na qual implantar a máquina.

--zones -z

Lista separada por espaço das zonas de disponibilidade onde uma máquina será colocada.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az aks machine list

Editar

Obtenha informações sobre endereços IP, nome do host para todas as máquinas 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 todas as máquinas em um agentpool

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

Parâmetros Obrigatórios

--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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Liste os detalhes de todas as máquinas em um pool de agentes.

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

Exemplos

Listar os detalhes de todas as máquinas em um agentpool

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

Parâmetros Obrigatórios

--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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az aks machine show

Editar

Mostrar endereços IP, nome do host para uma máquina específica em um agentpool para um managedcluster.

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

Parâmetros Obrigatórios

--cluster-name

Nome do cluster gerenciado.

--machine-name

Nome da máquina 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Mostrar os detalhes de uma máquina específica em um conjunto de agentes de um cluster gerenciado.

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

Exemplos

Mostrar os detalhes de uma máquina específica em um conjunto de agentes de um cluster gerenciado.

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

Parâmetros Obrigatórios

--cluster-name

Nome do cluster gerenciado.

--machine-name

Nome da máquina.

--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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az aks machine update

Atualize a máquina especificada em um pool de agentes.

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

Parâmetros Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--labels

As etiquetas da máquina.

--machine-name

Nome do host da máquina.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--node-taints

As manchas da máquina.

--tags

As tags da máquina.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False