az network nic

  • Referência

Observação

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.

Gerenciar adaptadores de rede.

Para saber mais sobre interfaces de rede no Azure, visite https://learn.microsoft.com/en-us/azure/virtual-network/virtual-network-network-interface?tabs=network-interface-portal.

Comandos

Nome Description Tipo Status
az network nic create

Crie uma interface de rede.

 Núcleo GA
az network nic delete

Exclua uma interface de rede.

 Núcleo GA
az network nic ip-config

Gerenciar configurações IP de uma interface de rede.

 Núcleo GA
az network nic ip-config address-pool

Gerenciar pools de endereços em uma configuração IP.

 Núcleo GA
az network nic ip-config address-pool add

Adicione um pool de endereços a uma configuração de IP.

 Núcleo GA
az network nic ip-config address-pool remove

Remova um pool de endereços de uma configuração IP.

 Núcleo GA
az network nic ip-config create

Crie uma configuração de IP.

 Núcleo GA
az network nic ip-config delete

Exclua uma configuração de IP.

 Núcleo GA
az network nic ip-config inbound-nat-rule

Gerenciar regras NAT de entrada de uma configuração IP.

 Núcleo GA
az network nic ip-config inbound-nat-rule add

Adicione uma regra NAT de entrada a uma configuração de IP.

 Núcleo GA
az network nic ip-config inbound-nat-rule remove

Remova uma regra NAT de entrada de uma configuração de IP.

 Núcleo GA
az network nic ip-config inbound-nat-rule wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Núcleo GA
az network nic ip-config list

Listar as configurações de IP de uma NIC.

 Núcleo GA
az network nic ip-config show

Mostrar os detalhes de uma configuração de IP.

 Núcleo GA
az network nic ip-config update

Atualizar uma configuração de IP.

 Núcleo GA
az network nic ip-config wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Núcleo GA
az network nic list

Listar interfaces de rede.

 Núcleo GA
az network nic list-effective-nsg

Listar todos os grupos de segurança de rede efetivos aplicados a uma interface de rede.

 Núcleo GA
az network nic show

Obtenha os detalhes de uma interface de rede.

 Núcleo GA
az network nic show-effective-route-table

Mostrar a tabela de rotas efetiva aplicada a uma interface de rede.

 Núcleo GA
az network nic update

Atualize uma interface de rede.

 Núcleo GA
az network nic vtap-config

Gerenciar as configurações do TAP de rede virtual.

 Extensão GA
az network nic vtap-config create

Crie uma configuração de toque de rede virtual.

 Extensão GA
az network nic vtap-config delete

Exclua uma configuração de toque de rede virtual.

 Extensão GA
az network nic vtap-config list

Listar configurações de toque de rede virtual.

 Extensão GA
az network nic vtap-config show

Obtenha detalhes de uma configuração de toque de rede virtual.

 Extensão GA
az network nic wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Núcleo GA

az network nic create

Editar

Crie uma interface de rede.

az network nic create --name
                      --resource-group
                      --subnet
                      [--accelerated-networking {0, 1, f, false, n, no, t, true, y, yes}]
                      [--ag-address-pools]
                      [--application-security-groups]
                      [--auxiliary-mode {AcceleratedConnections, Floating, MaxConnections, None}]
                      [--auxiliary-sku {A1, A2, A4, A8, None}]
                      [--dns-servers]
                      [--edge-zone]
                      [--gateway-name]
                      [--internal-dns-name]
                      [--ip-forwarding {0, 1, f, false, n, no, t, true, y, yes}]
                      [--lb-address-pools]
                      [--lb-inbound-nat-rules]
                      [--lb-name]
                      [--location]
                      [--network-security-group]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--private-ip-address]
                      [--private-ip-address-version {IPv4, IPv6}]
                      [--public-ip-address]
                      [--tags]
                      [--vnet-name]

Exemplos

Crie uma interface de rede para uma sub-rede especificada em uma rede virtual especificada.

