Freigeben über


Add-AzApplicationGatewayCustomError

Fügt einem Anwendungsgateway einen benutzerdefinierten Fehler hinzu.

Syntax

Default (Standard)

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

Parametereigenschaften

Typ:PSApplicationGateway
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CustomErrorPageUrl

Fehlerseiten-URL des Kundenfehlers des Anwendungsgateways.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StatusCode

Statuscode des Anwendungsgateway-Kundenfehlers.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSApplicationGateway

Ausgaben

PSApplicationGatewayCustomError