Compartilhar via

New-AzureRmApplicationGatewayFrontendIPConfig

  • Referência
Módulo:
AzureRM.Network

Cria uma configuração de IP de front-end para um gateway de aplicativo.

Aviso

O módulo PowerShell do AzureRM 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 do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet New-AzureRmApplicationGatewayFrontendIPConfig cria uma configuração de IP de front-end para um gateway de aplicativo do Azure. Um gateway de aplicativo dá suporte a dois tipos de configuração 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 endereço IP público e um endereço IP privado. O endereço IP público e o endereço IP privado devem ser adicionados separadamente como endereços IP front-end.

Exemplos

Exemplo 1: Criar uma configuração de IP de front-end usando um objeto de recurso de IP público

PS C:\>$PublicIP = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIP01" -location "West US" -AllocationMethod Dynamic
PS C:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndIP01" -PublicIPAddress $PublicIP

O primeiro comando cria um objeto de recurso IP público e o armazena na variável $PublicIP. O segundo comando usa $PublicIP para criar uma nova configuração de IP de front-end chamada FrontEndIP01 e a armazena na variável $FrontEnd.

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

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -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 cria uma configuração de IP de front-end chamada FrontEndIP02 usando $Subnet do segundo comando e o endereço IP privado 10.0.1.1 e, em seguida, armazena-a na variável $FrontEnd.

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

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontendIP03" -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 cria uma configuração de IP de front-end chamada FrontEndIP03 usando $Subnet do segundo comando e a armazena na variável $FrontEnd.

Parâmetros

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome da configuração de IP de front-end que esse cmdlet cria.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrivateIPAddress

Especifica o endereço IP privado que esse cmdlet associa ao endereço IP de front-end do gateway de aplicativo. Isso só poderá ser especificado se uma sub-rede for especificada. Esse IP é alocado estaticamente da sub-rede.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublicIPAddress

Especifica o objeto de endereço IP público que esse cmdlet associa ao endereço IP de front-end do gateway de aplicativo.

Tipo:PSPublicIpAddress
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublicIPAddressId

Especifica a ID do endereço IP público que esse cmdlet associa ao IP front-end do gateway de aplicativo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Subnet

Especifica o objeto de sub-rede que esse cmdlet associa ao endereço IP de front-end do gateway de aplicativo. Se você especificar esse parâmetro, isso implicará que o gateway usa um endereço IP privado. Se o parâmetro PrivateIPAddresss for especificado, ele deverá pertencer à sub-rede especificada por esse parâmetro. Se PrivateIPAddress não for especificado, um dos endereços IP dessa sub-rede será selecionado dinamicamente como o endereço IP front-end do gateway de aplicativo.

Tipo:PSSubnet
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubnetId

Especifica a ID da sub-rede que esse cmdlet associa à configuração de IP de front-end do gateway de aplicativo. Se você especificar o parâmetro Subnet , isso implicará que o gateway usa um endereço IP privado. Se o parâmetro PrivateIPAddress for especificado, ele deverá pertencer à sub-rede especificada por Subnet. Se PrivateIPAddress não for especificado, um dos endereços IP dessa sub-rede será selecionado dinamicamente como o endereço IP front-end do gateway de aplicativo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

PSApplicationGatewayFrontendIPConfiguration