Set-AzApplicationGatewayBackendHttpSetting
Met à jour les paramètres HTTP principaux d’une passerelle d’application.
Syntaxe
Default (Par défaut)
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>]
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. (autogenerated)
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é
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ApplicationGateway
Spécifie un objet application gateway auquel cette applet de commande associe les paramètres HTTP principaux.
Propriétés du paramètre
Type: PSApplicationGateway
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: True Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-AuthenticationCertificates
Spécifie les certificats d’authentification pour la passerelle d’application.
Propriétés du paramètre
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ConnectionDraining
Drainage de connexion de la ressource de paramètres http back-end.
Propriétés du paramètre
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: 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é.
Propriétés du paramètre
Type: String
Valeur par défaut: None Valeurs acceptées: Enabled, Disabled Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DedicatedBackendConnection
Activez ou désactivez la connexion dédiée par serveur principal. La valeur par défaut est false.
Propriétés du paramètre
Type: Nullable<T> [ Boolean ]
Valeur par défaut: False Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Propriétés du paramètre
Type: IAzureContextContainer
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-HostName
Définit l’en-tête de l’hôte à envoyer aux serveurs principaux.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Name
Spécifie le nom de l’objet de paramètres HTTP back-end.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: 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é.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: 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.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Port
Spécifie le port à utiliser pour chaque serveur dans le pool de serveurs principaux.
Propriétés du paramètre
Type: Int32
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Probe
Spécifie une sonde à associer aux paramètres HTTP principaux.
Propriétés du paramètre
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ProbeId
Spécifie l’ID de la sonde à associer aux paramètres HTTP principaux.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: 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.
Propriétés du paramètre
Type: String
Valeur par défaut: None Valeurs acceptées: Http, Https Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-RequestTimeout
Spécifie une valeur de délai d’attente de requête.
Propriétés du paramètre
Type: Int32
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-SniName
Spécifiez une valeur SNI qui corresponde au nom commun du certificat sur le backend. Par défaut, la passerelle d’application utilise l’en-tête d’hôte de la requête entrante comme SNI. La valeur par défaut est Null.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-TrustedRootCertificate
Certificats racines approuvés d’Application Gateway
Propriétés du paramètre
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ValidateCertChainAndExpiry
Vérifiez ou ignorez les validations en chaîne et d’expiration du certificat sur le serveur principal. La valeur par défaut est true.
Propriétés du paramètre
Type: Nullable<T> [ Boolean ]
Valeur par défaut: True Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ValidateSNI
Lorsqu’il est activé, vérifie si le nom commun du certificat fourni par le serveur principal correspond à la valeur SNI (Server Name Indication). La valeur par défaut est true.
Propriétés du paramètre
Type: Nullable<T> [ Boolean ]
Valeur par défaut: True Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties
