共用方式為


New-AzApplicationGatewayHttpListener

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

語法

SetByResourceId

New-AzApplicationGatewayHttpListener
    -Name <String>
    -Protocol <String>
    [-FrontendIPConfigurationId <String>]
    [-FrontendPortId <String>]
    [-SslCertificateId <String>]
    [-FirewallPolicyId <String>]
    [-SslProfileId <String>]
    [-HostName <String>]
    [-HostNames <String[]>]
    [-RequireServerNameIndication <String>]
    [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

New-AzApplicationGatewayHttpListener
    -Name <String>
    -Protocol <String>
    [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
    [-FrontendPort <PSApplicationGatewayFrontendPort>]
    [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
    [-SslCertificate <PSApplicationGatewaySslCertificate>]
    [-SslProfile <PSApplicationGatewaySslProfile>]
    [-HostName <String>]
    [-HostNames <String[]>]
    [-RequireServerNameIndication <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:使用 firewall-policy 建立 HTTP 接聽程式

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -FirewallPolicy $firewallPolicy

此命令會建立名為 Listener01、FirewallPolicy 的 HTTP 接聽程式作為$firewallPolicy,並將結果儲存在名為 $Listener 的變數中。

範例 4:新增具有 SSL 和 HostNames 的 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[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

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

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FirewallPolicy

指定最上層防火牆原則的物件參考。 您可以使用 Cmdlet 建立物件參考 New-AzApplicationGatewayWebApplicationFirewallPolicy。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name “wafPolicy1” -ResourceGroup “rgName” 使用上述 Cmdlet 建立的防火牆原則可以在路徑規則層級參考。 上述命令將創建默認策略設置和託管規則。 使用者可以分別使用 New-AzApplicationGatewayFirewallPolicySettings 和 New-AzApplicationGatewayFirewallPolicyManagedRules 來指定 PolicySettings、ManagedRules,而不是預設值。

參數屬性

類型:PSApplicationGatewayWebApplicationFirewallPolicy
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FirewallPolicyId

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FrontendIPConfiguration

指定 HTTP 接聽程式的前端 IP 組態物件。

參數屬性

類型:PSApplicationGatewayFrontendIPConfiguration
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FrontendIPConfigurationId

指定 HTTP 接聽程式的前端 IP 組態 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FrontendPort

指定 HTTP 接聽程式的前端連接埠。

參數屬性

類型:PSApplicationGatewayFrontendPort
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FrontendPortId

指定 HTTP 接聽程式的前端埠物件 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-HostName

指定應用程式閘道 HTTP 接聽程式的主機名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-HostNames

主機名稱

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定此 Cmdlet 所建立的 HTTP 接聽程式名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Protocol

指定 HTTP 接聽器使用的通訊協定。

參數屬性

類型:String
預設值:None
接受的值:Http, Https
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RequireServerNameIndication

New-AzApplicationGatewayHttpListener Cmdlet 會建立 Azure 應用程式閘道的 HTTP 接聽程式。

參數屬性

類型:String
預設值:true
接受的值:true, false
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SslCertificate

指定 HTTP 接聽程式的 SSL 憑證物件。

參數屬性

類型:PSApplicationGatewaySslCertificate
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SslCertificateId

指定 HTTP 接聽器的 SSL 憑證 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SslProfile

Ssl設定檔

參數屬性

類型:PSApplicationGatewaySslProfile
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResource
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SslProfileId

SslProfileId

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SetByResourceId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

None

輸出

PSApplicationGatewayHttpListener