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

Add-AzApplicationGatewayHttpListener

模块:: Az.Network Module

将 HTTP 侦听器添加到应用程序网关。

语法

SetByResourceId

Add-AzApplicationGatewayHttpListener
    -ApplicationGateway <PSApplicationGateway>
    -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

Add-AzApplicationGatewayHttpListener
    -ApplicationGateway <PSApplicationGateway>
    -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>]

说明

Add-AzApplicationGatewayHttpListener cmdlet 向应用程序网关添加 HTTP 侦听器。

示例

示例 1：添加 HTTP 侦听器

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$Appgw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "listener01" -Protocol "Http" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01

第一个命令获取应用程序网关并将其存储在$AppGw变量中。第二个命令将 HTTP 侦听器添加到应用程序网关。

示例 2：使用 SSL 添加 HTTPS 侦听器

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01

第一个命令获取应用程序网关并将其存储在$AppGw变量中。第二个命令将使用 HTTPS 协议的侦听器添加到应用程序网关。

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

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"

第一个命令获取应用程序网关并将其存储在$AppGw变量中。第二个命令将使用 HTTPS 协议和 SSL 证书和主机名的侦听器添加到应用程序网关。

参数

-ApplicationGateway

指定此 cmdlet 向其添加 HTTP 侦听器的应用程序网关。

参数属性

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

参数集

(All)

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

-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

FirewallPolicy

参数属性

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

参数集

SetByResource

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

-FirewallPolicyId

防火墙策略 ID

参数属性

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

参数集

SetByResourceId

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

-FrontendIPConfiguration

指定应用程序网关前端 IP 资源对象。

参数属性

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

参数集

SetByResource

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

-FrontendIPConfigurationId

指定应用程序网关前端 IP ID。

参数属性

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

参数集

SetByResourceId

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

-FrontendPort

指定应用程序网关前端端口对象。

参数属性

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

参数集

SetByResource

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

-FrontendPortId

指定应用程序网关前端端口 ID。

参数属性

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

参数集

SetByResourceId

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

-HostName

指定此 cmdlet 将 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

指定此命令添加的前端端口的名称。

参数属性

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

参数集

(All)

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

-Protocol

指定 HTTP 侦听器的协议。支持 HTTP 和 HTTPS。

参数属性

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

参数集

(All)

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

-RequireServerNameIndication

Add-AzApplicationGatewayHttpListener cmdlet 向应用程序网关添加 HTTP 侦听器。

参数属性

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

参数集

(All)

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

-SslCertificate

指定 HTTP 侦听器的 SSL 证书。如果选择 HTTPS 作为侦听器协议，则必须指定。

参数属性

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

参数集

SetByResource

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

-SslCertificateId

指定 HTTP 侦听器的 SSL 证书 ID。如果选择 HTTPS 作为侦听器协议，则必须指定。

参数属性

类型:	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。

通过

Add-AzApplicationGatewayHttpListener

语法

SetByResourceId

SetByResource

说明

示例

示例 1：添加 HTTP 侦听器

示例 2：使用 SSL 添加 HTTPS 侦听器

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

参数

-ApplicationGateway

参数属性

参数集

-CustomErrorConfiguration

参数属性

参数集

-DefaultProfile

参数属性

参数集

-FirewallPolicy

参数属性

参数集

-FirewallPolicyId

参数属性

参数集

-FrontendIPConfiguration

参数属性

参数集

-FrontendIPConfigurationId

参数属性

参数集

-FrontendPort

参数属性

参数集

-FrontendPortId

参数属性

参数集

-HostName

参数属性

参数集

-HostNames

参数属性

参数集

-Name

参数属性

参数集

-Protocol

参数属性

参数集

-RequireServerNameIndication

参数属性

参数集

-SslCertificate

参数属性

参数集

-SslCertificateId

参数属性

参数集

-SslProfile

参数属性

参数集

-SslProfileId

参数属性

参数集

CommonParameters

输入

PSApplicationGateway

输出

PSApplicationGateway

相关链接

反馈