Partager via


Add-AzApplicationGatewayHttpListener

Ajoute un écouteur HTTP à une passerelle d’application.

Syntaxe

Add-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>]
Add-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 Add-AzApplicationGatewayHttpListener ajoute un écouteur HTTP à une passerelle d’application.

Exemples

Exemple 1 : Ajouter un écouteur HTTP

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$Appgw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "listener01" -Protocol "Http" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01

La première commande obtient la passerelle Application Gateway et la stocke dans la variable $AppGw. La deuxième commande ajoute l’écouteur HTTP à la passerelle d’application.

Exemple 2 : Ajouter un écouteur HTTPS avec SSL

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01

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, à la passerelle d’application.

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

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-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 à laquelle cette applet de commande ajoute un é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’objet de ressource 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 IP front-end 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 l’objet de 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 ajoute un é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 du port frontal ajouté par cette commande.

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 de l’écouteur HTTP. HTTP et HTTPS sont pris en charge.

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

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. Doit être spécifié si HTTPS est choisi comme protocole d’écouteur.

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 de l’écouteur HTTP. Doit être spécifié si HTTPS est choisi comme protocole d’écouteur.

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