< Back

New-AzureRmApplicationGatewayBackendAddressPool

Tue Jan 29, 2019 9:55 pm

NAME New-AzureRmApplicationGatewayBackendAddressPool



SYNOPSIS

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





SYNTAX

New-AzureRmApplicationGatewayBackendAddressPool [-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 New-AzureRmApplicationGatewayBackendAddressPool cmdlet creates a back-end address pool for an Azure application gateway. A back-end address

can be specified as an IP address, a fully-qualified domain name (FQDN) or an IP configuration ID.





PARAMETERS

-BackendFqdns <System.Collections.Generic.List`1[System.String]>

Specifies a list of back-end FQDNs that this cmdlet associates with the 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 that this cmdlet associates with the 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 creates.



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.PSApplicationGatewayBackendAddressPool







NOTES









Example 1: Create a back-end address pool by using the FQDN of a back-end server



PS C:\\>$Pool = New-AzureRmApplicationGatewayBackendAddressPool -Name "Pool01" -BackendFqdns "contoso1.com", "contoso2.com"



This command creates a back-end address pool named Pool01 by using the FQDNs of back-end servers, and stores it in the $Pool variable.





Example 2: Create a back-end address pool by using the IP address of a back-end server



PS C:\\>$Pool = New-AzureRmApplicationGatewayBackendAddressPool -Name "Pool02" -BackendFqdns "10.10.10.10", "10.10.10.11"



This command creates a back-end address pool named Pool02 by using the IP addresses of back-end servers, and stores it in the $Pool variable.







RELATED LINKS

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

Add-AzureRmApplicationGatewayBackendAddressPool

Get-AzureRmApplicationGatewayBackendAddressPool

Remove-AzureRmApplicationGatewayBackendAddressPool

Set-AzureRmApplicationGatewayBackendAddressPool