Partager via


New-AzApplicationGatewayBackendHttpSetting

Crée un paramètre HTTP principal pour une passerelle d’application.

Syntaxe

Default (Par défaut)

New-AzApplicationGatewayBackendHttpSetting
    -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 New-AzApplicationGatewayBackendHttpSetting crée des paramètres HTTP principaux pour une passerelle d’application. Les paramètres HTTP principaux sont appliqués à tous les serveurs principaux d’un pool.

Exemples

Exemple 1 : Créer des paramètres HTTP principaux

$Setting = New-AzApplicationGatewayBackendHttpSetting -Name "Setting01" -Port 80 -Protocol Http -CookieBasedAffinity Disabled

Cette commande crée des paramètres HTTP principaux nommés Setting01 sur le port 80, à l’aide du protocole HTTP, avec l’affinité basée sur les cookies désactivée. Les paramètres sont stockés dans la variable $Setting.

Exemple 2

Crée un paramètre HTTP principal pour une passerelle d’application. (autogenerated)

New-AzApplicationGatewayBackendHttpSetting -CookieBasedAffinity Enabled -Name 'Setting01' -PickHostNameFromBackendAddress -Port 80 -Probe <PSApplicationGatewayProbe> -Protocol http -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

-AuthenticationCertificates

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

Propriétés du paramètre

Type:

PSApplicationGatewayAuthenticationCertificate[]

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

-ConnectionDraining

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

Propriétés du paramètre

Type:PSApplicationGatewayConnectionDraining
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

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

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 des paramètres HTTP principaux créés par cette applet de commande.

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 du 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 au pool de serveurs principaux.

Propriétés du paramètre

Type:PSApplicationGatewayProbe
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

-ProbeId

Spécifie l’ID de la sonde à associer au pool de 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

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

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

Type:

PSApplicationGatewayTrustedRootCertificate[]

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

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

Entrées

None

Sorties

PSApplicationGatewayBackendHttpSettings