共用方式為


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