update screnshot and ps section

Author: halkazwini

articles/web-application-firewall/afds/waf-front-door-configure-custom-response-code.md

@@ -5,7 +5,7 @@ author: halkazwini
 ms.author: halkazwini
 ms.service: azure-web-application-firewall
 ms.topic: how-to
-ms.date: 05/05/2025
+ms.date: 05/08/2025
 ms.custom: devx-track-azurepowershell
 ---
 
@@ -15,97 +15,69 @@ In this article, you learn how to configure a custom response page when Azure We
 
 By default, when Azure Web Application Firewall blocks a request because of a matched rule, it returns a 403 status code with the message "The request is blocked." The default message also includes the tracking reference string that's used to link to [log entries](./waf-front-door-monitor.md) for the request. You can configure a custom response status code and a custom message with a reference string for your use case.
 
-## Configure a custom response status code and message
+## Prerequisites
 
 # [**Portal**](#tab/portal)
 
-You can configure a custom response status code and body under **Policy settings** on the Azure Web Application Firewall portal.
-
-:::image type="content" source="../media/waf-front-door-configure-custom-response-code/custom-response-settings.png" alt-text="Screenshot that shows Azure Web Application Firewall Policy settings." lightbox="../media/waf-front-door-configure-custom-response-code/custom-response-settings.png":::
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 
-In the preceding example, we kept the response code as 403 and configured a short "Please contact us" message, as shown in the following image:
-
-:::image type="content" source="../media/waf-front-door-configure-custom-response-code/custom-response.png" alt-text="Screenshot that shows a custom response example.":::
+- Sign in to the [Azure portal](https://portal.azure.com) with your Azure account.
 
 # [**PowerShell**](#tab/powershell)
 
-Follow these steps to configure a custom response status code and message by using PowerShell.
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 
-### Set up your PowerShell environment
+- Azure Cloud Shell or Azure PowerShell.
 
-Azure PowerShell provides a set of cmdlets that use the [Azure Resource Manager](../../azure-resource-manager/management/overview.md) model for managing your Azure resources.
+    The steps in this article run the Azure PowerShell cmdlets interactively in [Azure Cloud Shell](/azure/cloud-shell/overview). To run the cmdlets in the Cloud Shell, select **Open Cloud Shell** at the upper-right corner of a code block. Select **Copy** to copy the code and then paste it into Cloud Shell to run it. You can also run the Cloud Shell from within the Azure portal.
 
-You can install [Azure PowerShell](/powershell/azure/) on your local machine and use it in any PowerShell session. Follow the instructions on the page to sign in with your Azure credentials. Then install the Az PowerShell module.
+    You can also [install Azure PowerShell locally](/powershell/azure/install-azure-powershell) to run the cmdlets. This article requires the Azure PowerShell module. If you run PowerShell locally, sign in to Azure using the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) cmdlet.
 
-### Connect to Azure with an interactive dialog for sign-in
+---
 
-```
-Connect-AzAccount
-Install-Module -Name Az
+## Configure a custom response status code and message
 
-```
-Make sure you have the current version of PowerShellGet installed. Run the following command and reopen PowerShell.
+# [**Portal**](#tab/portal)
 
-```
-Install-Module PowerShellGet -Force -AllowClobber
-``` 
+To customize the response status code and body, follow these steps:
 
-### Install the Az.FrontDoor module
+1. Go to your Front Door WAF policy in the Azure portal.
 
-```
-Install-Module -Name Az.FrontDoor
-```
+1. Under **Settings**, select **Policy settings**.
 
-### Create a resource group
+1. Enter the custom response status code and response body in **Block response status code** and **Block response body** respectively.
 
-In Azure, you allocate related resources to a resource group. Here, we create a resource group by using [New-AzResourceGroup](/powershell/module/Az.resources/new-Azresourcegroup).
+:::image type="content" source="../media/waf-front-door-configure-custom-response-code/custom-response-settings.png" alt-text="Screenshot that shows Azure Web Application Firewall Policy settings." lightbox="../media/waf-front-door-configure-custom-response-code/custom-response-settings.png":::
 
-```azurepowershell-interactive
-New-AzResourceGroup -Name myResourceGroupWAF
-```
+1. Select **Save**.
 
-### Create a new WAF policy with a custom response
+In the preceding example, we kept the response code as 403 and configured a short "Please contact us" message, as shown in the following image:
 
-The following example shows how to create a new web application firewall (WAF) policy with a custom response status code set to 405 and a message of "You are blocked" by using
-[New-AzFrontDoorWafPolicy](/powershell/module/az.frontdoor/new-azfrontdoorwafpolicy).
+:::image type="content" source="../media/waf-front-door-configure-custom-response-code/custom-response.png" alt-text="Screenshot that shows a custom response example.":::
 
-```azurepowershell
-# WAF policy setting
-New-AzFrontDoorWafPolicy `
--Name myWAFPolicy `
--ResourceGroupName myResourceGroupWAF `
--EnabledState enabled `
--Mode Detection `
--CustomBlockResponseStatusCode 405 `
--CustomBlockResponseBody "<html><head><title>You are blocked.</title></head><body></body></html>"
-```
+# [**PowerShell**](#tab/powershell)
 
-Modify the custom response code or response body settings of an existing WAF policy by using [Update-AzFrontDoorFireWallPolicy](/powershell/module/az.frontdoor/Update-AzFrontDoorWafPolicy).
+To customize the response status code and body, use [Update-AzFrontDoorWafPolicy](/powershell/module/az.frontdoor/Update-AzFrontDoorWafPolicy) cmdlet.
 
-```azurepowershell
-# modify WAF response code
-Update-AzFrontDoorFireWallPolicy `
--Name myWAFPolicy `
--ResourceGroupName myResourceGroupWAF `
--EnabledState enabled `
--Mode Detection `
--CustomBlockResponseStatusCode 403
-```
 
-```azurepowershell
+```azurepowershell-interactive
 # modify WAF response body
-Update-AzFrontDoorFireWallPolicy `
--Name myWAFPolicy `
--ResourceGroupName myResourceGroupWAF `
--CustomBlockResponseBody "<html><head><title>Forbidden</title></head><body>{{azure-ref}}</body></html>"
+Update-AzFrontDoorWafPolicy `
+-Name 'myWAFPolicy' `
+-ResourceGroupName 'myResourceGroup' `
+-RequestBodyCheck 'Enabled' `
+-RedirectUrl 'https://learn.microsoft.com/en-us/azure/web-application-firewall/' `
+-CustomBlockResponseStatusCode '403' `
+-CustomBlockResponseBody '<html><head><title>WAF Demo</title></head><body><p><h1><strong>WAF Custom Response Page</strong></h1></p><p>Please contact us with this information:<br>{{azure-ref}}</p></body></html>'
 ```
 
 ---
 
 > [!NOTE]
-> If you leave the block response body blank, the WAF returns a *403 Forbidden* response for normal WAF blocks and a *429 Too many requests* for rate limit blocks. 
+> `{{azure-ref}}` inserts the unique reference string in the response body. The value matches the TrackingReference field in the `FrontDoorAccessLog` and `FrontDoorWebApplicationFirewallLog` logs.
 
-`{{azure-ref}}` inserts the unique reference string in the response body. The value matches the TrackingReference field in the `FrontDoorAccessLog` and `FrontDoorWebApplicationFirewallLog` logs.
+> [!IMPORTANT]
+> If you leave the block response body blank, the WAF returns a *403 Forbidden* response for normal WAF blocks and a *429 Too many requests* for rate limit blocks. 
 
 ## Next step