Delen via

Set-AzApplicationGatewayHttpListener

Module:
Az.Network Module

Hiermee wijzigt u een HTTP-listener voor een toepassingsgateway.

Syntaxis

SetByResourceId 

Set-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 

Set-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 Set-AzApplicationGatewayHttpListener wijzigt een HTTP-listener voor een Azure-toepassingsgateway.

Voorbeelden

Voorbeeld 1: Een HTTP-listener instellen

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80

Met de eerste opdracht wordt de toepassingsgateway met de naam ApplicationGateway01 die deel uitmaakt van de resourcegroep ResourceGroup01, opgeslagen in de variabele $AppGw. Met de tweede opdracht stelt u de HTTP-listener voor de gateway in om de front-endconfiguratie te gebruiken die is opgeslagen in $FIP 01 met het HTTP-protocol op poort 80.

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

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-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 waarmee deze cmdlet de HTTP-listener koppelt.

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

Firewall-beleid

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-adres van de toepassingsgateway.

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 id van het front-end-IP-adres van de toepassingsgateway.

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 de front-endpoort 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 waarnaar deze cmdlet de HTTP-listener verzendt.

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 van de HTTP-listener.

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 dat de HTTP-listener gebruikt. De acceptabele waarden voor deze parameter zijn:

  • Http
  • Https

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

Hiermee geeft u op of voor de cmdlet een servernaamindicatie is vereist. De acceptabele waarden voor deze parameter zijn: waar of onwaar.

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.

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 (Secure Socket Layer) van de HTTP-listener 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

-SslProfile

SslProfile

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