Compartir a través de

az network nic

  • Referencia

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administrar interfaces de red.

Para más información sobre las interfaces de red en Azure, visite https://learn.microsoft.com/en-us/azure/virtual-network/virtual-network-network-interface?tabs=network-interface-portal.

Comandos

Nombre Description Tipo Estado
az network nic create

Cree una interfaz de red.

 Core GA
az network nic delete

Elimine una interfaz de red.

 Core GA
az network nic ip-config

Administrar configuraciones IP de una interfaz de red.

 Core GA
az network nic ip-config address-pool

Administrar grupos de direcciones en una configuración de IP.

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

Agregue un grupo de direcciones a una configuración de IP.

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

Quite un grupo de direcciones de una configuración de IP.

 Core GA
az network nic ip-config create

Cree una configuración de IP.

 Core GA
az network nic ip-config delete

Elimine una configuración de IP.

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

Administre las reglas NAT de entrada de una configuración de IP.

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

Agregue una regla NAT de entrada a una configuración de IP.

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

Quite una regla NAT de entrada de una configuración de IP.

 Core GA
az network nic ip-config inbound-nat-rule wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Core GA
az network nic ip-config list

Enumere las configuraciones ip de una NIC.

 Core GA
az network nic ip-config show

Muestra los detalles de una configuración de IP.

 Core GA
az network nic ip-config update

Actualice una configuración de IP.

 Core GA
az network nic ip-config wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Core GA
az network nic list

Enumera las interfaces de red.

 Core GA
az network nic list-effective-nsg

Enumere todos los grupos de seguridad de red efectivos aplicados a una interfaz de red.

 Core GA
az network nic show

Obtenga los detalles de una interfaz de red.

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

Mostrar la tabla de rutas efectiva aplicada a una interfaz de red.

 Core GA
az network nic update

Actualizar una interfaz de red.

 Core GA
az network nic vtap-config

Administrar configuraciones de TAP de red virtual.

 Extensión GA
az network nic vtap-config create

Cree una configuración de pulsación de red virtual.

 Extensión GA
az network nic vtap-config delete

Elimine una configuración de pulsación de red virtual.

 Extensión GA
az network nic vtap-config list

Enumerar las configuraciones de pulsación de red virtual.

 Extensión GA
az network nic vtap-config show

Obtenga detalles de una configuración de pulsación de red virtual.

 Extensión GA
az network nic vtap-config wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Extensión GA
az network nic wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Core GA

az network nic create

Editar

Cree una interfaz de red.

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]

Ejemplos

Cree una interfaz de red para una subred especificada en una red virtual especificada.

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

Cree una interfaz de red para una subred especificada en una red virtual que permita el reenvío IP sujeto a un grupo de seguridad de red.

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

Cree una interfaz de red para una subred especificada en una red virtual con grupos de seguridad de red y grupos de seguridad de aplicaciones.

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

Parámetros requeridos

--name -n

Nombre de la interfaz de red (NIC).

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subnet

Nombre o identificador de una subred existente. Si se especifica el nombre, especifique --vnet-nametambién ; Si desea usar una subred existente en otro grupo de recursos, proporcione el identificador en lugar del nombre de la subred.

Parámetros opcionales

--accelerated-networking

Si se habilitan las redes aceleradas.

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

Lista separada por espacios de nombres o identificadores de grupos de direcciones de back-end de application Gateway que se asociarán a la NIC. Si se usan nombres, --gateway-name debe especificarse. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--application-security-groups --asgs

Lista separada por espacios de grupos de seguridad de aplicaciones. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--auxiliary-mode

Modo auxiliar del recurso de interfaz de red.

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

SKU auxiliar del recurso de interfaz de red.

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

Lista separada por espacios de direcciones IP del servidor DNS. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--edge-zone

Nombre de la zona perimetral.

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--internal-dns-name

Nombre de la etiqueta DNS interna.

--ip-forwarding

Indica si se va a habilitar el reenvío IP.

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

Lista separada por espacios de nombres o identificadores de grupos de direcciones del equilibrador de carga que se van a asociar a la NIC. Si se usan nombres, --lb-name debe especificarse. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--lb-inbound-nat-rules

Lista separada por espacios de nombres o identificadores de reglas NAT de entrada del equilibrador de carga que se van a asociar a la NIC. Si se usan nombres, --lb-name debe especificarse. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--lb-name

Nombre del equilibrador de carga.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--network-security-group

Nombre o identificador de un grupo de seguridad de red existente.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

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

Dirección IP privada estática que se va a usar.

--private-ip-address-version

Versión de la dirección IP privada que se va a usar.

Valores aceptados: IPv4, IPv6
Valor predeterminado: IPv4
--public-ip-address

Nombre o identificador de una dirección IP pública existente.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--vnet-name

Nombre de la red virtual.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network nic delete

Editar

Elimine una interfaz de red.

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

Ejemplos

Elimine una interfaz de red.

az network nic delete -g MyResourceGroup -n MyNic

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la interfaz de red (NIC).

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

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

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network nic list

Editar

Enumera las interfaces de red.

Para enumerar las interfaces de red conectadas a máquinas virtuales en conjuntos de escalado de máquinas virtuales, use az vmss nic list o az vmss nic list-vm-nics.

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

Ejemplos

Enumere todas las NIC por sufijo DNS interno.

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

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network nic list-effective-nsg

Editar

Enumere todos los grupos de seguridad de red efectivos aplicados a una interfaz de red.

Para más información sobre la solución de problemas mediante reglas de seguridad eficaces, 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]

Ejemplos

Enumere los grupos de seguridad efectivos asociados a una NIC.

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la interfaz de red (NIC).

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

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

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network nic show

Editar

Obtenga los detalles de una interfaz de red.

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

Ejemplos

Obtenga el sufijo de nombre de dominio interno de una NIC.

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

Parámetros opcionales

--expand

Expande los recursos a los que se hace referencia.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la interfaz de red (NIC).

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network nic show-effective-route-table

Editar

Mostrar la tabla de rutas efectiva aplicada a una interfaz de red.

Para más información sobre la solución de problemas mediante las tablas de rutas eficaces, 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]

Ejemplos

Mostrar las rutas efectivas aplicadas a una interfaz de red.

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la interfaz de red (NIC).

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

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

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network nic update

Editar

Actualizar una interfaz de red.

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]

Ejemplos

Actualice una interfaz de red para usar un grupo de seguridad de red diferente.

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

Parámetros opcionales

--accelerated-networking

Si se habilitan las redes aceleradas.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

--auxiliary-mode

Modo auxiliar del recurso de interfaz de red.

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

SKU auxiliar del recurso de interfaz de red.

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

Lista separada por espacios de direcciones IP del servidor DNS. Use null para revertir a los servidores de Azure predeterminados. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

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

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--internal-dns-name

Nombre de la etiqueta DNS interna.

--ip-configurations

Lista de configuraciones IP de la interfaz de red. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--ip-forwarding

Indica si se va a habilitar el reenvío IP.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--name -n

Nombre de la interfaz de red (NIC).

--network-security-group

Nombre o identificador de un grupo de seguridad de red existente.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

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

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network nic wait

Editar

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

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

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--expand

Expande los recursos a los que se hace referencia.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--name -n

Nombre de la interfaz de red (NIC).

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.