Set-AzApplicationGatewayBackendHttpSetting
Aktualisiert Back-End-HTTP-Einstellungen für ein Anwendungsgateway.
Syntax
Default (Standard)
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>]
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. (autogenerated)
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
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ApplicationGateway
Gibt ein Anwendungsgatewayobjekt an, dem dieses Cmdlet HTTP-Einstellungen des Back-End-Objekts zuordnet.
Parametereigenschaften
Parametersätze
(All)
Position: Named Obligatorisch: True Wert aus Pipeline: True Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-AuthenticationCertificates
Gibt Authentifizierungszertifikate für das Anwendungsgateway an.
Parametereigenschaften
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ConnectionDraining
Verbindungsentwässerung der Back-End-HTTP-Einstellungsressource.
Parametereigenschaften
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: 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.
Parametereigenschaften
Typ: String
Standardwert: None Zulässige Werte: Enabled, Disabled Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-DedicatedBackendConnection
Aktivieren oder deaktivieren Sie die dedizierte Verbindung pro Backend-Server. Der Standardwert ist auf false festgelegt.
Parametereigenschaften
Typ: Nullable<T> [ Boolean ]
Standardwert: False Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-HostName
Legt den Hostheader fest, der an die Back-End-Server gesendet werden soll.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Name
Gibt den Namen des Back-End-HTTP-Einstellungsobjekts an.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: 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.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-PickHostNameFromBackendAddress
Flag, wenn der Hostheader aus dem Hostnamen des Back-End-Servers ausgewählt werden soll.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Port
Gibt den Port an, der für jeden Server im Back-End-Serverpool verwendet werden soll.
Parametereigenschaften
Typ: Int32
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Probe
Gibt einen Prüfpunkt an, der den Back-End-HTTP-Einstellungen zugeordnet werden soll.
Parametereigenschaften
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ProbeId
Gibt die ID des Prüfpunkts an, der den Back-End-HTTP-Einstellungen zugeordnet werden soll.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: 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.
Parametereigenschaften
Typ: String
Standardwert: None Zulässige Werte: Http, Https Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-RequestTimeout
Gibt einen Anforderungstimeoutwert an.
Parametereigenschaften
Typ: Int32
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-SniName
Geben Sie einen SNI-Wert an, der mit dem allgemeinen Namen des Zertifikats im Back-End übereinstimmt. Standardmäßig verwendet das Anwendungsgateway den Hostheader der eingehenden Anforderung als SNI. Der Standardwert ist NULL.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-TrustedRootCertificate
Vertrauenswürdige Stammzertifikate des Anwendungsgateways
Parametereigenschaften
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ValidateCertChainAndExpiry
Überprüfen oder überspringen Sie sowohl die Ketten- als auch die Ablaufvalidierung des Zertifikats auf dem Backend-Server. Der Standardwert ist auf true festgelegt.
Parametereigenschaften
Typ: Nullable<T> [ Boolean ]
Standardwert: True Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ValidateSNI
Wenn diese Option aktiviert ist, wird überprüft, ob der allgemeine Name des vom Back-End-Server bereitgestellten Zertifikats mit dem SNI-Wert (Server Name Indication) übereinstimmt. Der Standardwert ist wahr.
Parametereigenschaften
Typ: Nullable<T> [ Boolean ]
Standardwert: True Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters .
Ausgaben
