Merge pull request #263578 from paulth1/tutorial-create-gateway-portal

[AQ] edit pass: tutorial-create-gateway-portal

Author: ShawnJackson

articles/vpn-gateway/tutorial-create-gateway-portal.md

@@ -1,7 +1,7 @@
 ---
 title: 'Tutorial – Create & manage a VPN gateway – Azure portal'
 titleSuffix: Azure VPN Gateway
-description: In this tutorial, learn how to create and manage an Azure VPN gateway using the Azure portal.
+description: In this tutorial, learn how to create and manage an Azure VPN gateway by using the Azure portal.
 author: cherylmc
 ms.author: cherylmc
 ms.service: vpn-gateway
@@ -10,33 +10,33 @@ ms.date: 01/17/2024
 
 ---
 
-# Tutorial: Create and manage a VPN gateway using the Azure portal
+# Tutorial: Create and manage a VPN gateway by using the Azure portal
 
-This tutorial helps you create and manage a virtual network gateway (VPN gateway) using the Azure portal. The VPN gateway is just one part of a connection architecture to help you securely access resources within a virtual network (VNet).
+This tutorial helps you create and manage a virtual network gateway (VPN gateway) by using the Azure portal. The VPN gateway is just one part of a connection architecture to help you securely access resources within a virtual network.
 
-:::image type="content" source="./media/tutorial-create-gateway-portal/gateway-diagram.png" alt-text="Diagram of virtual network and VPN gateway." lightbox="./media/tutorial-create-gateway-portal/gateway-diagram-expand.png":::
+:::image type="content" source="./media/tutorial-create-gateway-portal/gateway-diagram.png" alt-text="Diagram that shows a virtual network and a VPN gateway." lightbox="./media/tutorial-create-gateway-portal/gateway-diagram-expand.png":::
 
-* The left side of the diagram shows the VNet and the VPN gateway that you create using the steps in this article.
-* You can later add different types of connections, as shown on the right side of the diagram. For example, you can create [Site-to-Site](tutorial-site-to-site-portal.md) and [Point-to-site](point-to-site-about.md) connections. See [VPN Gateway design](design.md) to view different design architectures that you can build.
+* The left side of the diagram shows the virtual network and the VPN gateway that you create by using the steps in this article.
+* You can later add different types of connections, as shown on the right side of the diagram. For example, you can create [site-to-site](tutorial-site-to-site-portal.md) and [point-to-site](point-to-site-about.md) connections. To view different design architectures that you can build, see [VPN gateway design](design.md).
 
-If you want to learn more about the configuration settings used in this tutorial, see [About VPN Gateway configuration settings](vpn-gateway-about-vpn-gateway-settings.md). For more information about VPN Gateway, see [What is VPN Gateway?](vpn-gateway-about-vpngateways.md)
+If you want to learn more about the configuration settings used in this tutorial, see [About VPN Gateway configuration settings](vpn-gateway-about-vpn-gateway-settings.md). For more information about Azure VPN Gateway, see [What is Azure VPN Gateway?](vpn-gateway-about-vpngateways.md).
 
 In this tutorial, you learn how to:
 
 > [!div class="checklist"]
-> * Create a VNet
-> * Create a VPN gateway
-> * View the gateway public IP address
-> * Resize a VPN gateway (resize SKU)
-> * Reset a VPN gateway
+> * Create a virtual network.
+> * Create a VPN gateway.
+> * View the gateway public IP address.
+> * Resize a VPN gateway (resize SKU).
+> * Reset a VPN gateway.
 
 ## Prerequisites
 
-An Azure account with an active subscription. If you don't have one, [create one for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
+You need an Azure account with an active subscription. If you don't have one, [create one for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
 
-## <a name="CreatVNet"></a>Create a VNet
+## <a name="CreatVNet"></a>Create a virtual network
 
-Create a VNet using the following values:
+Create a virtual network by using the following values:
 
 * **Resource group:** TestRG1
 * **Name:** VNet1
@@ -47,50 +47,50 @@ Create a VNet using the following values:
 
 [!INCLUDE [Create a VNet](../../includes/vpn-gateway-basic-vnet-rm-portal-include.md)]
 
