Partilhar via


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

Name Description Tipo Status
az network vnet subnet create

Crie uma sub-rede e associe um NSG e uma tabela de rotas existentes.

Principal GA
az network vnet subnet delete

Exclua uma sub-rede.

Principal GA
az network vnet subnet list

Liste as sub-redes em uma rede virtual.

Principal GA
az network vnet subnet list-available-delegations

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

Principal GA
az network vnet subnet list-available-ips

Liste alguns ips disponíveis na sub-rede.

Principal Pré-visualizar
az network vnet subnet show

Mostrar detalhes de uma sub-rede.

Principal GA
az network vnet subnet update

Atualize uma sub-rede.

Principal GA
az network vnet subnet wait

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

Principal GA

az network vnet subnet create

Crie uma sub-rede e associe um 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 Obrigatórios

--name -n

O nome da sub-rede.

--resource-group -g

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

--disable-private-endpoint-network-policies

Desative as políticas 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 aceites: 0, 1, f, false, n, no, t, true, y, yes
--disable-private-link-service-network-policies

Desative as políticas 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 aceites: 0, 1, f, false, n, no, t, true, y, yes
--endpoints

Uma matriz de pontos de extremidade de serviço. Suporta sintaxe taquigráfica, 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 grupo de segurança de rede (NSG).

--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ple-network-policies --private-endpoint-network-policies

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

Valores aceites: Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled
Default value: Disabled
--pls-network-policies --private-link-service-network-policies

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

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

--service-endpoints

Lista de serviços separados por espaço permitiu acesso privado a esta sub-rede. Valores de: az network vnet list-endpoint-services. Suporta sintaxe taquigráfica, 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. Esta propriedade só pode ser definida se defaultOutboundAccess estiver definido como false, ambas as propriedades só podem ser definidas se a sub-rede estiver vazia.

Valores aceites: DelegatedServices, Tenant
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

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

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

--name -n

O nome da sub-rede.

--no-wait

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

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

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

--subscription

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

--vnet-name

O nome da rede virtual (VNet).

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az network 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 Obrigatórios

--resource-group -g

o 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 por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

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

Localização. 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 por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az network vnet subnet list-available-ips

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

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

--name -n

O nome da sub-rede.

--resource-group -g

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

--subscription

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

--vnet-name

O nome da rede virtual (VNet).

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

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

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

--name -n

O nome da sub-rede.

--resource-group -g

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

--subscription

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

--vnet-name

O nome da rede virtual (VNet).

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az network 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"

Desative 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

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

--address-prefixes

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

--disable-private-endpoint-network-policies

Desative as políticas 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 aceites: 0, 1, f, false, n, no, t, true, y, yes
--disable-private-link-service-network-policies

Desative as políticas 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 aceites: 0, 1, f, false, n, no, t, true, y, yes
--endpoints

Uma matriz de pontos de extremidade de serviço. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--force-string

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

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

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

--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 grupo de segurança de rede (NSG). Use null para desanexá-lo.

--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ple-network-policies --private-endpoint-network-policies

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

Valores aceites: 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 aceites: Disabled, Enabled
--remove

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

--resource-group -g

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

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

--service-endpoints

Lista de serviços separados por espaço permitiu acesso privado a esta sub-rede. Valores de: az network vnet list-endpoint-services. Suporta sintaxe taquigráfica, 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. Esta propriedade só pode ser definida se defaultOutboundAccess estiver definido como false, ambas as propriedades só podem ser definidas se a sub-rede estiver vazia.

Valores aceites: DelegatedServices, Tenant
--subscription

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

--vnet-name

O nome da rede virtual (VNet).

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az network 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'.

Default value: False
--custom

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

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--expand

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

--ids

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

--interval

Intervalo de sondagem em segundos.

Default value: 30
--name -n

O nome da sub-rede.

--resource-group -g

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

--subscription

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

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: False
--vnet-name

O nome da rede virtual (VNet).

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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