az network nic create -g MyResourceGroup --vnet-name MyVnet --subnet MySubnet -n MyNic

Crie uma interface de rede para uma sub-rede especificada em uma rede virtual que permita o encaminhamento de IP sujeito a um grupo de segurança de rede.

az network nic create -g MyResourceGroup --vnet-name MyVnet --subnet MySubnet -n MyNic --ip-forwarding --network-security-group MyNsg

Crie uma interface de rede para uma sub-rede especificada em uma rede virtual com grupos de segurança de rede e grupos de segurança de aplicativos.

az network nic create -g MyResourceGroup --vnet-name MyVnet --subnet MySubnet -n MyNic --network-security-group MyNsg --application-security-groups Web App

Parâmetros Exigidos

--name -n

Nome da interface de rede (NIC).

--resource-group -g

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

--subnet

Nome ou ID de uma sub-rede existente. Se o nome for especificado, especifique --vnet-nametambém ; Se você quiser usar uma sub-rede existente em outro grupo de recursos, forneça a ID em vez do nome da sub-rede.

Parâmetros Opcionais

--accelerated-networking

Se deve habilitar a rede acelerada.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--ag-address-pools --app-gateway-address-pools

Lista separada por espaço de nomes ou IDs de pools de endereços de back-end do gateway de aplicativo a serem associados à NIC. Se forem usados nomes, --gateway-name devem ser especificados. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--application-security-groups --asgs

Lista separada por espaço de grupos de segurança de aplicativos. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--auxiliary-mode

Modo auxiliar do recurso de Interface de Rede.

valores aceitos: AcceleratedConnections, Floating, MaxConnections, None
--auxiliary-sku

Sku auxiliar do recurso de Interface de Rede.

valores aceitos: A1, A2, A4, A8, None
--dns-servers

Lista separada por espaço de endereços IP do servidor DNS. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--edge-zone

Nome da zona de borda.

--gateway-name

Nome do gateway de aplicativo.

--internal-dns-name

Nome do rótulo DNS interno.

--ip-forwarding

Se deseja habilitar o encaminhamento de IP.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--lb-address-pools

Lista separada por espaço de nomes ou IDs de pools de endereços do balanceador de carga a serem associados à NIC. Se forem usados nomes, --lb-name devem ser especificados. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--lb-inbound-nat-rules

Lista separada por espaço de nomes ou IDs de regras NAT de entrada do balanceador de carga a serem associadas à NIC. Se forem usados nomes, --lb-name devem ser especificados. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--lb-name

Nome do balanceador de carga.

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--network-security-group

Nome ou ID de um grupo de segurança de rede existente.

--no-wait

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

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--private-ip-address

Endereço IP privado estático a ser usado.

--private-ip-address-version

Versão do endereço IP privado a ser usado.

valores aceitos: IPv4, IPv6
valor padrão: IPv4
--public-ip-address

Nome ou ID de um endereço IP público existente.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--vnet-name

Nome da rede virtual.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az network nic delete

Editar

Exclua uma interface de rede.

az network nic delete [--ids]
                      [--name]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--resource-group]
                      [--subscription]

Exemplos

Exclua uma interface de rede.

az network nic delete -g MyResourceGroup -n MyNic

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome da interface de rede (NIC).

--no-wait

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

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az network nic list

Editar

Listar interfaces de rede.

Para listar interfaces de rede conectadas a VMs em conjuntos de dimensionamento de VM, use az vmss nic list ou az vmss nic list-vm-nics.

az network nic list [--max-items]
                    [--next-token]
                    [--resource-group]

Exemplos

Liste todas as NICs por sufixo DNS interno.

az network nic list --query "[?dnsSettings.internalDomainNameSuffix=`{dnsSuffix}`]"

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor de token de uma resposta truncada anteriormente.

--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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az network nic list-effective-nsg

Editar

Listar todos os grupos de segurança de rede efetivos aplicados a uma interface de rede.

