Partager via


Set-AzApplicationGatewayHttpListener

Modifie un écouteur HTTP pour une passerelle d’application.

Syntaxe

Set-AzApplicationGatewayHttpListener
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-FrontendIPConfigurationId <String>]
   [-FrontendPortId <String>]
   [-SslCertificateId <String>]
   [-FirewallPolicyId <String>]
   [-SslProfileId <String>]
   [-HostName <String>]
   [-HostNames <String[]>]
   [-RequireServerNameIndication <String>]
   -Protocol <String>
   [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzApplicationGatewayHttpListener
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
   [-FrontendPort <PSApplicationGatewayFrontendPort>]
   [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
   [-SslCertificate <PSApplicationGatewaySslCertificate>]
   [-SslProfile <PSApplicationGatewaySslProfile>]
   [-HostName <String>]
   [-HostNames <String[]>]
   [-RequireServerNameIndication <String>]
   -Protocol <String>
   [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzApplicationGatewayHttpListener modifie un écouteur HTTP pour une passerelle d’application Azure.

Exemples

Exemple 1 : Définir un écouteur HTTP

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80

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 définit l’écouteur HTTP de la passerelle pour utiliser la configuration frontale stockée dans $FIP 01 avec le protocole HTTP sur le port 80.

Exemple 2 : Ajouter un écouteur HTTPS avec SSL et HostNames

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com,www.microsoft.com"

La première commande obtient la passerelle Application Gateway et la stocke dans la variable $AppGw. La deuxième commande ajoute l’écouteur, qui utilise le protocole HTTPS, avec des certificats SSL et des noms d’hôte, à la passerelle d’application.

Paramètres

-ApplicationGateway

Spécifie la passerelle d’application avec laquelle cette applet de commande associe l’écouteur HTTP.

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

-CustomErrorConfiguration

Erreur du client d’une passerelle d’application

Type:PSApplicationGatewayCustomError[]
Position:Named
Valeur par défaut:None
Obligatoire:False
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

-FirewallPolicy

FirewallPolicy

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

-FirewallPolicyId

FirewallPolicyId

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

-FrontendIPConfiguration

Spécifie l’adresse IP frontale de la passerelle d’application.

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

-FrontendIPConfigurationId

Spécifie l’ID de l’adresse IP frontale de la passerelle d’application.

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

-FrontendPort

Spécifie le port frontal de la passerelle d’application.

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

-FrontendPortId

Spécifie l’ID de port frontal de la passerelle d’application.

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

-HostName

Spécifie le nom d’hôte auquel cette applet de commande envoie l’écouteur HTTP.

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

-HostNames

Les noms d’hôte

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’écouteur HTTP.

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

-Protocol

Spécifie le protocole utilisé par l’écouteur HTTP. Les valeurs valides pour ce paramètre sont :

  • Http
  • Https
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

-RequireServerNameIndication

Spécifie si l’applet de commande requiert une indication de nom de serveur. Les valeurs acceptables pour ce paramètre sont : true ou false.

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

-SslCertificate

Spécifie le certificat SSL de l’écouteur HTTP.

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

-SslCertificateId

Spécifie l’ID de certificat SSL (Secure Socket Layer) de l’écouteur HTTP.

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

-SslProfile

SslProfile

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

-SslProfileId

SslProfileId

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

Entrées

PSApplicationGateway

Sorties

PSApplicationGateway