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
Sorties
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour