< Back
New-AzureRmApplicationGatewayFrontendIPConfig
Post
NAME New-AzureRmApplicationGatewayFrontendIPConfig
SYNOPSIS
Creates a front-end IP configuration for an application gateway.
SYNTAX
New-AzureRmApplicationGatewayFrontendIPConfig [-DefaultProfile <IAzureContextContainer>] -Name <String> [-PrivateIPAddress <String>]
[-PublicIPAddress <PSPublicIpAddress>] [-Subnet <PSSubnet>] [<CommonParameters>]
New-AzureRmApplicationGatewayFrontendIPConfig [-DefaultProfile <IAzureContextContainer>] -Name <String> [-PrivateIPAddress <String>]
[-PublicIPAddressId <String>] [-SubnetId <String>] [<CommonParameters>]
DESCRIPTION
The New-AzureRmApplicationGatewayFrontendIPConfig cmdlet creates a front-end IP configuraton for an Azure application gateway. An application
gateway supports two types of front-end IP configuration:
- Public IP addresses -- Private IP addresses using internal load balancing (ILB).
An application gateway can have at most one public IP address and one private IP address. The public IP address and private IP address should be
added separately as front-end IP addresses.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies the name of the front-end IP configuration that this cmdlet creates.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PrivateIPAddress <String>
Specifies the private IP address which this cmdlet associates with the front-end IP address of the application gateway. This can be specified
only if a subnet is specified. This IP is statically allocated from the subnet.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PublicIPAddress <PSPublicIpAddress>
Specifies the public IP address object which this cmdlet associates with the front-end IP address of the application gateway.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PublicIPAddressId <String>
Specifies the public IP address ID which this cmdlet associates with the front-end IP of the application gateway.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Subnet <PSSubnet>
Specifies the subnet object which this cmdlet associates with the front-end IP address of the application gateway. If you specify this
parameter, it implies that the gateway uses a private IP address. If the PrivateIPAddresss parameter is specified, it should belong to the
subnet specified by this parameter. If PrivateIPAddress is not specified, one of the IP addresses from this subnet is dynamically picked up as
the front-end IP address of the application gateway.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-SubnetId <String>
Specifies the subnet ID which this cmdlet associates with the front-end IP configuration of the application gateway. If you specify the Subnet
parameter, it implies that the gateway uses a private IP address. If the PrivateIPAddress parameter is specified, it should belong to the
subnet specified by Subnet . If PrivateIPAddress is not specified, one of the IP addresses from this subnet is dynamically picked up as the
front-end IP address of the application gateway.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String
OUTPUTS
Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration
NOTES
Example 1: Create a front-end IP configuration using a public IP resource object
PS C:\\>$PublicIP = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIP01" -location "West US" -AllocationMethod Dynamic
PS C:\\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndIP01" -PublicIPAddress $PublicIP
The first command creates a public IP resource object and stores it in the $PublicIP variable. The second command uses $PublicIP to create a new
front-end IP configuration named FrontEndIP01 and stores it in the $FrontEnd variable.
Example 2: Create a static private IP as the front-end IP address
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
The first command gets a virtual network named VNet01 that belongs to the resource group named ResourceGroup01, and stores it in the $VNet
variable. The second command gets a subnet configuration named Subnet01 using $VNet from the first command and stores it in the $Subnet variable.
The third command creates a front-end IP configuration named FrontEndIP02 using $Subnet from the second command and the private IP address
10.0.1.1, and then stores it in the $FrontEnd variable.
Example 3: Create a dynamic private IP as the front-end IP address
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
The first command gets a virtual network named VNet01 that belongs to the resource group named ResourceGroup01, and stores it in the $VNet
variable. The second command gets a subnet configuration named Subnet01 using $VNet from the first command and stores it in the $Subnet variable.
The third command creates a front-end IP configuration named FrontEndIP03 using $Subnet from the second command, and stores it in the $FrontEnd
variable.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... ndipconfig
Add-AzureRmApplicationGatewayFrontendIPConfig
Get-AzureRmApplicationGatewayFrontendIPConfig
Remove-AzureRmApplicationGatewayFrontendIPConfig
Set-AzureRmApplicationGatewayFrontendIPConfig
SYNOPSIS
Creates a front-end IP configuration for an application gateway.
SYNTAX
New-AzureRmApplicationGatewayFrontendIPConfig [-DefaultProfile <IAzureContextContainer>] -Name <String> [-PrivateIPAddress <String>]
[-PublicIPAddress <PSPublicIpAddress>] [-Subnet <PSSubnet>] [<CommonParameters>]
New-AzureRmApplicationGatewayFrontendIPConfig [-DefaultProfile <IAzureContextContainer>] -Name <String> [-PrivateIPAddress <String>]
[-PublicIPAddressId <String>] [-SubnetId <String>] [<CommonParameters>]
DESCRIPTION
The New-AzureRmApplicationGatewayFrontendIPConfig cmdlet creates a front-end IP configuraton for an Azure application gateway. An application
gateway supports two types of front-end IP configuration:
- Public IP addresses -- Private IP addresses using internal load balancing (ILB).
An application gateway can have at most one public IP address and one private IP address. The public IP address and private IP address should be
added separately as front-end IP addresses.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies the name of the front-end IP configuration that this cmdlet creates.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PrivateIPAddress <String>
Specifies the private IP address which this cmdlet associates with the front-end IP address of the application gateway. This can be specified
only if a subnet is specified. This IP is statically allocated from the subnet.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PublicIPAddress <PSPublicIpAddress>
Specifies the public IP address object which this cmdlet associates with the front-end IP address of the application gateway.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PublicIPAddressId <String>
Specifies the public IP address ID which this cmdlet associates with the front-end IP of the application gateway.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Subnet <PSSubnet>
Specifies the subnet object which this cmdlet associates with the front-end IP address of the application gateway. If you specify this
parameter, it implies that the gateway uses a private IP address. If the PrivateIPAddresss parameter is specified, it should belong to the
subnet specified by this parameter. If PrivateIPAddress is not specified, one of the IP addresses from this subnet is dynamically picked up as
the front-end IP address of the application gateway.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-SubnetId <String>
Specifies the subnet ID which this cmdlet associates with the front-end IP configuration of the application gateway. If you specify the Subnet
parameter, it implies that the gateway uses a private IP address. If the PrivateIPAddress parameter is specified, it should belong to the
subnet specified by Subnet . If PrivateIPAddress is not specified, one of the IP addresses from this subnet is dynamically picked up as the
front-end IP address of the application gateway.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String
OUTPUTS
Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration
NOTES
Example 1: Create a front-end IP configuration using a public IP resource object
PS C:\\>$PublicIP = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIP01" -location "West US" -AllocationMethod Dynamic
PS C:\\> $FrontEnd = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndIP01" -PublicIPAddress $PublicIP
The first command creates a public IP resource object and stores it in the $PublicIP variable. The second command uses $PublicIP to create a new
front-end IP configuration named FrontEndIP01 and stores it in the $FrontEnd variable.
Example 2: Create a static private IP as the front-end IP address
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
The first command gets a virtual network named VNet01 that belongs to the resource group named ResourceGroup01, and stores it in the $VNet
variable. The second command gets a subnet configuration named Subnet01 using $VNet from the first command and stores it in the $Subnet variable.
The third command creates a front-end IP configuration named FrontEndIP02 using $Subnet from the second command and the private IP address
10.0.1.1, and then stores it in the $FrontEnd variable.
Example 3: Create a dynamic private IP as the front-end IP address
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
The first command gets a virtual network named VNet01 that belongs to the resource group named ResourceGroup01, and stores it in the $VNet
variable. The second command gets a subnet configuration named Subnet01 using $VNet from the first command and stores it in the $Subnet variable.
The third command creates a front-end IP configuration named FrontEndIP03 using $Subnet from the second command, and stores it in the $FrontEnd
variable.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... ndipconfig
Add-AzureRmApplicationGatewayFrontendIPConfig
Get-AzureRmApplicationGatewayFrontendIPConfig
Remove-AzureRmApplicationGatewayFrontendIPConfig
Set-AzureRmApplicationGatewayFrontendIPConfig