az network vnet subnet

Administrar subredes en una instancia de Azure Virtual Network.

Para más información sobre las subredes, visite https://docs.microsoft.com/azure/virtual-network/virtual-network-manage-subnet.

Comandos

Nombre Description Tipo Estado
az network vnet subnet create

Cree una subred y asocie un grupo de seguridad de red y una tabla de rutas existentes.

Core GA
az network vnet subnet delete

Elimine una subred.

Core GA
az network vnet subnet list

Enumere las subredes de una red virtual.

Core GA
az network vnet subnet list-available-delegations

Enumere los servicios disponibles para la delegación de subred.

Core GA
az network vnet subnet list-available-ips

Enumere algunas ips disponibles en la subred.

Core Vista previa
az network vnet subnet show

Mostrar detalles de una subred.

Core GA
az network vnet subnet update

Actualice una subred.

Core GA
az network vnet subnet wait

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

Core GA

az network vnet subnet create

Cree una subred y asocie un grupo de seguridad de red y una tabla de rutas existentes.

az network vnet subnet create --name
                              --resource-group
                              --vnet-name
                              [--address-prefixes]
                              [--default-outbound {0, 1, f, false, n, no, t, true, y, yes}]
                              [--delegations]
                              [--disable-private-endpoint-network-policies {0, 1, f, false, n, no, t, true, y, yes}]
                              [--disable-private-link-service-network-policies {0, 1, f, false, n, no, t, true, y, yes}]
                              [--endpoints]
                              [--nat-gateway]
                              [--network-security-group]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--ple-network-policies {Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled}]
                              [--pls-network-policies {Disabled, Enabled}]
                              [--route-table]
                              [--service-endpoint-policy]
                              [--service-endpoints]
                              [--sharing-scope {DelegatedServices, Tenant}]

Ejemplos

Cree una nueva subred asociada a un grupo de seguridad de red con una tabla de rutas personalizada.

az network vnet subnet create -g MyResourceGroup --vnet-name MyVnet -n MySubnet --address-prefixes 10.0.0.0/24 --network-security-group MyNsg --route-table MyRouteTable

Cree una nueva subred conectada a una puerta de enlace NAT.

az network vnet subnet create -n MySubnet --vnet-name MyVnet -g MyResourceGroup --nat-gateway MyNatGateway --address-prefixes "10.0.0.0/21"

Parámetros requeridos

--name -n

Nombre de la subred.

--resource-group -g

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

--vnet-name

Nombre de la red virtual (VNet).

Parámetros opcionales

--address-prefixes

Lista separada por espacios de prefijos de dirección en formato CIDR. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--default-outbound --default-outbound-access

Establezca esta propiedad en false para deshabilitar la conectividad de salida predeterminada para todas las máquinas virtuales de la subred. Esta propiedad solo se puede establecer en el momento de la creación de la subred y no se puede actualizar para una subred existente.

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

Lista separada por espacios de servicios a los que se debe delegar la subred, por ejemplo, Microsoft.Sql/servers. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--disable-private-endpoint-network-policies

Deshabilite las directivas de red de punto de conexión privado en la subred. Tenga en cuenta que pronto se reemplazará --private-endpoint-network-policies .

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--disable-private-link-service-network-policies

Deshabilite las directivas de red del servicio private link en la subred. Tenga en cuenta que pronto se reemplazará --private-link-service-network-policies .

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

Matriz de puntos de conexión de servicio. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--nat-gateway

Nombre o identificador de una puerta de enlace NAT que se va a adjuntar.

--network-security-group --nsg

Nombre o identificador de un grupo de seguridad de red (NSG).

--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
--ple-network-policies --private-endpoint-network-policies

Administrar directivas de red para el punto de conexión privado.

Valores aceptados: Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled
Valor predeterminado: Disabled
--pls-network-policies --private-link-service-network-policies

Administrar la directiva de red para el servicio private link.

Valores aceptados: Disabled, Enabled
Valor predeterminado: Enabled
--route-table

Nombre o identificador de una tabla de rutas que se va a asociar a la subred.

--service-endpoint-policy

Lista separada por espacios de nombres o identificadores de directivas de punto de conexión de servicio que se van a aplicar. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--service-endpoints

Lista separada por espacios de servicios permitidos para el acceso privado a esta subred. Valores de: az network vnet list-endpoint-services. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--sharing-scope

Establezca esta propiedad en Tenant para permitir el uso compartido de subredes con otras suscripciones en el inquilino de AAD. Esta propiedad solo se puede establecer si defaultOutboundAccess está establecida en false, ambas propiedades solo se pueden establecer si la subred está vacía.

Valores aceptados: DelegatedServices, Tenant
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 vnet subnet delete

Elimine una subred.

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

Ejemplos

Elimine una subred.

az network vnet subnet delete --name MySubnet --resource-group MyResourceGroup --vnet-name MyVnet

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

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

--vnet-name

Nombre de la red virtual (VNet).

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 vnet subnet list

Enumere las subredes de una red virtual.

az network vnet subnet list --resource-group
                            --vnet-name
                            [--max-items]
                            [--next-token]

Ejemplos

Enumere las subredes de una red virtual.

az network vnet subnet list -g MyResourceGroup --vnet-name MyVNet

Parámetros requeridos

--resource-group -g

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

--vnet-name

Nombre de la red virtual (VNet).

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.

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 vnet subnet list-available-delegations

Enumere los servicios disponibles para la delegación de subred.

az network vnet subnet list-available-delegations [--location]
                                                  [--max-items]
                                                  [--next-token]
                                                  [--resource-group]

