az network vnet subnet

Gerencie sub-redes em uma Rede Virtual do Azure.

Para saber mais sobre sub-redes, visite https://docs.microsoft.com/azure/virtual-network/virtual-network-manage-subnet.

Comandos

Nome	Description	Tipo	Status
az network vnet subnet create	Crie uma sub-rede e associe uma NSG e uma tabela de rotas existentes.	Núcleo	GA
az network vnet subnet delete	Exclua uma sub-rede.	Núcleo	GA
az network vnet subnet list	Liste as sub-redes em uma rede virtual.	Núcleo	GA
az network vnet subnet list-available-delegations	Liste os serviços disponíveis para delegação de sub-rede.	Núcleo	GA
az network vnet subnet list-available-ips	Liste alguns ips disponíveis na sub-rede.	Núcleo	Visualizar
az network vnet subnet show	Mostrar detalhes de uma sub-rede.	Núcleo	GA
az network vnet subnet update	Atualize uma sub-rede.	Núcleo	GA
az network vnet subnet wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Núcleo	GA

az network vnet subnet create

Crie uma sub-rede e associe uma NSG e uma tabela de rotas 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}]

Exemplos

Crie uma nova sub-rede anexada a um NSG com uma tabela de rotas 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

Crie uma nova sub-rede anexada a um gateway 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 Exigidos

--name -n

O nome da sub-rede.

--resource-group -g

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

--vnet-name

O nome da VNet (rede virtual).

Parâmetros Opcionais

--address-prefixes

Lista separada por espaços de prefixos de endereço no formato CIDR. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

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

Defina essa propriedade como false para desabilitar a conectividade de saída padrão para todas as VMs na sub-rede. Essa propriedade só pode ser definida no momento da criação da sub-rede e não pode ser atualizada para uma sub-rede existente.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--delegations

Lista separada por espaço de serviços aos quais a sub-rede deve ser delegada, por exemplo, Microsoft.Sql/servers. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--disable-private-endpoint-network-policies

Desabilite as políticas de rede de ponto de extremidade privado na sub-rede. Observe que ele será substituído em --private-endpoint-network-policies breve.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--disable-private-link-service-network-policies

Desabilite as políticas de rede do serviço de link privado na sub-rede. Observe que ele será substituído em --private-link-service-network-policies breve.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--endpoints

Uma matriz de pontos de extremidade de serviço. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--nat-gateway

Nome ou ID de um gateway NAT a ser anexado.

--network-security-group --nsg

Nome ou ID de um NSG (grupo de segurança de rede).

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

--ple-network-policies --private-endpoint-network-policies

Gerencie políticas de rede para ponto de extremidade privado.

Valores aceitos: Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled

Valor padrão: Disabled

--pls-network-policies --private-link-service-network-policies

Gerencie a política de rede para o serviço de link privado.

Valores aceitos: Disabled, Enabled

Valor padrão: Enabled

--route-table

Nome ou ID de uma tabela de rotas a ser associada à sub-rede.

--service-endpoint-policy

Lista separada por espaços de nomes ou IDs de políticas de ponto de extremidade de serviço a serem aplicadas. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--service-endpoints

A lista de serviços separados por espaço permitia acesso privado a essa sub-rede. Valores de: az network vnet list-endpoint-services. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--sharing-scope

Defina essa propriedade como Locatário para permitir o compartilhamento de sub-rede com outras assinaturas em seu locatário do AAD. Essa propriedade só poderá ser definida se defaultOutboundAccess estiver definida como false, ambas as propriedades só poderão ser definidas se a sub-rede estiver vazia.

Valores aceitos: DelegatedServices, Tenant

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

Exclua uma sub-rede.

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

Exemplos

Exclua uma sub-rede.

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome da sub-rede.

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

--vnet-name

