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 |