Dela via

New-AzApplicationGatewayHttpListener

Modul:
Az.Network Module

Skapar en HTTP-lyssnare för en programgateway.

Syntax

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

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

Parameteregenskaper

Typ:

PSApplicationGatewayCustomError[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 cmdleten 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.

Parameteregenskaper

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 parametern FirewallPolicy . Till exempel: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FrontendIPConfiguration

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

Parameteregenskaper

Typ:PSApplicationGatewayFrontendIPConfiguration
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FrontendIPConfigurationId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FrontendPort

Anger klientdelsporten för HTTP-lyssnaren.

Parameteregenskaper

Typ:PSApplicationGatewayFrontendPort
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FrontendPortId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-HostName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-HostNames

Värdnamn

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Protocol

Anger det protokoll som HTTP-lyssnaren använder.

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Http, Https
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RequireServerNameIndication

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

Parameteregenskaper

Typ:String
Standardvärde:true
Godkända värden:true, false
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SslCertificate

Anger SSL-certifikatobjektet för HTTP-lyssnaren.

Parameteregenskaper

Typ:PSApplicationGatewaySslCertificate
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SslCertificateId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SslProfile

SslProfile

Parameteregenskaper

Typ:PSApplicationGatewaySslProfile
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SslProfileId

SslProfileId

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

None

Utdata

PSApplicationGatewayHttpListener