Set-AzureRmApplicationGatewayBackendHttpSettings

Uppdateringar HTTP-inställningar för serverdelen för en programgateway.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Cmdleten Set-AzureRmApplicationGatewayBackendHttp Inställningar uppdaterar HTTP-inställningarna (Hypertext Transfer Protocol) för en Azure-programgateway. HTTP-inställningar för serverdelen tillämpas på alla serverdelsservrar i en pool.

Exempel

Exempel 1: Uppdatera HTTP-inställningarna för serverdelen för en programgateway

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

Det första kommandot hämtar programgatewayen med namnet ApplicationGateway01 som tillhör resursgruppen med namnet ResourceGroup01 och lagrar den i variabeln $AppGw. Det andra kommandot uppdaterar HTTP-inställningarna för programgatewayen i variabeln $AppGw för att använda port 88, HTTP-protokollet och aktiverar cookiebaserad tillhörighet.

Parametrar

-AffinityCookieName

Cookienamn som ska användas för tillhörighetscookien

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationGateway

Anger ett programgatewayobjekt som den här cmdleten associerar HTTP-inställningar för serverdelen med.

Typ:PSApplicationGateway
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AuthenticationCertificates

Anger autentiseringscertifikat för programgatewayen.

Typ:List<T>[PSApplicationGatewayAuthenticationCertificate]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConnectionDraining

Anslut jondränering av resursen för http-inställningar för serverdelen.

Typ:PSApplicationGatewayConnectionDraining
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CookieBasedAffinity

Anger om cookiebaserad tillhörighet ska aktiveras eller inaktiveras för serverdelsserverpoolen. De godtagbara värdena för den här parametern är: Inaktiverade eller aktiverade.

Typ:String
Godkända värden:Enabled, Disabled
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HostName

Anger att värdhuvudet ska skickas till serverdelsservrarna.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på http-inställningsobjektet för serverdelen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Sökväg som ska användas som prefix för alla HTTP-begäranden. Om inget värde anges för den här parametern kommer ingen sökväg att prefixas.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PickHostNameFromBackendAddress

Flagga om värdhuvudet ska väljas från serverdelsserverns värdnamn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Port

Anger vilken port som ska användas för varje server i serverdelsserverpoolen.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Probe

Anger en avsökning som ska associeras med HTTP-inställningarna för serverdelen.

Typ:PSApplicationGatewayProbe
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ProbeId

Anger ID för avsökningen som ska associeras med HTTP-inställningarna för serverdelen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Protocol

Anger vilket protokoll som ska användas för kommunikation mellan programgatewayen och serverdelsservrarna. De godtagbara värdena för den här parametern är: Http och Https. Den här parametern är skiftlägeskänslig.

Typ:String
Godkända värden:Http, Https
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RequestTimeout

Anger ett timeout-värde för begäran.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TrustedRootCertificate

Betrodda rotcertifikat för Application Gateway

Typ:List<T>[PSApplicationGatewayTrustedRootCertificate]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSApplicationGateway

Parametrar: ApplicationGateway (ByValue)

Utdata

PSApplicationGateway