共用方式為


Add-AzApplicationGatewayHttpListener

將 HTTP 接聽程式新增至應用程式閘道。

語法

SetByResourceId

Add-AzApplicationGatewayHttpListener
    -ApplicationGateway <PSApplicationGateway>
    -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

Add-AzApplicationGatewayHttpListener
    -ApplicationGateway <PSApplicationGateway>
    -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

Add-AzApplicationGatewayHttpListener Cmdlet 會將 HTTP 接聽程式新增至應用程式閘道。

範例

範例 1:新增 HTTP 接聽程式

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$Appgw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "listener01" -Protocol "Http" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01

第一個命令會取得應用程式閘道,並將它儲存在 $AppGw 變數中。第二個命令會將 HTTP 接聽程式新增至應用程式閘道。

範例 2:使用 SSL 新增 HTTPS 接聽程式

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01

第一個命令會取得應用程式閘道,並將它儲存在 $AppGw 變數中。 第二個命令會將使用 HTTPS 通訊協定的接聽程式新增至應用程式閘道。

範例 3:新增具有 SSL 和 HostNames 的 HTTPS 接聽程式

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"

第一個命令會取得應用程式閘道,並將它儲存在 $AppGw 變數中。 第二個命令會將接聽程式 (使用 HTTPS 通訊協定) 搭配 SSL 憑證和主機名稱新增至應用程式閘道。

參數

-ApplicationGateway

指定此 Cmdlet 新增 HTTP 接聽程式的應用程式閘道。

參數屬性

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

參數集

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

-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

防火牆策略

參數屬性

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

參數集

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

-FirewallPolicyId

防火牆原則標識符

參數屬性

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

參數集

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

-FrontendIPConfiguration

指定應用程式閘道前端 IP 資源物件。

參數屬性

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

參數集

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

-FrontendIPConfigurationId

指定應用程式閘道前端 IP 識別碼。

參數屬性

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

參數集

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

-FrontendPort

指定應用程式閘道前端埠物件。

參數屬性

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

參數集

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

-FrontendPortId

指定應用程式閘道前端連接埠識別碼。

參數屬性

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

參數集

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

-HostName

指定此 Cmdlet 新增 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

指定此命令新增的前端埠名稱。

參數屬性

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

參數集

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

-Protocol

指定 HTTP 接聽程式的通訊協定。 支援 HTTP 和 HTTPS。

參數屬性

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

參數集

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

-RequireServerNameIndication

Add-AzApplicationGatewayHttpListener Cmdlet 會將 HTTP 接聽程式新增至應用程式閘道。

參數屬性

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

參數集

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

-SslCertificate

指定 HTTP 接聽程式的 SSL 憑證。 如果選擇 HTTPS 作為接聽器通訊協定,則必須指定。

參數屬性

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

參數集

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

-SslCertificateId

指定 HTTP 接聽程式的 SSL 憑證 ID。 如果選擇 HTTPS 作為接聽器通訊協定,則必須指定。

參數屬性

類型: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

輸入

PSApplicationGateway

輸出

PSApplicationGateway