-After you create your VNet, you can optionally configure Azure DDos Protection. Protection is simple to enable on any new or existing virtual network, and it requires no application or resource changes. For more information about Azure DDoS protection, see [What is Azure DDoS Protection?](../ddos-protection/ddos-protection-overview.md)
+After you create your virtual network, you can optionally configure Azure DDoS Protection. Protection is simple to enable on any new or existing virtual network, and it requires no application or resource changes. For more information about Azure DDoS Protection, see [What is Azure DDoS Protection?](../ddos-protection/ddos-protection-overview.md).
 
 ## Create a gateway subnet
 
-The virtual network gateway requires a specific subnet named **GatewaySubnet**. The gateway subnet is part of IP address range for your virtual network and contains the IP addresses that the virtual network gateway resources and services use. Specify a gateway subnet that is /27 or larger.
+The virtual network gateway requires a specific subnet named **GatewaySubnet**. The gateway subnet is part of the IP address range for your virtual network and contains the IP addresses that the virtual network gateway resources and services use. Specify a gateway subnet that's /27 or larger.
 
 [!INCLUDE [Create gateway subnet](../../includes/vpn-gateway-create-gateway-subnet-portal-include.md)]
 
 ## <a name="VNetGateway"></a>Create a VPN gateway
 
-In this step, you create the virtual network gateway (VPN gateway) for your VNet. Creating a gateway can often take 45 minutes or more, depending on the selected gateway SKU.
+In this step, you create the virtual network gateway (VPN gateway) for your virtual network. Creating a gateway can often take 45 minutes or more, depending on the selected gateway SKU.
 
-Create a virtual network gateway using the following values:
+Create a virtual network gateway by using the following values:
 
-* **Name:** VNet1GW
-* **Region:** East US
-* **Gateway type:** VPN
-* **SKU:** VpnGw2
-* **Generation:** Generation 2
-* **Virtual network:** VNet1
-* **Gateway subnet address range:** 10.1.255.0/27
-* **Public IP address:** Create new
-* **Public IP address name:** VNet1GWpip
+* **Name**: VNet1GW
+* **Region**: East US
+* **Gateway type**: VPN
+* **SKU**: VpnGw2
+* **Generation**: Generation 2
+* **Virtual network**: VNet1
+* **Gateway subnet address range**: 10.1.255.0/27
+* **Public IP address**: Create new
+* **Public IP address name**: VNet1GWpip
 
-For this exercise, we won't be selecting a zone redundant SKU. If you want to learn about zone-redundant SKUs, see [About zone-redundant VNet gateways](about-zone-redundant-vnet-gateways.md).
+For this exercise, you won't select a zone-redundant SKU. If you want to learn about zone-redundant SKUs, see [About zone-redundant virtual network gateways](about-zone-redundant-vnet-gateways.md).
 
 [!INCLUDE [Create a vpn gateway](../../includes/vpn-gateway-add-gw-portal-include.md)]
 [!INCLUDE [Configure PIP settings](../../includes/vpn-gateway-add-gw-pip-portal-include.md)]
 
-A gateway can take 45 minutes or more to fully create and deploy. You can see the deployment status on the **Overview** page for your gateway. After the gateway is created, you can view the IP address that has been assigned to it by looking at the VNet in the portal. The gateway appears as a connected device.
+A gateway can take 45 minutes or more to fully create and deploy. You can see the deployment status on the **Overview** page for your gateway. After the gateway is created, you can view the IP address assigned to it by looking at the virtual network in the portal. The gateway appears as a connected device.
 
 [!INCLUDE [NSG warning](../../includes/vpn-gateway-no-nsg-include.md)]
 
 ## <a name="view"></a>View the public IP address
 
 You can view the gateway public IP address on the **Overview** page for your gateway. The public IP address is used when you configure a site-to-site connection to your VPN gateway.
 
-:::image type="content" source="./media/tutorial-create-gateway-portal/address.png" alt-text="Screenshot of Overview page used to view the Public IP address field." lightbox="./media/tutorial-create-gateway-portal/address.png":::
+:::image type="content" source="./media/tutorial-create-gateway-portal/address.png" alt-text="Screenshot that shows the Overview page used to view the Public IP address field." lightbox="./media/tutorial-create-gateway-portal/address.png":::
 
