Partilhar via

az network nic

  • Referência

Nota

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.

Gerencie interfaces 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

Name Description Tipo Status
az network nic create

Crie uma interface de rede.

 Principal GA
az network nic delete

Exclua uma interface de rede.

 Principal GA
az network nic ip-config

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

 Principal GA
az network nic ip-config address-pool

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

 Principal GA
az network nic ip-config address-pool add

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

 Principal GA
az network nic ip-config address-pool remove

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

 Principal GA
az network nic ip-config create

Crie uma configuração de IP.

 Principal GA
az network nic ip-config delete

Exclua uma configuração de IP.

 Principal GA
az network nic ip-config inbound-nat-rule

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

 Principal GA
az network nic ip-config inbound-nat-rule add

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

 Principal GA
az network nic ip-config inbound-nat-rule remove

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

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

 Principal GA
az network nic ip-config list

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

 Principal GA
az network nic ip-config show

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

 Principal GA
az network nic ip-config update

Atualize uma configuração de IP.

 Principal GA
az network nic ip-config wait

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

 Principal GA
az network nic list

Listar interfaces de rede.

 Principal GA
az network nic list-effective-nsg

Liste todos os grupos de segurança de rede eficazes aplicados a uma interface de rede.

 Principal GA
az network nic show

Obtenha os detalhes de uma interface de rede.

 Principal GA
az network nic show-effective-route-table

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

 Principal GA
az network nic update

Atualize uma interface de rede.

 Principal GA
az network nic vtap-config

Gerencie configurações de toque de rede virtual.

 Extensão GA
az network nic vtap-config create

Crie uma rede virtual toque em configuração.

 Extensão GA
az network nic vtap-config delete

Excluir uma rede virtual toque em configuração.

 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 rede virtual toque em configuração.

 Extensão GA
az network nic wait

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

 Principal 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 Obrigatórios

--name -n

Nome da interface de rede (NIC).

--resource-group -g

o 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 o ID em vez do nome da sub-rede.

Parâmetros Opcionais

--accelerated-networking

Se é necessário habilitar a rede acelerada.

Valores aceites: 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 utilizados nomes, --gateway-name devem ser especificados. Suporta sintaxe taquigráfica, 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--auxiliary-mode

Modo auxiliar do recurso Interface de Rede.

Valores aceites: AcceleratedConnections, Floating, MaxConnections, None
--auxiliary-sku

Sku auxiliar do recurso Interface de Rede.

Valores aceites: A1, A2, A4, A8, None
--dns-servers

Lista separada por espaço de endereços IP do servidor DNS. Suporta sintaxe taquigráfica, 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 o encaminhamento de IP deve ser habilitado.

Valores aceites: 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 utilizados nomes, --lb-name devem ser especificados. Suporta sintaxe taquigráfica, 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 utilizados nomes, --lb-name devem ser especificados. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--lb-name

Nome do balanceador de carga.

--location -l

Localização. 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 espere que a operação de longa duração termine.

Valores aceites: 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 aceites: IPv4, IPv6
Default value: 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] ...]. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--vnet-name

Nome da rede virtual.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

--name -n

Nome da interface de rede (NIC).

--no-wait

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

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

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az network nic list

Editar

Listar interfaces de rede.

Para listar interfaces de rede anexadas a VMs em conjuntos de escala 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 por onde começar a paginar. Este é o valor do token de uma resposta truncada anteriormente.

--resource-group -g

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az network nic list-effective-nsg

Editar

Liste todos os grupos de segurança de rede eficazes 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

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

--name -n

Nome da interface de rede (NIC).

--no-wait

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

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

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

--name -n

Nome da interface de rede (NIC).

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

--name -n

Nome da interface de rede (NIC).

--no-wait

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

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

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 é necessário habilitar a rede acelerada.

Valores aceites: 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 valor de chave. Exemplo: --add property.listProperty <key=value, string ou JSON string>.

--auxiliary-mode

Modo auxiliar do recurso Interface de Rede.

Valores aceites: AcceleratedConnections, Floating, MaxConnections, None
--auxiliary-sku

Sku auxiliar do recurso Interface de Rede.

Valores aceites: 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--force-string

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--ip-forwarding

Se o encaminhamento de IP deve ser habilitado.

Valores aceites: 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 espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--remove

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

--resource-group -g

o 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 ser definido. Exemplo: --set property1.property2=.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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é ser criado com 'provisioningState' em 'Succeeded'.

Default value: 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.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--expand

Expande os recursos referenciados.

--ids

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

--interval

Intervalo de sondagem em segundos.

Default value: 30
--name -n

Nome da interface de rede (NIC).

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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