< Back

Set-AzureRmApplicationGatewayBackendAddressPool

Tue Jan 29, 2019 9:57 pm

NAME Set-AzureRmApplicationGatewayBackendAddressPool



SYNOPSIS

Updates a back-end address pool for an application gateway.





SYNTAX

Set-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 Set-AzureRmApplicationGatewayBackendAddressPool cmdlet updates a back-end address pool for an Azure application gateway. Back-end addresses

can be specified as IP addresses, fully-qualified domain names (FQDN) or IP configurations IDs.





PARAMETERS

-ApplicationGateway <PSApplicationGateway>

Specifies the application gateway with which this cmdlet associates the 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 back-end IP addresses to use 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]>





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 address pool. This back-end address pool must exist in the application gateway.



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: Setting a back-end address pool by using FQDNs



PS C:\\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"

PS C:\\> $AppGw = Set-AzureRmApplicationGatewayBackendAddressPool -ApplicationGateway $AppGw -Name "Pool02" -BackendFqdns "contoso1.com",

"contoso2.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 updates the back-end address pool of the application gateway in $AppGw by using FQDNs.





Example 2: Setting a back-end address pool by using backend server IP addresses



PS C:\\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"

PS C:\\> $AppGw = Set-AzureRmApplicationGatewayBackendAddressPool -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 updates the back-end address pool of the application gateway in $AppGw by using IP addresses.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... ddresspool

Add-AzureRmApplicationGatewayBackendAddressPool

Get-AzureRmApplicationGatewayBackendAddressPool

New-AzureRmApplicationGatewayBackendAddressPool

Remove-AzureRmApplicationGatewayBackendAddressPool