共用方式為


Set-AzApplicationGatewayBackendHttpSetting

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

語法

Default (預設值)

Set-AzApplicationGatewayBackendHttpSetting
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    -Port <Int32>
    -Protocol <String>
    -CookieBasedAffinity <String>
    [-RequestTimeout <Int32>]
    [-ConnectionDraining <PSApplicationGatewayConnectionDraining>]
    [-ProbeId <String>]
    [-Probe <PSApplicationGatewayProbe>]
    [-AuthenticationCertificates <PSApplicationGatewayAuthenticationCertificate[]>]
    [-TrustedRootCertificate <PSApplicationGatewayTrustedRootCertificate[]>]
    [-PickHostNameFromBackendAddress]
    [-HostName <String>]
    [-AffinityCookieName <String>]
    [-Path <String>]
    [-DedicatedBackendConnection <Boolean>]
    [-ValidateCertChainAndExpiry <Boolean>]
    [-ValidateSNI <Boolean>]
    [-SniName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Set-AzApplicationGatewayBackendHttpSetting Cmdlet 會更新 Azure 應用程式閘道的後端超文字傳輸通訊協定 (HTTP) 設定。 後端 HTTP 設定會套用至儲存區中的所有後端伺服器。

範例

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

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayBackendHttpSetting -ApplicationGateway $AppGw -Name "Setting02" -Port 88 -Protocol "Http" -CookieBasedAffinity "Disabled"

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

範例 2

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

Set-AzApplicationGatewayBackendHttpSetting -ApplicationGateway <PSApplicationGateway> -CookieBasedAffinity Enabled -Name 'Setting02' -Port 88 -Probe <PSApplicationGatewayProbe> -Protocol https -RequestTimeout <Int32>

參數

-AffinityCookieName

用於親和性 Cookie 的 Cookie 名稱

參數屬性

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

參數集

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

-ApplicationGateway

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

參數屬性

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

參數集

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

-AuthenticationCertificates

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

參數屬性

類型:

PSApplicationGatewayAuthenticationCertificate[]

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

參數集

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

-ConnectionDraining

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

參數屬性

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

參數集

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

-CookieBasedAffinity

指定是否應該為後端伺服器集區啟用或停用 Cookie 型親和性。 此參數的可接受值為:已停用或已啟用。

參數屬性

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

參數集

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

-DedicatedBackendConnection

啟用或停用每個後端伺服器的專用連線。 預設值設定為 false。

參數屬性

類型:

Nullable<T>[Boolean]

預設值:False
支援萬用字元: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

-HostName

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

參數屬性

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

參數集

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

-Name

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

參數屬性

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

參數集

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

-Path

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

參數屬性

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

參數集

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

-PickHostNameFromBackendAddress

如果應從後端伺服器的主機名稱中挑選主機標頭,則會標示。

參數屬性

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

參數集

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

-Port

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

參數屬性

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

參數集

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

-Probe

指定要與後端 HTTP 設定相關聯的探測。

參數屬性

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

參數集

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

-ProbeId

指定要與後端 HTTP 設定相關聯的探測 ID。

參數屬性

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

參數集

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

-Protocol

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

參數屬性

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

參數集

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

-RequestTimeout

指定要求逾時值。

參數屬性

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

參數集

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

-SniName

指定 SNI 值以符合後端憑證的通用名稱。 根據預設,應用程式閘道會使用傳入要求的主機標頭作為 SNI。 預設值為 null。

參數屬性

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

參數集

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

-TrustedRootCertificate

應用程式閘道信任的根憑證

參數屬性

類型:

PSApplicationGatewayTrustedRootCertificate[]

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

參數集

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

-ValidateCertChainAndExpiry

驗證或略過後端伺服器上憑證的鏈結和到期驗證。 預設值設定為 true。

參數屬性

類型:

Nullable<T>[Boolean]

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

參數集

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

-ValidateSNI

啟用時,會驗證後端伺服器所提供憑證的「通用名稱」是否符合「伺服器名稱指示 (SNI)」值。 預設值為 True。

參數屬性

類型:

Nullable<T>[Boolean]

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

參數集

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

CommonParameters

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

輸入

PSApplicationGateway

輸出

PSApplicationGateway