Add-AzApplicationGatewayHttpListener
Ajoute un écouteur HTTP à une passerelle d’application.
Syntaxe
SetByResourceId
Add-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-Name <String>
-Protocol <String>
[-FrontendIPConfigurationId <String>]
[-FrontendPortId <String>]
[-SslCertificateId <String>]
[-FirewallPolicyId <String>]
[-SslProfileId <String>]
[-HostName <String>]
[-HostNames <String[]>]
[-RequireServerNameIndication <String>]
[-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SetByResource
Add-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-Name <String>
-Protocol <String>
[-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
[-FrontendPort <PSApplicationGatewayFrontendPort>]
[-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
[-SslCertificate <PSApplicationGatewaySslCertificate>]
[-SslProfile <PSApplicationGatewaySslProfile>]
[-HostName <String>]
[-HostNames <String[]>]
[-RequireServerNameIndication <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.
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
-CustomErrorConfiguration
Erreur du client d’une 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
-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
-FirewallPolicy
Pare-feuPolitique
Propriétés du paramètre
Jeux de paramètres
SetByResource
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-FirewallPolicyId
FirewallPolicyId
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
SetByResourceId
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-FrontendIPConfiguration
Spécifie l’objet de ressource IP frontale de la passerelle d’application.
Propriétés du paramètre
Jeux de paramètres
SetByResource
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-FrontendIPConfigurationId
Spécifie l’ID IP front-end de la passerelle d’application.
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
SetByResourceId
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-FrontendPort
Spécifie l’objet de port frontal de la passerelle d’application.
Propriétés du paramètre
Jeux de paramètres
SetByResource
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-FrontendPortId
Spécifie l’ID de port frontal de la passerelle d’application.
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
SetByResourceId
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-HostName
Spécifie le nom d’hôte auquel cette applet de commande ajoute un écouteur HTTP.
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
-HostNames
Les noms d’hôte
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 du port frontal ajouté par cette 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
-Protocol
Spécifie le protocole de l’écouteur HTTP.
Http et HTTPS sont pris en charge.
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
-RequireServerNameIndication
L’applet de commande Add-AzApplicationGatewayHttpListener ajoute un écouteur HTTP à une passerelle d’application.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Valeurs acceptées: true, 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
-SslCertificate
Spécifie le certificat SSL de l’écouteur HTTP.
Doit être spécifié si HTTPS est choisi comme protocole d’écouteur.
Propriétés du paramètre
Jeux de paramètres
SetByResource
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
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
SetByResourceId
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-SslProfile
SslProfile
Propriétés du paramètre
Jeux de paramètres
SetByResource
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-SslProfileId
SslProfileId
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
SetByResourceId
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