New-AzureRmApplicationGatewayHttpListener

NAME New-AzureRmApplicationGatewayHttpListener



SYNOPSIS

Creates an HTTP listener for an application gateway.





SYNTAX

New-AzureRmApplicationGatewayHttpListener [-DefaultProfile <IAzureContextContainer>] [-FrontendIPConfiguration

<PSApplicationGatewayFrontendIPConfiguration>] [-FrontendPort <PSApplicationGatewayFrontendPort>] [-HostName <String>] -Name <String> -Protocol

{Http | Https} [-RequireServerNameIndication {true | false}] [-SslCertificate <PSApplicationGatewaySslCertificate>] [<CommonParameters>]



New-AzureRmApplicationGatewayHttpListener [-DefaultProfile <IAzureContextContainer>] [-FrontendIPConfigurationId <String>] [-FrontendPortId

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

[<CommonParameters>]





DESCRIPTION

The New-AzureRmApplicationGatewayHttpListener cmdlet creates an HTTP listener for an Azure application gateway.





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



-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>

Specifies front-end IP configuration object for the HTTP listener.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-FrontendIPConfigurationId <String>

Specifies the ID of the front-end IP configuration for the HTTP listener.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-FrontendPort <PSApplicationGatewayFrontendPort>

Specifies the front-end port for the HTTP listener.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-FrontendPortId <String>

Specifies the ID of the front-end port object for the HTTP listener.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-HostName <String>

Specifies the host name of the application gateway HTTP listener.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Specifies the name of the HTTP listener that this cmdlet creates.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Protocol <String>

Specifies the protocol that the HTTP listener uses.



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 object for the HTTP listener.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-SslCertificateId <String>

Specifies the ID of the SSL certificate for the HTTP listener.



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







NOTES









Example 1: Create an HTTP listener



PS C:\\>$Listener = New-AzureRmApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort

$FP01



This command creates an HTTP listener named Listener01 and stores the result in the variable named $Listener.





Example 2: Create an HTTP listener with SSL



PS C:\\>$Listener = New-AzureRmApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort

$FP01 -SslCertificate $SSLCert01



This command creates an HTTP listener that uses SSL offload and provides the SSL certificate in the $SSLCert01 variable. The command stores the

result in the variable named $Listener.







RELATED LINKS

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

Add-AzureRmApplicationGatewayHttpListener

Get-AzureRmApplicationGatewayHttpListener

Remove-AzureRmApplicationGatewayHttpListener

Set-AzureRmApplicationGatewayHttpListener