Partilhar via


Add-AzureRmApplicationGatewayFrontendIPConfig

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

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

Add-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureRmApplicationGatewayFrontendIPConfig adiciona uma configuração IP front-end a um gateway de aplicativo. Um gateway de aplicativo suporta 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 front-end separados.

Exemplos

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

PS C:\>$PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Add-AzureRmApplicationGatewayFrontendIPConfig -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 IP front-end chamada FrontEndIp01, para o gateway em $AppGw, usando o endereço armazenado no $PublicIp.

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

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Add-AzureRmApplicationGatewayFrontendIPConfig -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 a 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 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 endereço IP front-end

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Add-AzureRmApplicationGatewayFrontendIPConfig -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 a 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 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 front-end.

Tipo:PSApplicationGateway
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome da configuração IP front-end a ser adicionada.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PrivateIPAddress

Especifica o endereço IP privado a ser adicionado como um IP front-end para o gateway de aplicativo. Se especificado, esse IP é alocado estaticamente a partir da sub-rede.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicIPAddress

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

Tipo:PSPublicIpAddress
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicIPAddressId

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Subnet

Especifica a sub-rede que este cmdlet adiciona como configuração IP front-end. Se você especificar esse parâmetro, isso implica que o gateway de aplicativo oferece suporte a uma configuração privada baseada em IP. 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á coletado dinamicamente como o endereço IP front-end do gateway de aplicativo.

Tipo:PSSubnet
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SubnetId

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSApplicationGateway

Parâmetros: ApplicationGateway (ByValue)

Saídas

PSApplicationGateway