Freigeben über


Add-AzApplicationGatewayHttpListener

Fügt einem Anwendungsgateway einen HTTP-Listener hinzu.

Syntax

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

Mit dem Cmdlet "Add-AzApplicationGatewayHttpListener " wird einem Anwendungsgateway ein HTTP-Listener hinzugefügt.

Beispiele

Beispiel 1: Hinzufügen eines HTTP-Listeners

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

Der erste Befehl ruft das Anwendungsgateway ab und speichert es in der variablen $AppGw. Der zweite Befehl fügt dem Anwendungsgateway den HTTP-Listener hinzu.

Beispiel 2: Hinzufügen eines HTTPS-Listeners mit SSL

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

Der erste Befehl ruft das Anwendungsgateway ab und speichert es in der variablen $AppGw. Der zweite Befehl fügt dem Anwendungsgateway den Listener hinzu, der das HTTPS-Protokoll verwendet.

Beispiel 3: Hinzufügen eines HTTPS-Listeners mit SSL und 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"

Der erste Befehl ruft das Anwendungsgateway ab und speichert es in der variablen $AppGw. Der zweite Befehl fügt dem Anwendungsgateway den Listener hinzu, der das HTTPS-Protokoll mit SSL-Zertifikaten und HostNames verwendet.

Parameter

-ApplicationGateway

Gibt das Anwendungsgateway an, dem dieses Cmdlet einen HTTP-Listener hinzufügt.

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

-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

FirewallPolicy

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

-FirewallPolicyId

FirewallPolicyId

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

-FrontendIPConfiguration

Gibt das Front-End-IP-Ressourcenobjekt des Anwendungsgateways an.

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

-FrontendIPConfigurationId

Gibt die Front-End-IP-ID des Anwendungsgateways an.

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

-FrontendPort

Gibt das Front-End-Portobjekt des Anwendungsgateways an.

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

-FrontendPortId

Gibt die Front-End-Port-ID des Anwendungsgateways an.

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

-HostName

Gibt den Hostnamen an, dem dieses Cmdlet einen HTTP-Listener hinzufügt.

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 Front-End-Ports an, den dieser Befehl hinzufügt.

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

-Protocol

Gibt das Protokoll des HTTP-Listeners an. Sowohl HTTP als auch HTTPS werden unterstützt.

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:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SslCertificate

Gibt das SSL-Zertifikat des HTTP-Listeners an. Muss angegeben werden, wenn HTTPS als Listenerprotokoll ausgewählt wird.

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

-SslCertificateId

Gibt die SSL-Zertifikat-ID des HTTP-Listeners an. Muss angegeben werden, wenn HTTPS als Listenerprotokoll ausgewählt wird.

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

PSApplicationGateway

Ausgaben

PSApplicationGateway