Udostępnij za pośrednictwem


Set-AzureRmApplicationGatewayBackendHttpSettings

Aktualizuje ustawienia protokołu HTTP zaplecza dla bramy aplikacji.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Set-AzureRmApplicationGatewayBackendHttpSettings aktualizuje ustawienia protokołu HTTP (Hypertext Transfer Protocol) zaplecza dla bramy aplikacji platformy Azure. Ustawienia http zaplecza są stosowane do wszystkich serwerów zaplecza w puli.

Przykłady

Przykład 1. Aktualizowanie ustawień protokołu HTTP zaplecza dla bramy aplikacji

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

Pierwsze polecenie pobiera bramę aplikacji o nazwie ApplicationGateway01, która należy do grupy zasobów o nazwie ResourceGroup01 i przechowuje ją w zmiennej $AppGw. Drugie polecenie aktualizuje ustawienia HTTP bramy aplikacji w zmiennej $AppGw, aby używać portu 88, protokołu HTTP i umożliwia koligację opartą na plikach cookie.

Parametry

-AffinityCookieName

Nazwa pliku cookie do użycia dla pliku cookie koligacji

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationGateway

Określa obiekt bramy aplikacji, z którym to polecenie cmdlet kojarzy ustawienia HTTP zaplecza.

Typ:PSApplicationGateway
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-AuthenticationCertificates

Określa certyfikaty uwierzytelniania dla bramy aplikacji.

Typ:List<T>[PSApplicationGatewayAuthenticationCertificate]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ConnectionDraining

Opróżnianie połączenia zasobu ustawień http zaplecza.

Typ:PSApplicationGatewayConnectionDraining
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CookieBasedAffinity

Określa, czy koligacja oparta na plikach cookie powinna być włączona, czy wyłączona dla puli serwerów zaplecza. Dopuszczalne wartości tego parametru to: Wyłączone lub Włączone.

Typ:String
Dopuszczalne wartości:Enabled, Disabled
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HostName

Ustawia nagłówek hosta, który ma być wysyłany do serwerów zaplecza.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę obiektu ustawień HTTP zaplecza.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Ścieżka, która powinna być używana jako prefiks dla wszystkich żądań HTTP. Jeśli dla tego parametru nie zostanie podana żadna wartość, ścieżka nie zostanie poprzedzona prefiksem.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PickHostNameFromBackendAddress

Flaga, jeśli nagłówek hosta powinien zostać wybrany z nazwy hosta serwera zaplecza.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Port

Określa port używany dla każdego serwera w puli serwerów zaplecza.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Probe

Określa sondę do skojarzenia z ustawieniami protokołu HTTP zaplecza.

Typ:PSApplicationGatewayProbe
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProbeId

Określa identyfikator sondy do skojarzenia z ustawieniami http zaplecza.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Protocol

Określa protokół używany do komunikacji między bramą aplikacji a serwerami zaplecza. Dopuszczalne wartości tego parametru to: Http i Https. W tym parametrze jest uwzględniana wielkość liter.

Typ:String
Dopuszczalne wartości:Http, Https
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RequestTimeout

Określa wartość limitu czasu żądania.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TrustedRootCertificate

Zaufane certyfikaty główne usługi Application Gateway

Typ:List<T>[PSApplicationGatewayTrustedRootCertificate]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSApplicationGateway

Parametry: ApplicationGateway (ByValue)

Dane wyjściowe

PSApplicationGateway