az network vnet subnet

Gerenciar 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	Excluir uma sub-rede.	Núcleo	GA
az network vnet subnet list	Listar 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	Atualizar 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}]
                              [--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]

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 conectada 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 rede virtual (VNet).

Parâmetros Opcionais

--address-prefixes

Lista separada por espaço de prefixos de endereço no formato CIDR. Suporte taquigráfico-sintaxe, 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 taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--disable-private-endpoint-network-policies

Desative as diretivas de rede de ponto de extremidade privado na sub-rede. Por favor, note que ele será substituído por --private-endpoint-network-policies em breve.

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

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

Desative as diretivas de rede do serviço de link privado na sub-rede. Por favor, note que ele será substituído por --private-link-service-network-policies em breve.

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

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

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

Gerenciar 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ço de nomes ou IDs de políticas de ponto de extremidade de serviço a serem aplicadas. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--service-endpoints

Lista separada por espaço de serviços permitiu acesso privado a esta sub-rede. Valores de: az network vnet list-endpoint-services. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

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

Excluir 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

Excluir 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

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 rede virtual (VNet).

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

Listar as sub-redes em uma rede virtual.

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

Exemplos

Listar 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 rede virtual (VNet).

Parâmetros Opcionais

--max-items

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

--next-token

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

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 das 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 do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

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

--resource-group -g

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az network vnet subnet list-available-ips

Versão Prévia

Este comando está em pré-visualização 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

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 rede virtual (VNet).

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

Mostrar 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 é Nenhum.

--ids

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

--name -n

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 rede virtual (VNet).

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

Atualizar 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}]
                              [--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]
                              [--subscription]
                              [--vnet-name]

Exemplos

Associar 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

Atualizar sub-rede com gateway NAT.

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

Desative as diretivas de rede de ponto de extremidade privado.

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

Desanexe 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 caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string ou string> JSON.

--address-prefixes

Lista separada por espaço de prefixos de endereço no formato CIDR. Suporte taquigráfico-sintaxe, 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 taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--disable-private-endpoint-network-policies

Desative as diretivas de rede de ponto de extremidade privado na sub-rede. Por favor, note que ele será substituído por --private-endpoint-network-policies em breve.

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

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

Desative as diretivas de rede do serviço de link privado na sub-rede. Por favor, note que ele será substituído por --private-link-service-network-policies em breve.

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

--force-string

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

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

--ids

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

--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 diretiva de rede para ponto de extremidade privado.

valores aceitos: Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled

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

Gerenciar 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 OU --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ço de nomes ou IDs de políticas de ponto de extremidade de serviço a serem aplicadas. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--service-endpoints

Lista separada por espaço de serviços permitiu acesso privado a esta sub-rede. Valores de: az network vnet list-endpoint-services. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--set

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

--subscription

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

--vnet-name

O nome da rede virtual (VNet).

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

valor padrão: False

--custom

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

--deleted

Aguarde até ser excluído.

valor padrão: False

--exists

Aguarde até que o recurso exista.

valor padrão: False

--expand

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

--ids

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

--interval

Intervalo de sondagem em segundos.

valor padrão: 30

--name -n

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

valor padrão: False

--vnet-name

O nome da rede virtual (VNet).

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.