Freigeben über


Add-AzApplicationGatewayCustomError

Fügt einem Anwendungsgateway einen benutzerdefinierten Fehler hinzu.

Syntax

Add-AzApplicationGatewayCustomError
   -ApplicationGateway <PSApplicationGateway>
   -StatusCode <String>
   -CustomErrorPageUrl <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Add-AzApplicationGatewayCustomError " fügt einem Anwendungsgateway einen benutzerdefinierten Fehler hinzu.

Beispiele

Beispiel 1: Fügt benutzerdefinierten Fehler zur Anwendungsgatewayebene hinzu

$resourceGroupName = "resourceGroupName"
$AppGWName = "applicationGatewayName"
$AppGw = Get-AzApplicationGateway -Name $AppGWName -ResourceGroupName $resourceGroupName
$customError502Url = "https://mycustomerrorpages.blob.core.windows.net/errorpages/502.htm"
$updatedgateway = Add-AzApplicationGatewayCustomError -ApplicationGateway $AppGw -StatusCode HttpStatus502 -CustomErrorPageUrl $customError502Url
Set-AzApplicationGateway -ApplicationGateway $AppGw

Dieser Befehl fügt dem Anwendungsgateway $appgw einen benutzerdefinierten Fehler des HTTP-Statuscodes 502 hinzu und gibt das aktualisierte Gateway zurück.

Beispiel 2: Fügt benutzerdefinierten Fehler zur Listenerebene des Anwendungsgateways hinzu

$resourceGroupName = "resourceGroupName"
 $AppGWName = "applicationGatewayName"
 $customError502Url = "https://mycustomerrorpages.blob.core.windows.net/errorpages/502.htm"
 $listenerName = "listenerName"
 $AppGw = Get-AzApplicationGateway -Name $AppGWName -ResourceGroupName $resourceGroupName
 $listener = Get-AzApplicationGatewayHttpListener -ApplicationGateway $AppGW -Name $listenerName
 $updatedListener = Add-AzApplicationGatewayHttpListenerCustomError -HttpListener $listener -StatusCode HttpStatus502 -CustomErrorPageUrl $customError502Url 
 Set-AzApplicationGateway -ApplicationGateway $AppGw

Mit diesem Befehl wird dem Anwendungsgateway ein benutzerdefinierter Fehler des HTTP-Statuscodes 502 $appgw auf Listenerebene hinzugefügt und das aktualisierte Gateway zurückgegeben.

Parameter

-ApplicationGateway

Das Anwendungsgateway

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

-CustomErrorPageUrl

Fehlerseiten-URL des Kundenfehlers des Anwendungsgateways.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-StatusCode

Statuscode des Anwendungsgateway-Kundenfehlers.

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

Eingaben

PSApplicationGateway

Ausgaben

PSApplicationGatewayCustomError