Partager via

New-AzApplicationGatewayHttpListener

Module:
Az.Network Module

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

Syntaxe

SetByResourceId 

New-AzApplicationGatewayHttpListener
    -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 

New-AzApplicationGatewayHttpListener
    -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 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

Propriétés du paramètre

Type:

PSApplicationGatewayCustomError[]

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

-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

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 de l’applet de commande 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.

Propriétés du paramètre

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

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

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 le paramètre FirewallPolicyId au lieu du paramètre FirewallPolicy . Par exemple : -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

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

Propriétés du paramètre

Type:PSApplicationGatewayFrontendIPConfiguration
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

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 de la configuration IP frontale pour l’é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

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 le port frontal de l’écouteur HTTP.

Propriétés du paramètre

Type:PSApplicationGatewayFrontendPort
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

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

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 de l’écouteur HTTP application gateway.

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

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

Propriétés du paramètre

Type:String
Valeur par défaut:true
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 l’objet de certificat SSL pour l’écouteur HTTP.

Propriétés du paramètre

Type:PSApplicationGatewaySslCertificate
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

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 du certificat SSL pour l’é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

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

Type:PSApplicationGatewaySslProfile
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

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.

Entrées

None

Sorties

PSApplicationGatewayHttpListener