你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzApplicationGatewayBackendHttpSetting

更新应用程序网关的后端 HTTP 设置。

语法

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>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

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 设置。 (自动生成)

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

参数

-AffinityCookieName

要用于关联 Cookie 的 Cookie 名称

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ApplicationGateway

指定此 cmdlet 与此 cmdlet 关联的后端 HTTP 设置的应用程序网关对象。

类型:PSApplicationGateway
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-AuthenticationCertificates

指定应用程序网关的身份验证证书。

类型: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
别名:AzContext, 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 设置关联的探测的 ID。

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

应用程序网关受信任的根证书

类型:PSApplicationGatewayTrustedRootCertificate[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

PSApplicationGateway

输出

PSApplicationGateway