Compartilhar via

Add-AzVirtualNetworkSubnetConfig

Módulo:
Az.Network Module

Adiciona uma configuração de sub-rede a uma rede virtual.

Sintaxe

SetByResource (Default) 

Add-AzVirtualNetworkSubnetConfig
    -Name <String>
    -VirtualNetwork <PSVirtualNetwork>
    [-AddressPrefix <String[]>]
    [-IpamPoolPrefixAllocation <PSIpamPoolPrefixAllocation[]>]
    [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
    [-RouteTable <PSRouteTable>]
    [-InputObject <PSNatGateway>]
    [-ServiceEndpoint <String[]>]
    [-NetworkIdentifier <PSResourceId>]
    [-ServiceEndpointConfig <PSServiceEndpoint[]>]
    [-ServiceEndpointPolicy <PSServiceEndpointPolicy[]>]
    [-Delegation <PSDelegation[]>]
    [-PrivateEndpointNetworkPoliciesFlag <String>]
    [-PrivateLinkServiceNetworkPoliciesFlag <String>]
    [-IpAllocation <PSIpAllocation[]>]
    [-DefaultOutboundAccess <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId 

Add-AzVirtualNetworkSubnetConfig
    -Name <String>
    -VirtualNetwork <PSVirtualNetwork>
    [-AddressPrefix <String[]>]
    [-IpamPoolPrefixAllocation <PSIpamPoolPrefixAllocation[]>]
    [-NetworkSecurityGroupId <String>]
    [-RouteTableId <String>]
    [-ResourceId <String>]
    [-ServiceEndpoint <String[]>]
    [-NetworkIdentifier <PSResourceId>]
    [-ServiceEndpointConfig <PSServiceEndpoint[]>]
    [-ServiceEndpointPolicy <PSServiceEndpointPolicy[]>]
    [-Delegation <PSDelegation[]>]
    [-PrivateEndpointNetworkPoliciesFlag <String>]
    [-PrivateLinkServiceNetworkPoliciesFlag <String>]
    [-IpAllocation <PSIpAllocation[]>]
    [-DefaultOutboundAccess <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet Add-AzVirtualNetworkSubnetConfig adiciona uma configuração de sub-rede a uma rede virtual existente do Azure.

Exemplos

Exemplo 1: Adicionar uma sub-rede a uma rede virtual existente

New-AzResourceGroup -Name TestResourceGroup -Location centralus
    $frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"
    $virtualNetwork = New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet
    Add-AzVirtualNetworkSubnetConfig -Name backendSubnet -VirtualNetwork $virtualNetwork -AddressPrefix "10.0.2.0/24"
    $virtualNetwork | Set-AzVirtualNetwork

Este exemplo primeiro cria um grupo de recursos como um contêiner dos recursos a serem criados. Em seguida, ele cria uma configuração de sub-rede e a usa para criar uma rede virtual. O Add-AzVirtualNetworkSubnetConfig é usado para adicionar uma sub-rede à representação na memória da rede virtual. O comando Set-AzVirtualNetwork atualiza a rede virtual existente com a nova sub-rede.

Exemplo 2: Adicionar uma delegação a uma sub-rede que está sendo adicionada a uma rede virtual existente

$vnet = Get-AzVirtualNetwork -Name "myVNet" -ResourceGroupName "myResourceGroup"
$delegation = New-AzDelegation -Name "myDelegation" -ServiceName "Microsoft.Sql/servers"
Add-AzVirtualNetworkSubnetConfig -Name "mySubnet" -VirtualNetwork $vnet -AddressPrefix "10.0.2.0/24" -Delegation $delegation | Set-AzVirtualNetwork

Este exemplo primeiro obtém uma vnet existente. Em seguida, ele cria um objeto de delegação na memória. Por fim, ele cria uma nova sub-rede com essa delegação que é adicionada à vnet. A configuração modificada é enviada para o servidor.

Parâmetros

-AddressPrefix

Especifica um intervalo de endereços IP para uma configuração de sub-rede.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultOutboundAccess

Conectividade de saída padrão para todas as VMs na sub-rede

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Delegation

Lista de serviços que têm permissão para executar operações nesta sub-rede.

Propriedades do parâmetro

Tipo:

PSDelegation[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-InputObject

Especifica o gateway nat associado à configuração da sub-rede.

Propriedades do parâmetro

Tipo:PSNatGateway
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:NatGateway

Conjuntos de parâmetros

SetByResource
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IpAllocation

Especifica IpAllocations para uma sub-rede.

Propriedades do parâmetro

Tipo:

PSIpAllocation[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IpamPoolPrefixAllocation

IpamPool para alocar automaticamente para prefixos de endereço de sub-rede.

Propriedades do parâmetro

Tipo:

PSIpamPoolPrefixAllocation[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome da configuração de sub-rede a ser adicionada.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NetworkIdentifier

Valor de NetworkIdentifier para ServiceEndpoint

Propriedades do parâmetro

Tipo:PSResourceId
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NetworkSecurityGroup

Especifica um objeto NetworkSecurityGroup . Esse cmdlet adiciona uma configuração de sub-rede de rede virtual ao objeto especificado por esse parâmetro.

Propriedades do parâmetro

Tipo:PSNetworkSecurityGroup
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResource
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NetworkSecurityGroupId

Especifica a ID de um grupo de segurança de rede.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResourceId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PrivateEndpointNetworkPoliciesFlag

Configure para habilitar ou desabilitar a aplicação de políticas de rede no ponto de extremidade privado na sub-rede. O valor padrão está desabilitado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PrivateLinkServiceNetworkPoliciesFlag

Configure para habilitar ou desabilitar a aplicação de políticas de rede no serviço de link privado na sub-rede.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceId

Especifica a ID do recurso de Gateway nat associado à configuração da sub-rede.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:NatGatewayId

Conjuntos de parâmetros

SetByResourceId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RouteTable

O cmdlet Add-AzVirtualNetworkSubnetConfig adiciona uma configuração de sub-rede a uma rede virtual existente do Azure.

Propriedades do parâmetro

Tipo:PSRouteTable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResource
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RouteTableId

O cmdlet Add-AzVirtualNetworkSubnetConfig adiciona uma configuração de sub-rede a uma rede virtual existente do Azure.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResourceId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ServiceEndpoint

Valor do ponto de extremidade de serviço

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ServiceEndpointConfig

Ponto de Extremidade de Serviço com Valor de NetworkIdentifier

Propriedades do parâmetro

Tipo:

PSServiceEndpoint[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ServiceEndpointPolicy

Políticas de ponto de extremidade de serviço

Propriedades do parâmetro

Tipo:

PSServiceEndpointPolicy[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-VirtualNetwork

Especifica o objeto VirtualNetwork no qual adicionar uma configuração de sub-rede.

Propriedades do parâmetro

Tipo:PSVirtualNetwork
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSVirtualNetwork

String

PSNetworkSecurityGroup

PSRouteTable

String

PSServiceEndpointPolicy

PSDelegation

Saídas

PSVirtualNetwork