共用方式為


Add-AzApplicationGatewayHttpListener

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

語法

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

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 和 HostName 新增 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
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-CustomErrorConfiguration

應用程式閘道的客戶錯誤

類型:PSApplicationGatewayCustomError[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FirewallPolicy

FirewallPolicy

類型:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FirewallPolicyId

FirewallPolicyId

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FrontendIPConfiguration

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

類型:PSApplicationGatewayFrontendIPConfiguration
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FrontendIPConfigurationId

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

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FrontendPort

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

類型:PSApplicationGatewayFrontendPort
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-FrontendPortId

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

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-HostName

指定此 Cmdlet 新增 HTTP 接聽程式的主機名。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-HostNames

主機名稱

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

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

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Protocol

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

類型:String
接受的值:Http, Https
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-RequireServerNameIndication

類型:String
接受的值:true, false
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SslCertificate

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

類型:PSApplicationGatewaySslCertificate
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SslCertificateId

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

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

輸入

PSApplicationGateway

輸出

PSApplicationGateway