Set-AzApplicationGatewayHttpListener

模組:

Az.Network Module

修改應用程式閘道的 HTTP 接聽程式。

語法

SetByResourceId

Set-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

Set-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

Set-AzApplicationGatewayHttpListener Cmdlet 會修改 Azure 應用程式閘道的 HTTP 接聽程式。

範例

範例 1：設定 HTTP 接聽程式

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80

第一個命令會取得名為 ApplicationGateway01 的應用程式閘道，該閘道屬於名為 ResourceGroup01 的資源群組，並將它儲存在 $AppGw 變數中。 第二個命令將閘道的 HTTP 接聽程式設定為使用儲存在 $FIP 01 中的前端組態，搭配連接埠 80 上的 HTTP 通訊協定。

範例 2：新增具有 SSL 和 HostNames 的 HTTPS 接聽程式

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-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

指定 HTTP 接聽程式的名稱。

參數屬性

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

指定 Cmdlet 是否需要伺服器名稱指示。 此參數的可接受值為：true 或 false。

參數屬性

類型:	String
預設值:	None
接受的值:	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。

輸入

PSApplicationGateway

輸出

PSApplicationGateway

相關連結

• Add-AzApplicationGatewayHttpListener
• Get-AzApplicationGatewayHttpListener
• New-AzApplicationGatewayHttpListener
• Remove-AzApplicationGatewayHttpListener