Freigeben über

New-AzApplicationGatewayHttpListener

  • Referenz
Modul:
Az.Network

Erstellt einen HTTP-Listener für ein Anwendungsgateway.

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

Beschreibung

Das Cmdlet New-AzApplicationGatewayHttpListener erstellt einen HTTP-Listener für ein Azure-Anwendungsgateway.

Beispiele

Beispiel 1: Erstellen eines HTTP-Listeners

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

Dieser Befehl erstellt einen HTTP-Listener namens Listener01 und speichert das Ergebnis in der Variablen mit dem Namen $Listener.

Beispiel 2: Erstellen eines HTTP-Listeners mit SSL

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

Mit diesem Befehl wird ein HTTP-Listener erstellt, der SSL-Offload verwendet und das SSL-Zertifikat in der Variablen $SSLCert 01 bereitstellt. Der Befehl speichert das Ergebnis in der Variablen mit dem Namen $Listener.

Beispiel 3: Erstellen eines HTTP-Listeners mit Firewallrichtlinie

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

Dieser Befehl erstellt einen HTTP-Listener namens Listener01, FirewallPolicy als $firewallPolicy und speichert das Ergebnis in der Variablen namens $Listener.

Beispiel 4: Hinzufügen eines HTTPS-Listeners mit SSL und HostNames

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

Mit diesem Befehl wird ein HTTP-Listener erstellt, der SSL-Offload verwendet und das SSL-Zertifikat in der variablen $SSLCert 01 zusammen mit zwei HostNames bereitstellt. Der Befehl speichert das Ergebnis in der Variablen mit dem Namen $Listener.

Parameter

-CustomErrorConfiguration

Kundenfehler eines Anwendungsgateways

Typ:PSApplicationGatewayCustomError[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FirewallPolicy

Gibt den Objektverweis auf eine Firewallrichtlinie der obersten Ebene an. Der Objektverweis kann mithilfe des Cmdlets New-AzApplicationGatewayWebApplicationFirewallPolicy erstellt werden. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Eine mit dem obigen Commandlet erstellte Firewallrichtlinie kann auf Pfadregelebene verwiesen werden. er oberhalb des Befehls würde eine Standardrichtlinieneinstellungen und verwaltete Regeln erstellen. Anstelle der Standardwerte können Benutzer Richtlinien Einstellungen, ManagedRules mithilfe von New-AzApplicationGatewayFirewallPolicy Einstellungen und New-AzApplicationGatewayFirewallPolicyManagedRules angeben.

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FirewallPolicyId

Gibt die ID einer vorhandenen Webanwendungsfirewallressource der obersten Ebene an. Firewallrichtlinien-IDs können mithilfe des Cmdlets "Get-AzApplicationGatewayWebApplicationFirewallPolicy" zurückgegeben werden. Nachdem die ID vorhanden ist, können Sie den Parameter "FirewallPolicyId" anstelle des Parameters "FirewallPolicy" verwenden. Beispiel: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FrontendIPConfiguration

Gibt das Front-End-IP-Konfigurationsobjekt für den HTTP-Listener an.

Typ:PSApplicationGatewayFrontendIPConfiguration
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FrontendIPConfigurationId

Gibt die ID der Front-End-IP-Konfiguration für den HTTP-Listener an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FrontendPort

Gibt den Front-End-Port für den HTTP-Listener an.

Typ:PSApplicationGatewayFrontendPort
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FrontendPortId

Gibt die ID des Front-End-Portobjekts für den HTTP-Listener an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HostName

Gibt den Hostnamen des HTTP-Listeners des Anwendungsgateways an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HostNames

Hostnamen

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des HTTP-Listeners an, den dieses Cmdlet erstellt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Protocol

Gibt das Protokoll an, das der HTTP-Listener verwendet.

Typ:String
Zulässige Werte:Http, Https
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RequireServerNameIndication

Typ:String
Zulässige Werte:true, false
Position:Named
Standardwert:true
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SslCertificate

Gibt das SSL-Zertifikatobjekt für den HTTP-Listener an.

Typ:PSApplicationGatewaySslCertificate
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SslCertificateId

Gibt die ID des SSL-Zertifikats für den HTTP-Listener an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SslProfile

SslProfile

Typ:PSApplicationGatewaySslProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SslProfileId

SslProfileId

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

PSApplicationGatewayHttpListener