你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzureRmApplicationGatewayHttpListener
为应用程序网关创建 HTTP 侦听器。
警告
截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。
语法
New-AzureRmApplicationGatewayHttpListener
-Name <String>
[-FrontendIPConfigurationId <String>]
[-FrontendPortId <String>]
[-SslCertificateId <String>]
[-HostName <String>]
[-RequireServerNameIndication <String>]
-Protocol <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmApplicationGatewayHttpListener
-Name <String>
[-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
[-FrontendPort <PSApplicationGatewayFrontendPort>]
[-SslCertificate <PSApplicationGatewaySslCertificate>]
[-HostName <String>]
[-RequireServerNameIndication <String>]
-Protocol <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
New-AzureRmApplicationGatewayHttpListener cmdlet 为 Azure 应用程序网关创建 HTTP 侦听器。
示例
示例 1：创建 HTTP 侦听器
PS C:\>$Listener = New-AzureRmApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01此命令创建名为 Listener01 的 HTTP 侦听器，并将结果存储在名为 $Listener 的变量中。
示例 2：使用 SSL 创建 HTTP 侦听器
PS C:\>$Listener = New-AzureRmApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01此命令创建使用 SSL 卸载的 HTTP 侦听器，并在 $SSLCert 01 变量中提供 SSL 证书。 该命令将结果存储在名为$Listener的变量中。
参数
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontendIPConfiguration
指定 HTTP 侦听器的前端 IP 配置对象。
| Type: | PSApplicationGatewayFrontendIPConfiguration |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontendIPConfigurationId
指定 HTTP 侦听器的前端 IP 配置的 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontendPort
指定 HTTP 侦听器的前端端口。
| Type: | PSApplicationGatewayFrontendPort |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontendPortId
指定 HTTP 侦听器的前端端口对象的 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostName
指定应用程序网关 HTTP 侦听器的主机名。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定此 cmdlet 创建的 HTTP 侦听器的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
指定 HTTP 侦听器使用的协议。
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequireServerNameIndication
| Type: | String |
| Accepted values: | true, false |
| Position: | Named |
| Default value: | true |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SslCertificate
指定 HTTP 侦听器的 SSL 证书对象。
| Type: | PSApplicationGatewaySslCertificate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SslCertificateId
指定 HTTP 侦听器的 SSL 证书的 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
None
输出
PSApplicationGatewayHttpListener