Dela via

New-AzApplicationGatewayHttpListener

  • Referens
Modul:
Az.Network

Skapar en HTTP-lyssnare för en programgateway.

Syntax

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

Cmdleten New-AzApplicationGatewayHttpListener skapar en HTTP-lyssnare för en Azure-programgateway.

Exempel

Exempel 1: Skapa en HTTP-lyssnare

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

Det här kommandot skapar en HTTP-lyssnare med namnet Listener01 och lagrar resultatet i variabeln med namnet $Listener.

Exempel 2: Skapa en HTTP-lyssnare med SSL

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

Det här kommandot skapar en HTTP-lyssnare som använder SSL-avlastning och tillhandahåller SSL-certifikatet i variabeln $SSLCert 01. Kommandot lagrar resultatet i variabeln med namnet $Listener.

Exempel 3: Skapa en HTTP-lyssnare med brandväggsprincip

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

Det här kommandot skapar en HTTP-lyssnare med namnet Listener01, FirewallPolicy som $firewallPolicy och lagrar resultatet i variabeln med namnet $Listener.

Exempel 4: Lägg till en HTTPS-lyssnare med SSL och HostNames

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

Det här kommandot skapar en HTTP-lyssnare som använder SSL-avlastning och tillhandahåller SSL-certifikatet i variabeln $SSLCert 01 tillsammans med två HostNames. Kommandot lagrar resultatet i variabeln med namnet $Listener.

Parametrar

-CustomErrorConfiguration

Kundfel för en programgateway

Typ:PSApplicationGatewayCustomError[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FirewallPolicy

Anger objektreferensen till en brandväggsprincip på den översta nivån. Objektreferensen kan skapas med hjälp av New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" En brandväggsprincip som skapats med hjälp av kommandot ovan kan refereras på sökvägsregelnivå. han ovan kommandot skulle skapa en standard principinställningar och hanterade regler. I stället för standardvärdena kan användarna ange PrincipInställningar, ManagedRules med hjälp av New-AzApplicationGatewayFirewallPolicySettings respektive New-AzApplicationGatewayFirewallPolicyManagedRules.

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FirewallPolicyId

Anger ID för en befintlig brandväggsresurs för webbprogram på toppnivå. Brandväggsprincip-ID:t kan returneras med hjälp av cmdleten Get-AzApplicationGatewayWebApplicationFirewallPolicy. När vi har ID:t kan du använda parametern FirewallPolicyId i stället för FirewallPolicy parameter. Till exempel: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FrontendIPConfiguration

Anger IP-konfigurationsobjekt för klientdelen för HTTP-lyssnaren.

Typ:PSApplicationGatewayFrontendIPConfiguration
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FrontendIPConfigurationId

Anger ID för IP-konfigurationen på klientsidan för HTTP-lyssnaren.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FrontendPort

Anger klientdelsporten för HTTP-lyssnaren.

Typ:PSApplicationGatewayFrontendPort
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FrontendPortId

Anger ID för klientdelsportobjektet för HTTP-lyssnaren.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HostName

Anger värdnamnet för programgatewayens HTTP-lyssnare.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HostNames

Värdnamn

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på HTTP-lyssnaren som den här cmdleten skapar.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Protocol

Anger det protokoll som HTTP-lyssnaren använder.

Typ:String
Godkända värden:Http, Https
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RequireServerNameIndication

Typ:String
Godkända värden:true, false
Position:Named
Standardvärde:true
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SslCertificate

Anger SSL-certifikatobjektet för HTTP-lyssnaren.

Typ:PSApplicationGatewaySslCertificate
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SslCertificateId

Anger ID för SSL-certifikatet för HTTP-lyssnaren.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SslProfile

SslProfile

Typ:PSApplicationGatewaySslProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SslProfileId

SslProfileId

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

PSApplicationGatewayHttpListener