New-AzApplicationGatewayHttpListener

  • 參考
模組:
Az.Network

建立應用程式閘道的 HTTP 接聽程式。

Syntax

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

應用程式閘道的客戶錯誤

Type:PSApplicationGatewayCustomError[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicy

指定最上層防火牆原則的對象參考。 您可以使用 New-AzApplicationGatewayWebApplicationFirewallPolicy Cmdlet 來建立對象參考。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name “wafPolicy1” -ResourceGroup “rgName” 使用上述 commandlet 建立的防火牆原則可以在路徑規則層級參考。 上述命令會建立默認原則設定和受控規則。 除了預設值外，用戶可以分別使用 New-AzApplicationGatewayFirewallPolicy 設定 和 New-AzApplicationGatewayFirewallPolicyManagedRules 來指定 Policy 設定 ManagedRules。

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicyId

指定現有最上層 Web 應用程式防火牆資源的識別碼。 您可以使用 Get-AzApplicationGatewayWebApplicationFirewallPolicy Cmdlet 來傳回防火牆原則標識符。 取得標識符之後，您可以使用 FirewallPolicyId 參數， 而不是 FirewallPolicy 參數。 例如： -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Type:String
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 組態識別碼。

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 接聽程式前埠物件的識別碼。

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

-HostNames

主機名稱

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 憑證識別碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslProfile

SslProfile

Type:PSApplicationGatewaySslProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslProfileId

SslProfileId

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

輸出

PSApplicationGatewayHttpListener