< Back
Add-AzureRmApplicationGatewayBackendAddressPool
Post
NAME Add-AzureRmApplicationGatewayBackendAddressPool
SYNOPSIS
Adds a back-end address pool to an application gateway.
SYNTAX
Add-AzureRmApplicationGatewayBackendAddressPool -ApplicationGateway <PSApplicationGateway> [-BackendFqdns
<System.Collections.Generic.List`1[System.String]>] [-BackendIPAddresses <System.Collections.Generic.List`1[System.String]>] [-DefaultProfile
<IAzureContextContainer>] -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Add-AzureRmApplicationGatewayBackendAddressPool cmdlet adds a back-end address pool to an application gateway. A back-end address can be
specified using an IP address, a fully-qualified domain name (FQDN) or IP configuration IDs.
PARAMETERS
-ApplicationGateway <PSApplicationGateway>
Specifies the application gateway to which this cmdlet adds a back-end address pool.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-BackendFqdns <System.Collections.Generic.List`1[System.String]>
Specifies a list of backend FQDNs which this cmdlet adds as a back-end server pool.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-BackendIPAddresses <System.Collections.Generic.List`1[System.String]>
Specifies a list of back-end IP addresses which this cmdlet adds as a back-end server pool.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-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 back-end server pool that this cmdlet adds.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
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.PSApplicationGateway
NOTES
Example 1: Add a back-end address pool by using a back-end server FQDN
PS C:\\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\\> $AppGw = Add-AzureRmApplicationGatewayBackendAddressPool -ApplicationGateway $AppGw -Name "Pool02" -BackendFqdns "contoso1.com", "
contoso1.com"
The first command gets the application gateway named ApplicationGateway01 in the resource group named ResourceGroup01, and stores it in the $AppGw
variable.The second command adds the back-end address pool of the application gateway stored in $AppGw by using FQDNs.
Example 2: Add a back-end address pool by using backend server IP addresses
PS C:\\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\\> $AppGw = Add -AzureApplicationGatewayBackendAddressPool -ApplicationGateway $ AppGw -Name "Pool02" -BackendIPAddresses "10.10.10.10",
"10.10.10.11"
The first command gets the application gateway named ApplicationGateway01 in the resource group named ResourceGroup01, and stores it in the $AppGw
variable.The second command adds the back-end address pool of the application gateway stored in $AppGw by using IP addresses.
Example 3: Seta back-end address pool by using the ID of the backend server's IP address
PS C:\\>$Nic01 = Get-AzureRmNetworkInterface -Name "Nic01" -ResourceGroupName "ResourceGroup01"
PS C:\\> $Nic02 = Get-AzureRmNetworkInterface -Name "Nic02" -ResourceGroupName "ResourceGroup01"
PS C:\\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\\> $AppGw = Add-AzureRmApplicationGatewayBackendAddressPool -ApplicationGateway $ AppGw -Name "Pool02" -BackendIPConfigurationIds
$nic01.Properties.IpConfigurations[0].Id, $nic02.Properties.IpConfiguration[0].Id
The first command gets a network interface object named Nic01 that belongs to the resource group named ResourceGroup01, and stores it in the
$Nic01 variable.The second command gets a network interface object named Nic02 that belongs to the resource group named ResourceGroup02, and
stores it in the $Nic02 variable.The third command gets the application gateway named ApplicationGateway01 in the resource group named
ResourceGroup01, and stores it in the $AppGw variable.The forth command uses the back-end IP configuration IDs from $Nic01 and $Nic02 to add the
back-end address pool of the application gateway stored in $AppGw.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... ddresspool
Get-AzureRmApplicationGatewayBackendAddressPool
Get-AzureRmApplicationGatewayBackendAddressPool
New-AzureRmApplicationGatewayBackendAddressPool
Remove-AzureRmApplicationGatewayBackendAddressPool
Set-AzureRmApplicationGatewayBackendAddressPool
SYNOPSIS
Adds a back-end address pool to an application gateway.
SYNTAX
Add-AzureRmApplicationGatewayBackendAddressPool -ApplicationGateway <PSApplicationGateway> [-BackendFqdns
<System.Collections.Generic.List`1[System.String]>] [-BackendIPAddresses <System.Collections.Generic.List`1[System.String]>] [-DefaultProfile
<IAzureContextContainer>] -Name <String> [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Add-AzureRmApplicationGatewayBackendAddressPool cmdlet adds a back-end address pool to an application gateway. A back-end address can be
specified using an IP address, a fully-qualified domain name (FQDN) or IP configuration IDs.
PARAMETERS
-ApplicationGateway <PSApplicationGateway>
Specifies the application gateway to which this cmdlet adds a back-end address pool.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-BackendFqdns <System.Collections.Generic.List`1[System.String]>
Specifies a list of backend FQDNs which this cmdlet adds as a back-end server pool.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-BackendIPAddresses <System.Collections.Generic.List`1[System.String]>
Specifies a list of back-end IP addresses which this cmdlet adds as a back-end server pool.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-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 back-end server pool that this cmdlet adds.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
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.PSApplicationGateway
NOTES
Example 1: Add a back-end address pool by using a back-end server FQDN
PS C:\\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\\> $AppGw = Add-AzureRmApplicationGatewayBackendAddressPool -ApplicationGateway $AppGw -Name "Pool02" -BackendFqdns "contoso1.com", "
contoso1.com"
The first command gets the application gateway named ApplicationGateway01 in the resource group named ResourceGroup01, and stores it in the $AppGw
variable.The second command adds the back-end address pool of the application gateway stored in $AppGw by using FQDNs.
Example 2: Add a back-end address pool by using backend server IP addresses
PS C:\\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\\> $AppGw = Add -AzureApplicationGatewayBackendAddressPool -ApplicationGateway $ AppGw -Name "Pool02" -BackendIPAddresses "10.10.10.10",
"10.10.10.11"
The first command gets the application gateway named ApplicationGateway01 in the resource group named ResourceGroup01, and stores it in the $AppGw
variable.The second command adds the back-end address pool of the application gateway stored in $AppGw by using IP addresses.
Example 3: Seta back-end address pool by using the ID of the backend server's IP address
PS C:\\>$Nic01 = Get-AzureRmNetworkInterface -Name "Nic01" -ResourceGroupName "ResourceGroup01"
PS C:\\> $Nic02 = Get-AzureRmNetworkInterface -Name "Nic02" -ResourceGroupName "ResourceGroup01"
PS C:\\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\\> $AppGw = Add-AzureRmApplicationGatewayBackendAddressPool -ApplicationGateway $ AppGw -Name "Pool02" -BackendIPConfigurationIds
$nic01.Properties.IpConfigurations[0].Id, $nic02.Properties.IpConfiguration[0].Id
The first command gets a network interface object named Nic01 that belongs to the resource group named ResourceGroup01, and stores it in the
$Nic01 variable.The second command gets a network interface object named Nic02 that belongs to the resource group named ResourceGroup02, and
stores it in the $Nic02 variable.The third command gets the application gateway named ApplicationGateway01 in the resource group named
ResourceGroup01, and stores it in the $AppGw variable.The forth command uses the back-end IP configuration IDs from $Nic01 and $Nic02 to add the
back-end address pool of the application gateway stored in $AppGw.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... ddresspool
Get-AzureRmApplicationGatewayBackendAddressPool
Get-AzureRmApplicationGatewayBackendAddressPool
New-AzureRmApplicationGatewayBackendAddressPool
Remove-AzureRmApplicationGatewayBackendAddressPool
Set-AzureRmApplicationGatewayBackendAddressPool