Set-AzureRmApplicationGatewayBackendHttpSettings

Référence

Module:: AzureRM.Network

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

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

L’applet de commande Set-AzureRmApplicationGatewayBackendHttpSettings 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

PS C:\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayBackendHttpSettings -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.

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:	List<T>[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:	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:	List<T>[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

Paramètres : ApplicationGateway (ByValue)

Sorties