Partager via

New-AzApplicationGatewayHttpListener

  • Référence
Module:
Az.Network

Crée un écouteur HTTP pour une passerelle d’application.

Syntaxe

New-AzApplicationGatewayHttpListener
   -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>]
New-AzApplicationGatewayHttpListener
   -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 New-AzApplicationGatewayHttpListener crée un écouteur HTTP pour une passerelle d’application Azure.

Exemples

Exemple 1 : Créer un écouteur HTTP

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01

Cette commande crée un écouteur HTTP nommé Listener01 et stocke le résultat dans la variable nommée $Listener.

Exemple 2 : Créer un écouteur HTTP avec SSL

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01

Cette commande crée un écouteur HTTP qui utilise le déchargement SSL et fournit le certificat SSL dans la variable $SSLCert 01. La commande stocke le résultat dans la variable nommée $Listener.

Exemple 3 : Créer un écouteur HTTP avec une stratégie de pare-feu

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -FirewallPolicy $firewallPolicy

Cette commande crée un écouteur HTTP nommé Listener01, FirewallPolicy en tant que $firewallPolicy et stocke le résultat dans la variable nommée $Listener.

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

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"

Cette commande crée un écouteur HTTP qui utilise le déchargement SSL et fournit le certificat SSL dans la variable $SSLCert 01, ainsi que deux noms d’hôte. La commande stocke le résultat dans la variable nommée $Listener.

Paramètres

-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

Spécifie la référence d’objet à une stratégie de pare-feu de niveau supérieur. La référence d’objet peut être créée à l’aide de New-AzApplicationGatewayWebApplicationFirewallPolicy applet de commande. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name « wafPolicy1 » -ResourceGroup « rgName » Une stratégie de pare-feu créée à l’aide du commandlet ci-dessus peut être référencée au niveau d’une règle de chemin d’accès. la commande ci-dessus créerait des paramètres de stratégie par défaut et des règles gérées. Au lieu des valeurs par défaut, les utilisateurs peuvent spécifier PolicySettings, ManagedRules à l’aide de New-AzApplicationGatewayFirewallPolicySettings et de New-AzApplicationGatewayFirewallPolicyManagedRules respectivement.

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

Spécifie l’ID d’une ressource de pare-feu d’application web de niveau supérieur existante. Les ID de stratégie de pare-feu peuvent être retournés à l’aide de l’applet de commande Get-AzApplicationGatewayWebApplicationFirewallPolicy. Une fois que nous avons l’ID, vous pouvez utiliser paramètre FirewallPolicyId au lieu de paramètre FirewallPolicy. Par exemple : -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

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 configuration IP frontale pour l’écouteur HTTP.

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 la configuration IP frontale pour 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

-FrontendPort

Spécifie le port frontal de l’écouteur HTTP.

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 l’objet de port frontal pour 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

-HostName

Spécifie le nom d’hôte de l’écouteur HTTP application gateway.

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

Noms d’hôtes

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 créé par cette applet de 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 utilisé par l’écouteur HTTP.

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:true
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SslCertificate

Spécifie l’objet de certificat SSL pour 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 du certificat SSL pour 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

None

Sorties

PSApplicationGatewayHttpListener