Ejemplos

Recupere los nombres de servicio de las delegaciones disponibles en la región Oeste de EE. UU.

az network vnet subnet list-available-delegations -l westus --query [].serviceName

Enumere los servicios disponibles para la delegación de subred. (generado automáticamente)

az network vnet subnet list-available-delegations --resource-group MyResourceGroup

Parámetros opcionales

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>. Cuando no se especifique, se usará la ubicación del grupo de recursos.

--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 vnet subnet list-available-ips

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere algunas ips disponibles en la subred.

az network vnet subnet list-available-ips [--ids]
                                          [--name]
                                          [--resource-group]
                                          [--subscription]
                                          [--vnet-name]

Ejemplos

Enumere algunas ips disponibles en la subred.

az network vnet subnet list-available-ips --resource-group MyResourceGroup --vnet-name MyVNet -n MySubnet

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

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

--vnet-name

Nombre de la red virtual (VNet).

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 vnet subnet show

Mostrar detalles de una subred.

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

Ejemplos

Muestra los detalles de una subred asociada a una red virtual.

az network vnet subnet show -g MyResourceGroup -n MySubnet --vnet-name MyVNet

Parámetros opcionales

--expand

Expande los recursos a los que se hace referencia. El valor predeterminado es None.

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

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

--vnet-name

Nombre de la red virtual (VNet).

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 vnet subnet update

Actualice una subred.

az network vnet subnet update [--add]
                              [--address-prefixes]
                              [--default-outbound {0, 1, f, false, n, no, t, true, y, yes}]
                              [--delegations]
                              [--disable-private-endpoint-network-policies {0, 1, f, false, n, no, t, true, y, yes}]
                              [--disable-private-link-service-network-policies {0, 1, f, false, n, no, t, true, y, yes}]
                              [--endpoints]
                              [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                              [--ids]
                              [--name]
                              [--nat-gateway]
                              [--network-security-group]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--ple-network-policies {Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled}]
                              [--pls-network-policies {Disabled, Enabled}]
                              [--remove]
                              [--resource-group]
                              [--route-table]
                              [--service-endpoint-policy]
                              [--service-endpoints]
                              [--set]
                              [--sharing-scope {DelegatedServices, Tenant}]
                              [--subscription]
                              [--vnet-name]

Ejemplos

Asocie un grupo de seguridad de red a una subred.

az network vnet subnet update -g MyResourceGroup -n MySubnet --vnet-name MyVNet --network-security-group MyNsg

Actualice la subred con la puerta de enlace NAT.

az network vnet subnet update -n MySubnet --vnet-name MyVnet -g MyResourceGroup --nat-gateway MyNatGateway --address-prefixes "10.0.0.0/21"

Deshabilite las directivas de red del punto de conexión privado.

az network vnet subnet update -n MySubnet --vnet-name MyVnet -g MyResourceGroup --private-endpoint-network-policies Disabled

Desasocie un grupo de seguridad de red en una subred.

az network vnet subnet update -g MyResourceGroup --vnet-name MyVNet -n MySubnet --nsg null

Parámetros opcionales

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

--address-prefixes

Lista separada por espacios de prefijos de dirección en formato CIDR. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--default-outbound --default-outbound-access

Establezca esta propiedad en false para deshabilitar la conectividad de salida predeterminada para todas las máquinas virtuales de la subred. Esta propiedad solo se puede establecer en el momento de la creación de la subred y no se puede actualizar para una subred existente.

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

Lista separada por espacios de servicios a los que se debe delegar la subred, por ejemplo, Microsoft.Sql/servers. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--disable-private-endpoint-network-policies

Deshabilite las directivas de red de punto de conexión privado en la subred. Tenga en cuenta que pronto se reemplazará --private-endpoint-network-policies .

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--disable-private-link-service-network-policies

Deshabilite las directivas de red del servicio private link en la subred. Tenga en cuenta que pronto se reemplazará --private-link-service-network-policies .

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

Matriz de puntos de conexión de servicio. 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".

--name -n

Nombre de la subred.

--nat-gateway

Nombre o identificador de una puerta de enlace NAT que se va a adjuntar. Use null para desasociarlo.

--network-security-group --nsg

Nombre o identificador de un grupo de seguridad de red (NSG). Use null para desasociarlo.

--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
--ple-network-policies --private-endpoint-network-policies

Administrar la directiva de red para el punto de conexión privado.

Valores aceptados: Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled
--pls-network-policies --private-link-service-network-policies

Administrar la directiva de red para el servicio private link.

Valores aceptados: Disabled, Enabled
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--route-table

Nombre o identificador de una tabla de rutas que se va a asociar a la subred. Use null para desasociarlo.

--service-endpoint-policy

Lista separada por espacios de nombres o identificadores de directivas de punto de conexión de servicio que se van a aplicar. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--service-endpoints

Lista separada por espacios de servicios permitidos para el acceso privado a esta subred. Valores de: az network vnet list-endpoint-services. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--set

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

--sharing-scope

Establezca esta propiedad en Tenant para permitir el uso compartido de subredes con otras suscripciones en el inquilino de AAD. Esta propiedad solo se puede establecer si defaultOutboundAccess está establecida en false, ambas propiedades solo se pueden establecer si la subred está vacía.

Valores aceptados: DelegatedServices, Tenant
--subscription

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

--vnet-name

Nombre de la red virtual (VNet).

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 vnet subnet wait

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

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

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. El valor predeterminado es None.

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

--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
--vnet-name

Nombre de la red virtual (VNet).

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.