Set-AzureRmApplicationGatewayBackendHttpSettings

參考

模組:: AzureRM.Network

更新應用程式閘道的後端 HTTP 設定。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。如需轉換至 Az 模組的指引，請參閱我們的移轉資源。

語法

Set-AzureRmApplicationGatewayBackendHttpSettings
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   -Port <Int32>
   -Protocol <String>
   -CookieBasedAffinity <String>
   [-RequestTimeout <Int32>]
   [-ConnectionDraining <PSApplicationGatewayConnectionDraining>]
   [-ProbeId <String>]
   [-Probe <PSApplicationGatewayProbe>]
   [-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
   [-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
   [-PickHostNameFromBackendAddress]
   [-HostName <String>]
   [-AffinityCookieName <String>]
   [-Path <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzureRmApplicationGatewayBackendHttpSettings Cmdlet 會更新 Azure 應用程式網關的後端超文本傳輸通訊協定（HTTP）設定。後端 HTTP 設定會套用至集區中的所有後端伺服器。

範例

範例 1：更新應用程式閘道的後端 HTTP 設定

PS C:\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayBackendHttpSettings -ApplicationGateway $AppGw -Name "Setting02" -Port 88 -Protocol "Http" -CookieBasedAffinity "Disabled"

第一個命令會取得名為 ApplicationGateway01 的應用程式閘道，該閘道屬於名為 ResourceGroup01 的資源群組，並將它儲存在$AppGw變數中。第二個命令會更新 $AppGw 變數中應用程式閘道的 HTTP 設定，以使用埠 88、HTTP 通訊協定，並啟用 Cookie 型親和性。

參數

-AffinityCookieName

要用於同質 Cookie 的 Cookie 名稱

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

-ApplicationGateway

指定此 Cmdlet 與後端 HTTP 設定建立關聯的應用程式閘道物件。

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

-AuthenticationCertificates

指定應用程式閘道的驗證憑證。

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

-ConnectionDraining

後端 HTTP 設定資源的連線清空。

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

-CookieBasedAffinity

指定後端伺服器集區應啟用或停用 Cookie 型親和性。此參數可接受的值為：Disabled 或 Enabled。

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

-DefaultProfile

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

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

-HostName

設定要傳送至後端伺服器的主機標頭。

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

-Name

指定後端 HTTP 設定物件的名稱。

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

-Path

路徑，應該作為所有 HTTP 要求的前置詞。如果沒有針對此參數提供任何值，則不會加上路徑前置詞。

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

-PickHostNameFromBackendAddress

如果應該從後端伺服器的主機名中挑選主機標頭，則為旗標。

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

-Port

指定要用於後端伺服器集區中每部伺服器的埠。

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

-Probe

指定要與後端 HTTP 設定建立關聯的探查。

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

-ProbeId

指定要與後端 HTTP 設定產生關聯的探查標識碼。

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

-Protocol

指定要用於應用程式閘道與後端伺服器之間通訊的通訊協定。此參數可接受的值為：Http 和 Https。此參數區分大小寫。

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

-RequestTimeout

指定要求逾時值。

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

-TrustedRootCertificate

應用程式閘道受信任的跟證書

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

輸入

PSApplicationGateway

參數：ApplicationGateway （ByValue）

輸出