Partager via


Set-AzApplicationGatewayBackendHttpSetting

Met à jour les paramètres HTTP principaux d’une passerelle d’application.

Syntaxe

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

Description

L’applet de commande Set-AzApplicationGatewayBackendHttpSetting met à jour les paramètres HTTP (Back-End Hypertext Transfer Protocol) d’une passerelle d’application Azure. Les paramètres HTTP principaux sont appliqués à tous les serveurs principaux d’un pool.

Exemples

Exemple 1 : Mettre à jour les paramètres HTTP principaux d’une passerelle d’application

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

La première commande obtient la passerelle d’application nommée ApplicationGateway01 qui appartient au groupe de ressources nommé ResourceGroup01 et la stocke dans la variable $AppGw. La deuxième commande met à jour les paramètres HTTP de la passerelle d’application dans la variable $AppGw pour utiliser le port 88, le protocole HTTP et active l’affinité basée sur les cookies.

Exemple 2

Met à jour les paramètres HTTP principaux d’une passerelle d’application. (généré automatiquement)

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

Paramètres

-AffinityCookieName

Nom du cookie à utiliser pour le cookie d’affinité

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationGateway

Spécifie un objet application gateway auquel cette applet de commande associe les paramètres HTTP principaux.

Type:PSApplicationGateway
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-AuthenticationCertificates

Spécifie les certificats d’authentification pour la passerelle d’application.

Type:PSApplicationGatewayAuthenticationCertificate[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConnectionDraining

Drainage de connexion de la ressource de paramètres http back-end.

Type:PSApplicationGatewayConnectionDraining
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CookieBasedAffinity

Spécifie si l’affinité basée sur les cookies doit être activée ou désactivée pour le pool de serveurs principaux. Les valeurs acceptables pour ce paramètre sont : Désactivé ou Activé.

Type:String
Valeurs acceptées:Enabled, Disabled
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-HostName

Définit l’en-tête de l’hôte à envoyer aux serveurs principaux.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom de l’objet de paramètres HTTP back-end.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Chemin qui doit être utilisé comme préfixe pour toutes les requêtes HTTP. Si aucune valeur n’est fournie pour ce paramètre, aucun chemin d’accès n’est préfixé.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PickHostNameFromBackendAddress

Indicateur si l’en-tête de l’hôte doit être sélectionné à partir du nom d’hôte du serveur principal.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Port

Spécifie le port à utiliser pour chaque serveur dans le pool de serveurs principaux.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Probe

Spécifie une sonde à associer aux paramètres HTTP principaux.

Type:PSApplicationGatewayProbe
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ProbeId

Spécifie l’ID de la sonde à associer aux paramètres HTTP principaux.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Protocol

Spécifie le protocole à utiliser pour la communication entre la passerelle d’application et les serveurs principaux. Les valeurs acceptables pour ce paramètre sont : Http et Https. Ce paramètre respecte la casse.

Type:String
Valeurs acceptées:Http, Https
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RequestTimeout

Spécifie une valeur de délai d’attente de requête.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TrustedRootCertificate

Certificats racines approuvés d’Application Gateway

Type:PSApplicationGatewayTrustedRootCertificate[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSApplicationGateway

Sorties

PSApplicationGateway