Para saber mais sobre como solucionar problemas usando regras de segurança eficazes, visite https://learn.microsoft.com/en-us/azure/virtual-network/diagnose-network-traffic-filter-problem.

az network nic list-effective-nsg [--ids]
                                  [--name]
                                  [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                  [--resource-group]
                                  [--subscription]

Exemplos

Liste os grupos de segurança efetivos associados a uma NIC.

az network nic list-effective-nsg -g MyResourceGroup -n MyNic

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome da interface de rede (NIC).

--no-wait

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

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az network nic show

Editar

Obtenha os detalhes de uma interface de rede.

az network nic show [--expand]
                    [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]

Exemplos

Obtenha o sufixo de nome de domínio interno de uma NIC.

az network nic show -g MyResourceGroup -n MyNic --query "dnsSettings.internalDomainNameSuffix"

Parâmetros Opcionais

--expand

Expande os recursos referenciados.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome da interface de rede (NIC).

--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az network nic show-effective-route-table

Editar

Mostrar a tabela de rotas efetiva aplicada a uma interface de rede.

Para saber mais sobre como solucionar problemas usando as tabelas de rotas eficazes, visite https://learn.microsoft.com/en-us/azure/virtual-network/diagnose-network-routing-problem#using-effective-routes-to-troubleshoot-vm-traffic-flow.

az network nic show-effective-route-table [--ids]
                                          [--name]
                                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                          [--resource-group]
                                          [--subscription]

Exemplos

Mostrar as rotas efetivas aplicadas a uma interface de rede.

az network nic show-effective-route-table -g MyResourceGroup -n MyNic

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome da interface de rede (NIC).

--no-wait

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

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az network nic update

Editar

Atualize uma interface de rede.

az network nic update [--accelerated-networking {0, 1, f, false, n, no, t, true, y, yes}]
                      [--add]
                      [--auxiliary-mode {AcceleratedConnections, Floating, MaxConnections, None}]
                      [--auxiliary-sku {A1, A2, A4, A8, None}]
                      [--dns-servers]
                      [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                      [--ids]
                      [--internal-dns-name]
                      [--ip-configurations]
                      [--ip-forwarding {0, 1, f, false, n, no, t, true, y, yes}]
                      [--name]
                      [--network-security-group]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--remove]
                      [--resource-group]
                      [--set]
                      [--subscription]

Exemplos

Atualize uma interface de rede para usar um grupo de segurança de rede diferente.

az network nic update -g MyResourceGroup -n MyNic --network-security-group MyNewNsg

Parâmetros Opcionais

--accelerated-networking

Se deve habilitar a rede acelerada.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string ou cadeia de caracteres> JSON.

--auxiliary-mode

Modo auxiliar do recurso de Interface de Rede.

valores aceitos: AcceleratedConnections, Floating, MaxConnections, None
--auxiliary-sku

Sku auxiliar do recurso de Interface de Rede.

valores aceitos: A1, A2, A4, A8, None
--dns-servers

Lista separada por espaço de endereços IP do servidor DNS. Use null para reverter para servidores padrão do Azure. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para JSON.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--internal-dns-name

Nome do rótulo DNS interno.

--ip-configurations

Lista de configurações IP da interface de rede. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--ip-forwarding

Se deseja habilitar o encaminhamento de IP.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--name -n

Nome da interface de rede (NIC).

--network-security-group

Nome ou ID de um grupo de segurança de rede existente.

--no-wait

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

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list OU --remove propertyToRemove.

--resource-group -g

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

--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=.

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az network nic wait

Editar

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az network nic wait [--created]
                    [--custom]
                    [--deleted]
                    [--exists]
                    [--expand]
                    [--ids]
                    [--interval]
                    [--name]
                    [--resource-group]
                    [--subscription]
                    [--timeout]
                    [--updated]

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor padrão: False
--exists

Aguarde até que o recurso exista.

valor padrão: False
--expand

Expande os recursos referenciados.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--name -n

Nome da interface de rede (NIC).

--resource-group -g

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

--subscription

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

--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.