Delen via


Add-AzApplicationGatewayHttpListener

Hiermee voegt u een HTTP-listener toe aan een toepassingsgateway.

Syntaxis

SetByResourceId

Add-AzApplicationGatewayHttpListener
    -ApplicationGateway <PSApplicationGateway>
    -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

Add-AzApplicationGatewayHttpListener
    -ApplicationGateway <PSApplicationGateway>
    -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

De cmdlet Add-AzApplicationGatewayHttpListener voegt een HTTP-listener toe aan een toepassingsgateway.

Voorbeelden

Voorbeeld 1: Een HTTP-listener toevoegen

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$Appgw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "listener01" -Protocol "Http" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01

Met de eerste opdracht wordt de toepassingsgateway opgeslagen in de $AppGw variabele. Met de tweede opdracht wordt de HTTP-listener toegevoegd aan de toepassingsgateway.

Voorbeeld 2: Een HTTPS-listener toevoegen met SSL

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01

Met de eerste opdracht wordt de toepassingsgateway opgeslagen in de $AppGw variabele. Met de tweede opdracht wordt de listener, die gebruikmaakt van het HTTPS-protocol, toegevoegd aan de toepassingsgateway.

Voorbeeld 3: Een HTTPS-listener toevoegen met SSL en HostNames

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"

Met de eerste opdracht wordt de toepassingsgateway opgeslagen in de $AppGw variabele. Met de tweede opdracht wordt de listener, die gebruikmaakt van het HTTPS-protocol, met SSL-certificaten en hostnamen, toegevoegd aan de toepassingsgateway.

Parameters

-ApplicationGateway

Hiermee geeft u de toepassingsgateway waaraan deze cmdlet een HTTP-listener toevoegt.

Parametereigenschappen

Type:PSApplicationGateway
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CustomErrorConfiguration

Fout van de klant van een toepassingsgateway

Parametereigenschappen

Type:

PSApplicationGatewayCustomError[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FirewallPolicy

FirewallPolicy

Parametereigenschappen

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FirewallPolicyId

FirewallPolicyId

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FrontendIPConfiguration

Hiermee geeft u het front-end-IP-resourceobject van de toepassingsgateway op.

Parametereigenschappen

Type:PSApplicationGatewayFrontendIPConfiguration
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FrontendIPConfigurationId

Hiermee geeft u de front-end-IP-id van de toepassingsgateway op.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FrontendPort

Hiermee geeft u het front-endpoortobject van de toepassingsgateway op.

Parametereigenschappen

Type:PSApplicationGatewayFrontendPort
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-FrontendPortId

Hiermee geeft u de front-endpoort-id van de toepassingsgateway op.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-HostName

Hiermee geeft u de hostnaam op waaraan deze cmdlet een HTTP-listener toevoegt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-HostNames

Hostnamen

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de naam op van de front-endpoort die met deze opdracht wordt toegevoegd.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Protocol

Hiermee geeft u het protocol van de HTTP-listener. Zowel HTTP als HTTPS worden ondersteund.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Http, Https
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RequireServerNameIndication

De cmdlet Add-AzApplicationGatewayHttpListener voegt een HTTP-listener toe aan een toepassingsgateway.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:true, false
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SslCertificate

Hiermee geeft u het SSL-certificaat van de HTTP-listener. Moet worden opgegeven als HTTPS is gekozen als listenerprotocol.

Parametereigenschappen

Type:PSApplicationGatewaySslCertificate
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SslCertificateId

Hiermee geeft u de SSL-certificaat-id van de HTTP-listener op. Moet worden opgegeven als HTTPS is gekozen als listenerprotocol.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SslProfile

Ssl-profiel

Parametereigenschappen

Type:PSApplicationGatewaySslProfile
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SslProfileId

SslProfileId

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSApplicationGateway

Uitvoerwaarden

PSApplicationGateway