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
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIPConfiguration

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

Typ:PSApplicationGatewayFrontendIPConfiguration
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIPConfigurationId

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendPort

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

Typ:PSApplicationGatewayFrontendPort
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendPortId

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-HostName

Gibt den Hostnamen des HTTP-Listeners des Anwendungsgateways an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-HostNames

Hostnamen

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

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

Typ:String
Zulässige Werte:Http, Https
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-RequireServerNameIndication

Typ:String
Zulässige Werte:true, false
Position:Named
Standardwert:true
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-SslCertificate

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

Typ:PSApplicationGatewaySslCertificate
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-SslCertificateId

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-SslProfile

SslProfile

Typ:PSApplicationGatewaySslProfile
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-SslProfileId

SslProfileId

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

PSApplicationGatewayHttpListener