New-AzApplicationGatewayHttpListener
建立應用程式閘道的 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>] Description
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、FirewallPolicy 的 HTTP 接聽程式作為$firewallPolicy，並將結果儲存在名為 $Listener 的變數中。
範例 4：使用 SSL 和 HostName 新增 HTTPS 接聽程式
$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"此命令會建立使用 SSL 卸除的 HTTP 接聽程式，並在 $SSLCert 01 變數中提供 SSL 憑證，以及兩個 HostName。 命令會將結果儲存在名為 $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 應用程式防火牆資源的識別碼。
您可以使用 Get-AzApplicationGatewayWebApplicationFirewallPolicy Cmdlet 來傳回防火牆原則標識符。
取得標識符之後，您可以使用 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 組態識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FrontendPort
指定 HTTP 接聽程式的前埠。
| 類型: | PSApplicationGatewayFrontendPort |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FrontendPortId
指定 HTTP 接聽程式前埠物件的識別碼。
| 類型: | 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 憑證識別碼。
| 類型: | 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