你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Add-AzApplicationGatewayHttpListener
将 HTTP 侦听器添加到应用程序网关。
语法
Add-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-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>]
Add-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-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>]
说明
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 |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-CustomErrorConfiguration
应用程序网关的客户错误
类型: | PSApplicationGatewayCustomError[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FirewallPolicy
FirewallPolicy
类型: | PSApplicationGatewayWebApplicationFirewallPolicy |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FirewallPolicyId
FirewallPolicyId
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FrontendIPConfiguration
指定应用程序网关前端 IP 资源对象。
类型: | PSApplicationGatewayFrontendIPConfiguration |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FrontendIPConfigurationId
指定应用程序网关前端 IP ID。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FrontendPort
指定应用程序网关前端端口对象。
类型: | PSApplicationGatewayFrontendPort |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FrontendPortId
指定应用程序网关前端端口 ID。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-HostName
指定此 cmdlet 将 HTTP 侦听器添加到的主机名。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-HostNames
主机名
类型: | String[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
指定此命令添加的前端端口的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Protocol
指定 HTTP 侦听器的协议。 支持 HTTP 和 HTTPS。
类型: | String |
接受的值: | Http, Https |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-RequireServerNameIndication
类型: | String |
接受的值: | true, false |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SslCertificate
指定 HTTP 侦听器的 SSL 证书。 如果选择 HTTPS 作为侦听器协议,则必须指定。
类型: | PSApplicationGatewaySslCertificate |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SslCertificateId
指定 HTTP 侦听器的 SSL 证书 ID。 如果选择 HTTPS 作为侦听器协议,则必须指定。
类型: | 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 |