-To see additional information about the public IP address object, select the name/IP address link next to **Public IP address**.
+To see more information about the public IP address object, select the name/IP address link next to **Public IP address**.
 
 ## <a name="resize"></a>Resize a gateway SKU
 
-There are specific rules regarding resizing vs. changing a gateway SKU. In this section, we'll resize the SKU. For more information, see [Resize or change gateway SKUs](about-gateway-skus.md#resizechange).
+There are specific rules for resizing versus changing a gateway SKU. In this section, you resize the SKU. For more information, see [Resize or change gateway SKUs](about-gateway-skus.md#resizechange).
 
 [!INCLUDE [resize a gateway](../../includes/vpn-gateway-resize-gw-portal-include.md)]
 
@@ -101,7 +101,7 @@ There are specific rules regarding resizing vs. changing a gateway SKU. In this
 ## Clean up resources
 
 If you're not going to continue to use this application or go to the next tutorial, delete
-these resources using the following steps:
+these resources.
 
 1. Enter the name of your resource group in the **Search** box at the top of the portal and select it from the search results.
 
@@ -111,10 +111,10 @@ these resources using the following steps:
 
 ## Next steps
 
-Once you've created a VPN gateway, you can configure additional gateway settings and connections. The following articles help you create a few of the most common configurations:
+After you create a VPN gateway, you can configure more gateway settings and connections. The following articles help you create a few of the most common configurations:
 
 > [!div class="nextstepaction"]
-> [Site-to-Site VPN connections](./tutorial-site-to-site-portal.md)
+> [Site-to-site VPN connections](./tutorial-site-to-site-portal.md)
 
 > [!div class="nextstepaction"]
-> [Point-to-Site VPN connections](vpn-gateway-howto-point-to-site-resource-manager-portal.md)
+> [Point-to-site VPN connections](vpn-gateway-howto-point-to-site-resource-manager-portal.md)

includes/vpn-gateway-add-gw-pip-portal-include.md

@@ -7,16 +7,16 @@
 
 # The numbers in this include are correct. They add on to sections in multiple articles that are already numbered.
 ---
-3. Specify in the values for **Public IP address**. These settings specify the public IP address object that gets associated to the VPN gateway. The public IP address is assigned to this object when the VPN gateway is created. The only time the primary public IP address changes is when the gateway is deleted and re-created. It doesn't change across resizing, resetting, or other internal maintenance/upgrades of your VPN gateway.
+3. Specify the values for **Public IP address**. These settings specify the public IP address object that gets associated to the VPN gateway. The public IP address is assigned to this object when the VPN gateway is created. The only time the primary public IP address changes is when the gateway is deleted and re-created. It doesn't change across resizing, resetting, or other internal maintenance/upgrades of your VPN gateway.
 
-   :::image type="content" source="./media/vpn-gateway-add-gw-pip-portal/pip-values.png" alt-text="Screenshot of public IP address field." lightbox="./media/vpn-gateway-add-gw-pip-portal/pip-values.png":::
+   :::image type="content" source="./media/vpn-gateway-add-gw-pip-portal/pip-values.png" alt-text="Screenshot that shows the Public IP address field." lightbox="./media/vpn-gateway-add-gw-pip-portal/pip-values.png":::
 
      * **Public IP address type**: For this exercise, if you have the option to choose the address type, select **Standard**.
      * **Public IP address**: Leave **Create new** selected.
-     * **Public IP address name**: In the text box, type a name for your public IP address instance.
+     * **Public IP address name**: In the text box, enter a name for your public IP address instance.
      * **Public IP address SKU**: Setting is autoselected.
-     * **Assignment**: The assignment is typically autoselected and can be either Dynamic or Static.
+     * **Assignment**: The assignment is typically autoselected and can be either **Dynamic** or **Static**.
      * **Enable active-active mode**: Select **Disabled**. Only enable this setting if you're creating an active-active gateway configuration.
      * **Configure BGP**: Select **Disabled**, unless your configuration specifically requires this setting. If you do require this setting, the default ASN is 65515, although this value can be changed.
 4. Select **Review + create** to run validation.
-5. Once validation passes, select **Create** to deploy the VPN gateway.
+5. After validation passes, select **Create** to deploy the VPN gateway.

includes/vpn-gateway-add-gw-portal-include.md

@@ -6,24 +6,24 @@
  ms.author: cherylmc
 ---
 
-1. In **Search resources, services, and docs (G+/)** type **virtual network gateway**. Locate **Virtual network gateway** in the Marketplace search results and select it to open the **Create virtual network gateway** page.
+1. In **Search resources, services, and docs (G+/)**, enter **virtual network gateway**. Locate **Virtual network gateway** in the **Marketplace** search results and select it to open the **Create virtual network gateway** page.
 
-   :::image type="content" source="./media/vpn-gateway-add-gw-portal/search.png" alt-text="Screenshot of Search field." lightbox="./media/vpn-gateway-add-gw-portal/search-expand.png":::
+   :::image type="content" source="./media/vpn-gateway-add-gw-portal/search.png" alt-text="Screenshot that shows the Search field." lightbox="./media/vpn-gateway-add-gw-portal/search-expand.png":::
 
 1. On the **Basics** tab, fill in the values for **Project details** and **Instance details**.
 
-   :::image type="content" source="./media/vpn-gateway-add-gw-portal/instance-details.png" alt-text="Screenshot of Instance fields." lightbox="./media/vpn-gateway-add-gw-portal/instance-details.png":::
+   :::image type="content" source="./media/vpn-gateway-add-gw-portal/instance-details.png" alt-text="Screenshot that shows the Instance fields." lightbox="./media/vpn-gateway-add-gw-portal/instance-details.png":::
 
-   * **Subscription**: Select the subscription you want to use from the dropdown.
-   * **Resource Group**: This setting is autofilled when you select your virtual network on this page.
-   * **Name**: Name your gateway. Naming your gateway not the same as naming a gateway subnet. It's the name of the gateway object you're creating.
+   * **Subscription**: Select the subscription you want to use from the dropdown list.
+   * **Resource group**: This setting is autofilled when you select your virtual network on this page.
+   * **Name**: Name your gateway. Naming your gateway isn't the same as naming a gateway subnet. It's the name of the gateway object you're creating.
    * **Region**: Select the region in which you want to create this resource. The region for the gateway must be the same as the virtual network.
    * **Gateway type**: Select **VPN**. VPN gateways use the virtual network gateway type **VPN**.
-   * **SKU**: From the dropdown, select the gateway SKU that supports the features you want to use. See [Gateway SKUs](../articles/vpn-gateway/vpn-gateway-about-vpn-gateway-settings.md#gwsku). In the portal, the SKUs available in the dropdown depend on the `VPN type` you select. [!INCLUDE [Basic SKU](vpn-gateway-basic-sku.md)]
+   * **SKU**: From the dropdown list, select the gateway SKU that supports the features you want to use. See [Gateway SKUs](../articles/vpn-gateway/vpn-gateway-about-vpn-gateway-settings.md#gwsku). In the portal, the SKUs available in the dropdown list depend on the `VPN type` you select. [!INCLUDE [Basic SKU](vpn-gateway-basic-sku.md)]
    * **Generation**: Select the generation you want to use. We recommend using a Generation2 SKU. For more information, see [Gateway SKUs](../articles/vpn-gateway/vpn-gateway-about-vpngateways.md#gwsku).
-   * **Virtual network**: From the dropdown, select the virtual network to which you want to add this gateway. If you can't see the virtual network for which you want to create a gateway, make sure you selected the correct subscription and region in the previous settings.
+   * **Virtual network**: From the dropdown list, select the virtual network to which you want to add this gateway. If you can't see the virtual network for which you want to create a gateway, make sure you selected the correct subscription and region in the previous settings.
    * **Gateway subnet address range** or **Subnet**: The gateway subnet is required to create a VPN gateway.
 
      At this time, this field has a couple of different behaviors, depending on the virtual network address space and whether you already created a subnet named **GatewaySubnet** for your virtual network.
 
-     If you don't have a gateway subnet AND you don't see the option to create one on this page, go back to your virtual network and create the gateway subnet. Then, return to this page and configure the VPN gateway.
+     If you don't have a gateway subnet *and* you don't see the option to create one on this page, go back to your virtual network and create the gateway subnet. Then, return to this page and configure the VPN gateway.