Freigeben über


Set-AzApplicationGatewayBackendHttpSetting

Aktualisiert Back-End-HTTP-Einstellungen für ein Anwendungsgateway.

Syntax

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

Beschreibung

Das Cmdlet Set-AzApplicationGatewayBackendHttpSetting aktualisiert die Http-Einstellungen (Back-End Hypertext Transfer Protocol) für ein Azure-Anwendungsgateway. Back-End-HTTP-Einstellungen werden auf alle Back-End-Server in einem Pool angewendet.

Beispiele

Beispiel 1: Aktualisieren der Back-End-HTTP-Einstellungen für ein Anwendungsgateway

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

Der erste Befehl ruft das Anwendungsgateway01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der variablen $AppGw. Der zweite Befehl aktualisiert die HTTP-Einstellungen des Anwendungsgateways in der $AppGw Variablen, um Port 88 zu verwenden, das HTTP-Protokoll und aktiviert cookiebasierte Affinität.

Beispiel 2

Aktualisiert Back-End-HTTP-Einstellungen für ein Anwendungsgateway. (automatisch generiert)

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

Parameter

-AffinityCookieName

Cookiename, der für das Affinitätscookie verwendet werden soll

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationGateway

Gibt ein Anwendungsgatewayobjekt an, dem dieses Cmdlet HTTP-Einstellungen des Back-End-Objekts zuordnet.

Typ:PSApplicationGateway
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AuthenticationCertificates

Gibt Authentifizierungszertifikate für das Anwendungsgateway an.

Typ:PSApplicationGatewayAuthenticationCertificate[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConnectionDraining

Verbindungsentwässerung der Back-End-HTTP-Einstellungsressource.

Typ:PSApplicationGatewayConnectionDraining
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CookieBasedAffinity

Gibt an, ob die cookiebasierte Affinität für den Back-End-Serverpool aktiviert oder deaktiviert werden soll. Die zulässigen Werte für diesen Parameter sind: Deaktiviert oder aktiviert.

Typ:String
Zulässige Werte:Enabled, Disabled
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HostName

Legt den Hostheader fest, der an die Back-End-Server gesendet werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des Back-End-HTTP-Einstellungsobjekts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Pfad, der als Präfix für alle HTTP-Anforderungen verwendet werden soll. Wenn für diesen Parameter kein Wert angegeben wird, wird kein Pfad vorangestellt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PickHostNameFromBackendAddress

Flag, wenn der Hostheader aus dem Hostnamen des Back-End-Servers ausgewählt werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Port

Gibt den Port an, der für jeden Server im Back-End-Serverpool verwendet werden soll.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Probe

Gibt einen Prüfpunkt an, der den Back-End-HTTP-Einstellungen zugeordnet werden soll.

Typ:PSApplicationGatewayProbe
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProbeId

Gibt die ID des Prüfpunkts an, der den Back-End-HTTP-Einstellungen zugeordnet werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Protocol

Gibt das Protokoll an, das für die Kommunikation zwischen dem Anwendungsgateway und back-End-Servern verwendet werden soll. Die zulässigen Werte für diesen Parameter sind: Http und Https. Bei diesem Parameter wird die Groß-/Kleinschreibung beachtet.

Typ:String
Zulässige Werte:Http, Https
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RequestTimeout

Gibt einen Anforderungstimeoutwert an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TrustedRootCertificate

Vertrauenswürdige Stammzertifikate des Anwendungsgateways

Typ:PSApplicationGatewayTrustedRootCertificate[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSApplicationGateway

Ausgaben

PSApplicationGateway