O nome da VNet (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 vnet subnet list

Liste as sub-redes em uma rede virtual.

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

Exemplos

Liste as sub-redes em uma rede virtual.

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

Parâmetros Exigidos

--resource-group -g

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

--vnet-name

O nome da VNet (rede virtual).

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 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. Esse é o valor do token de uma resposta truncada anteriormente.

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

Liste os serviços disponíveis para delegação de sub-rede.

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

Exemplos

Recupere os nomes de serviço para delegações disponíveis na região Oeste dos EUA.

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

Liste os serviços disponíveis para delegação de sub-rede. (gerado automaticamente)

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

Parâmetros Opcionais

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>. Quando não especificado, o local do grupo de recursos será usado.

--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 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. Esse é o valor do 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 vnet subnet list-available-ips

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Liste alguns ips disponíveis na sub-rede.

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

Exemplos

Liste alguns ips disponíveis na sub-rede.

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome da sub-rede.

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

--vnet-name

O nome da VNet (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 vnet subnet show

Mostrar detalhes de uma sub-rede.

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

Exemplos

Mostre os detalhes de uma sub-rede associada a uma rede virtual.

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

Parâmetros Opcionais

--expand

Expande os recursos referenciados. O valor padrão é None.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome da sub-rede.

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

--vnet-name

O nome da VNet (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 vnet subnet update

Atualize uma sub-rede.

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]

Exemplos

Associe um grupo de segurança de rede a uma sub-rede.

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

Atualize a sub-rede com o gateway NAT.

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

Desabilite as políticas de rede de ponto de extremidade privado.

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

Desanexar um grupo de segurança de rede em uma sub-rede.

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

Parâmetros Opcionais

--add

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

--address-prefixes

Lista separada por espaços de prefixos de endereço no formato CIDR. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

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

Defina essa propriedade como false para desabilitar a conectividade de saída padrão para todas as VMs na sub-rede. Essa propriedade só pode ser definida no momento da criação da sub-rede e não pode ser atualizada para uma sub-rede existente.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--delegations

Lista separada por espaço de serviços aos quais a sub-rede deve ser delegada, por exemplo, Microsoft.Sql/servers. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--disable-private-endpoint-network-policies

Desabilite as políticas de rede de ponto de extremidade privado na sub-rede. Observe que ele será substituído em --private-endpoint-network-policies breve.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--disable-private-link-service-network-policies

Desabilite as políticas de rede do serviço de link privado na sub-rede. Observe que ele será substituído em --private-link-service-network-policies breve.

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes

--endpoints

Uma matriz de pontos de extremidade de serviço. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--force-string

Ao usar 'set' ou 'add', preserve os literais de string em vez de tentar converter em 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 uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome da sub-rede.

--nat-gateway

Nome ou ID de um gateway NAT a ser anexado. Use null para desanexá-lo.

--network-security-group --nsg

Nome ou ID de um NSG (grupo de segurança de rede). Use null para desanexá-lo.

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

--ple-network-policies --private-endpoint-network-policies

Gerenciar a política de rede para ponto de extremidade privado.

Valores aceitos: Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled

--pls-network-policies --private-link-service-network-policies

Gerencie a política de rede para o serviço de link privado.

Valores aceitos: Disabled, Enabled

--remove

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

--resource-group -g

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

--route-table

Nome ou ID de uma tabela de rotas a ser associada à sub-rede. Use null para desanexá-lo.

--service-endpoint-policy

Lista separada por espaços de nomes ou IDs de políticas de ponto de extremidade de serviço a serem aplicadas. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--service-endpoints

A lista de serviços separados por espaço permitia acesso privado a essa sub-rede. Valores de: az network vnet list-endpoint-services. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--set

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

--sharing-scope

Defina essa propriedade como Locatário para permitir o compartilhamento de sub-rede com outras assinaturas em seu locatário do AAD. Essa propriedade só poderá ser definida se defaultOutboundAccess estiver definida como false, ambas as propriedades só poderão ser definidas se a sub-rede estiver vazia.

Valores aceitos: DelegatedServices, Tenant

--subscription

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

--vnet-name

O nome da VNet (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 vnet subnet wait

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

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

Parâmetros Opcionais

--created

Aguarde até ser criado 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. O valor padrão é None.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30

--name -n

O nome da sub-rede.

--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é ser atualizado com provisioningState em 'Succeeded'.

Valor padrão: False

--vnet-name

O nome da VNet (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.