Compartilhar via

Add-AzApplicationGatewayFrontendIPConfig

Módulo:
Az.Network Module

Adiciona uma configuração de IP front-end a um gateway de aplicativo.

Sintaxe

SetByResourceId 

Add-AzApplicationGatewayFrontendIPConfig
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-PrivateIPAddress <String>]
    [-SubnetId <String>]
    [-PublicIPAddressId <String>]
    [-PrivateLinkConfigurationId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource 

Add-AzApplicationGatewayFrontendIPConfig
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-PrivateIPAddress <String>]
    [-Subnet <PSSubnet>]
    [-PublicIPAddress <PSPublicIpAddress>]
    [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet Add-AzApplicationGatewayFrontendIPConfig adiciona uma configuração de IP de front-end a um gateway de aplicativo. Um gateway de aplicativo dá suporte a dois tipos de configurações de IP front-end:

  • Endereços IP públicos
  • Endereços IP privados usando ILB (balanceamento de carga interno) Um gateway de aplicativo pode ter no máximo um IP público e um IP privado. Adicione o endereço IP público e o endereço IP privado como IPs de front-end separados.

Exemplos

Exemplo 1: Adicionar um IP público como o endereço IP de front-end

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

O primeiro comando cria um objeto de endereço IP público e o armazena na variável $PublicIp. O segundo comando obtém o gateway de aplicativo chamado ApplicationGateway01 que pertence ao grupo de recursos chamado ResourceGroup01 e o armazena na variável $AppGw. O terceiro comando adiciona a configuração de IP front-end chamada FrontEndIp01, para o gateway em $AppGw, usando o endereço armazenado em $PublicIp.

Exemplo 2: adicionar um IP privado estático como o endereço IP de front-end

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1

O primeiro comando obtém uma rede virtual chamada VNet01 que pertence ao grupo de recursos chamado ResourceGroup01 e a armazena na variável $VNet. O segundo comando obtém uma configuração de sub-rede chamada Subnet01 usando $VNet do primeiro comando e o armazena na variável $Subnet. O terceiro comando obtém o gateway de aplicativo chamado ApplicationGateway01 que pertence ao grupo de recursos chamado ResourceGroup01 e o armazena na variável $AppGw. O quarto comando adiciona uma configuração de IP front-end chamada FrontendIP02 usando $Subnet do segundo comando e o endereço IP privado 10.0.1.1.

Exemplo 3: adicionar um IP privado dinâmico como o endereço IP de front-end

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

O primeiro comando obtém uma rede virtual chamada VNet01 que pertence ao grupo de recursos chamado ResourceGroup01 e a armazena na variável $VNet. O segundo comando obtém uma configuração de sub-rede chamada Subnet01 usando $VNet do primeiro comando e o armazena na variável $Subnet. O terceiro comando obtém o gateway de aplicativo chamado ApplicationGateway01 que pertence ao grupo de recursos chamado ResourceGroup01 e o armazena na variável $AppGw. O quarto comando adiciona uma configuração de IP front-end chamada FrontendIP02 usando $Subnet do segundo comando.

Parâmetros

-ApplicationGateway

Especifica o gateway de aplicativo ao qual esse cmdlet adiciona uma configuração de IP de front-end.

Propriedades do parâmetro

Tipo:PSApplicationGateway
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

-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

-Name

Especifica o nome da configuração de IP front-end 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

-PrivateIPAddress

Especifica o endereço IP privado a ser adicionado como um IP de front-end para o gateway de aplicativo. Se especificado, esse IP será alocado estaticamente da 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

-PrivateLinkConfiguration

PrivateLinkConfiguration

Propriedades do parâmetro

Tipo:PSApplicationGatewayPrivateLinkConfiguration
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:False
Valor dos argumentos restantes:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

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:False
Valor dos argumentos restantes:False

-PublicIPAddress

Especifica o endereço IP público que esse cmdlet adiciona como um endereço IP front-end para o gateway de aplicativo.

Propriedades do parâmetro

Tipo:PSPublicIpAddress
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:False
Valor dos argumentos restantes:False

-PublicIPAddressId

Especifica a ID do endereço IP público que esse cmdlet adiciona como um endereço IP de front-end para o gateway de aplicativo.

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:False
Valor dos argumentos restantes:False

-Subnet

Especifica a sub-rede que esse cmdlet adiciona como configuração de IP front-end. Se você especificar esse parâmetro, isso implicará que o gateway de aplicativo dá suporte a uma configuração baseada em IP privado. Se o parâmetro PrivateIPAddress for especificado, ele deverá pertencer a essa sub-rede. Se PrivateIPAddress não for especificado, um dos endereços IP dessa sub-rede será selecionado dinamicamente como o endereço IP de front-end do gateway de aplicativo.

Propriedades do parâmetro

Tipo:PSSubnet
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:False
Valor dos argumentos restantes:False

-SubnetId

Especifica a ID da sub-rede que esse cmdlet adiciona como a configuração de IP front-end. Passar sub-rede implica ip privado. Se o parâmetro PrivateIPAddress for especificado, ele deverá pertencer a essa sub-rede. Caso contrário, um dos IP dessa sub-rede será automaticamente escolhido como o IP de front-end do gateway de aplicativo.

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

PSApplicationGateway

Saídas

PSApplicationGateway