你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzApplicationGatewayHttpListener

模块:

Az.Network

为应用程序网关创建 HTTP 侦听器。

语法

New-AzApplicationGatewayHttpListener
   -Name <String>
   [-FrontendIPConfigurationId <String>]
   [-FrontendPortId <String>]
   [-SslCertificateId <String>]
   [-FirewallPolicyId <String>]
   [-SslProfileId <String>]
   [-HostName <String>]
   [-HostNames <String[]>]
   [-RequireServerNameIndication <String>]
   -Protocol <String>
   [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzApplicationGatewayHttpListener
   -Name <String>
   [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
   [-FrontendPort <PSApplicationGatewayFrontendPort>]
   [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
   [-SslCertificate <PSApplicationGatewaySslCertificate>]
   [-SslProfile <PSApplicationGatewaySslProfile>]
   [-HostName <String>]
   [-HostNames <String[]>]
   [-RequireServerNameIndication <String>]
   -Protocol <String>
   [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

New-AzApplicationGatewayHttpListener cmdlet 为 Azure 应用程序网关创建 HTTP 侦听器。

示例

示例 1：创建 HTTP 侦听器

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01

此命令创建名为 Listener01 的 HTTP 侦听器，并将结果存储在名为 $Listener 的变量中。

示例 2：使用 SSL 创建 HTTP 侦听器

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01

此命令创建使用 SSL 卸载的 HTTP 侦听器，并在 $SSLCert 01 变量中提供 SSL 证书。 该命令将结果存储在名为$Listener的变量中。

示例 3：使用防火墙策略创建 HTTP 侦听器

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -FirewallPolicy $firewallPolicy

此命令将创建名为 Listener01 的 HTTP 侦听器，FirewallPolicy 作为$firewallPolicy，并将结果存储在名为$Listener的变量中。

示例 4：使用 SSL 和主机名添加 HTTPS 侦听器

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"

此命令创建使用 SSL 卸载的 HTTP 侦听器，并在 $SSLCert 01 变量中以及两个 HostName 中提供 SSL 证书。 该命令将结果存储在名为$Listener的变量中。

参数

-CustomErrorConfiguration

应用程序网关的客户错误

类型:	PSApplicationGatewayCustomError[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FirewallPolicy

指定对顶级防火墙策略的对象引用。 可以使用 New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet 创建对象引用。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name“wafPolicy1”-ResourceGroup“rgName”使用上述 commandlet 创建的防火墙策略可以在路径规则级别引用。 上述命令将创建默认策略设置和托管规则。 用户可以使用 New-AzApplicationGatewayFirewallPolicySettings 和 New-AzApplicationGatewayFirewallPolicyManagedRules 来指定 PolicySettings、ManagedRules，而不是默认值。

类型:	PSApplicationGatewayWebApplicationFirewallPolicy
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FirewallPolicyId

指定现有顶级 Web 应用程序防火墙资源的 ID。 可以使用 Get-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet 返回防火墙策略 ID。 获取 ID 后，可以使用 FirewallPolicyId 参数而不是 FirewallPolicy 参数。 例如：-FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FrontendIPConfiguration

指定 HTTP 侦听器的前端 IP 配置对象。

类型:	PSApplicationGatewayFrontendIPConfiguration
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FrontendIPConfigurationId

指定 HTTP 侦听器的前端 IP 配置的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FrontendPort

指定 HTTP 侦听器的前端端口。

类型:	PSApplicationGatewayFrontendPort
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-FrontendPortId

指定 HTTP 侦听器的前端端口对象的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HostName

指定应用程序网关 HTTP 侦听器的主机名。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HostNames

主机名

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定此 cmdlet 创建的 HTTP 侦听器的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Protocol

指定 HTTP 侦听器使用的协议。

类型:	String
接受的值:	Http, Https
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RequireServerNameIndication

类型:	String
接受的值:	true, false
Position:	Named
默认值:	true
必需:	False
接受管道输入:	False
接受通配符:	False

-SslCertificate

指定 HTTP 侦听器的 SSL 证书对象。

类型:	PSApplicationGatewaySslCertificate
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SslCertificateId

指定 HTTP 侦听器的 SSL 证书的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SslProfile

SslProfile

类型:	PSApplicationGatewaySslProfile
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SslProfileId

SslProfileId

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

PSApplicationGatewayHttpListener

相关链接

• Add-AzApplicationGatewayHttpListener
• Get-AzApplicationGatewayHttpListener
• Remove-AzApplicationGatewayHttpListener
• Set-AzApplicationGatewayHttpListener