通过

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

New-AzApplicationGatewayHttpListener

模块:
Az.Network Module

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

语法

SetByResourceId 

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

SetByResource 

New-AzApplicationGatewayHttpListener
    -Name <String>
    -Protocol <String>
    [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
    [-FrontendPort <PSApplicationGatewayFrontendPort>]
    [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
    [-SslCertificate <PSApplicationGatewaySslCertificate>]
    [-SslProfile <PSApplicationGatewaySslProfile>]
    [-HostName <String>]
    [-HostNames <String[]>]
    [-RequireServerNameIndication <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[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FirewallPolicy

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

参数属性

类型:PSApplicationGatewayWebApplicationFirewallPolicy
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值: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
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FrontendIPConfiguration

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

参数属性

类型:PSApplicationGatewayFrontendIPConfiguration
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FrontendIPConfigurationId

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FrontendPort

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

参数属性

类型:PSApplicationGatewayFrontendPort
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FrontendPortId

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-HostName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-HostNames

主机名

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Protocol

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

参数属性

类型:String
默认值:None
接受的值:Http, Https
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-RequireServerNameIndication

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

参数属性

类型:String
默认值:true
接受的值:true, false
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SslCertificate

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

参数属性

类型:PSApplicationGatewaySslCertificate
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SslCertificateId

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SslProfile

SslProfile

参数属性

类型:PSApplicationGatewaySslProfile
默认值:None
支持通配符:False
不显示:False

参数集

SetByResource
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SslProfileId

SslProfileId

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

SetByResourceId
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

None

输出

PSApplicationGatewayHttpListener