Set-AzApplicationGatewayHttpListener

Modul:

Az.Network

Ändert einen HTTP-Listener für ein Anwendungsgateway.

Syntax

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

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

Das cmdlet Set-AzApplicationGatewayHttpListener ändert einen HTTP-Listener für ein Azure-Anwendungsgateway.

Beispiele

Beispiel 1: Festlegen eines HTTP-Listeners

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

Der erste Befehl ruft das Anwendungsgateway01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der variablen $AppGw. Der zweite Befehl legt den HTTP-Listener für das Gateway so fest, dass die in $FIP 01 gespeicherte Front-End-Konfiguration mit dem HTTP-Protokoll auf Port 80 verwendet wird.

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

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 den HTTP-Listener zuordnet.

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 die Front-End-IP-Adresse des Anwendungsgateways an.

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

-FrontendIPConfigurationId

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

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

-FrontendPort

Gibt den Front-End-Port 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, an den dieses Cmdlet den HTTP-Listener sendet.

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.

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

-Protocol

Gibt das Protokoll an, das der HTTP-Listener verwendet. Die zulässigen Werte für diesen Parameter sind:

• Http
• Https

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

-RequireServerNameIndication

Gibt an, ob für das Cmdlet ein Servernamenshinweis erforderlich ist. Die zulässigen Werte für diesen Parameter sind: wahr oder falsch.

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.

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

-SslCertificateId

Gibt die SSL-Zertifikat-ID (Secure Socket Layer) des HTTP-Listeners 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

PSApplicationGateway

Ausgaben

PSApplicationGateway

Ähnliche Themen

• Add-AzApplicationGatewayHttpListener
• Get-AzApplicationGatewayHttpListener
• New-AzApplicationGatewayHttpListener
• Remove-AzApplicationGatewayHttpListener