Add-AzureRmApplicationGatewayHttpListener

NAME Add-AzureRmApplicationGatewayHttpListener



SYNOPSIS

Adds an HTTP listener to an application gateway.





SYNTAX

Add-AzureRmApplicationGatewayHttpListener -ApplicationGateway <PSApplicationGateway> [-DefaultProfile <IAzureContextContainer>]

[-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>] [-FrontendPort <PSApplicationGatewayFrontendPort>] [-HostName <String>]

-Name <String> -Protocol {Http | Https} [-RequireServerNameIndication {true | false}] [-SslCertificate <PSApplicationGatewaySslCertificate>]

[<CommonParameters>]



Add-AzureRmApplicationGatewayHttpListener -ApplicationGateway <PSApplicationGateway> [-DefaultProfile <IAzureContextContainer>]

[-FrontendIPConfigurationId <String>] [-FrontendPortId <String>] [-HostName <String>] -Name <String> -Protocol {Http | Https}

[-RequireServerNameIndication {true | false}] [-SslCertificateId <String>] [<CommonParameters>]





DESCRIPTION

The Add-AzureRmApplicationGatewayHttpListener cmdlet adds a HTTP listener to an application gateway.





PARAMETERS

-ApplicationGateway <PSApplicationGateway>

Specifies the application gateway to which this cmdlet adds an HTTP listener.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

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



-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>

Specifies the application gateway front-end IP resource object.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-FrontendIPConfigurationId <String>

Specifies the application gateway front-end IP ID.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-FrontendPort <PSApplicationGatewayFrontendPort>

Specifies the application gateway front-end port object.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-FrontendPortId <String>

Specifies the application gateway front-end port ID.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-HostName <String>

Specifies the host name that this cmdlet adds a HTTP listener to.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Specifies the name of the front-end port that this command adds.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Protocol <String>

Specifies the protocol of the HTTP listener. Both HTTP and HTTPS are supported.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-RequireServerNameIndication <String>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-SslCertificate <PSApplicationGatewaySslCertificate>

Specifies the SSL certificate of the HTTP listener. Must be specified if HTTPS is chosen as listener protocol.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-SslCertificateId <String>

Specifies the SSL certificate ID of the HTTP listener. Must be specified if HTTPS is chosen as listener protocol.



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







NOTES









Example 1: Add a HTTP listener



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

PS C:\\> $Appgw = Add-AzureRmApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "listener01" -Protocol "Http" -FrontendIpConfiguration

$FIP01 -FrontendPort $FP01



The first command gets the application gateway and stores it in the $AppGw variable.The second command adds the HTTP listener to the application

gateway.





Example 2: Add a HTTPS listener with SSL



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

PS C:\\> $AppGw = Add-AzureRmApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https"

-FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01



The first command gets the application gateway and stores it in the $AppGw variable. The second command adds the listener, which uses the HTTPS

protocol, to the application gateway.







RELATED LINKS

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

Get-AzureRmApplicationGatewayHttpListener

New-AzureRmApplicationGatewayHttpListener

Remove-AzureRmApplicationGatewayHttpListener

Set-AzureRmApplicationGatewayHttpListener