Merge pull request #252317 from simonkurtz-MSFT/patch-1

Consolidate variables

Author: prmerger-automator[bot]

articles/api-management/api-management-howto-integrate-internal-vnet-appgateway.md

@@ -82,6 +82,40 @@ If you use Azure Active Directory or third-party authentication, enable the [coo
 > - `920300`, `920330`, `931130`, `942100`, `942110`, `942180`, `942200`, `942260`, `942340`, `942370` for the administrative mode
 > - `942200`, `942260`, `942370`, `942430`, `942440` for the published portal
 
+## Setting Variables
+
+Throughout this guide, you will need to define several variables. 
+
+```powershell
+# These variables must be changed.
+$subscriptionId = "00000000-0000-0000-0000-000000000000"      # GUID of your Azure subscription
+$domain = "contoso.net"                                       # The custom domain for your certificate
+$apimServiceName = "ContosoApi"                               # API Management service instance name, must be globally unique    
+$apimDomainNameLabel = $apimServiceName                       # Domain name label for API Management's public IP address, must be globally unique
+$apimAdminEmail = "[email protected]"                         # Administrator's email address - use your email address
+
+$gatewayHostname = "api.$domain"                              # API gateway host
+$portalHostname = "portal.$domain"                            # API developer portal host
+$managementHostname = "management.$domain"                    # API management endpoint host
+
+$baseCertPath = "C:\Users\Contoso\"                           # The base path where all certificates are stored
+$trustedRootCertCerPath = "${baseCertPath}trustedroot.cer"    # Full path to contoso.net trusted root .cer file
+$gatewayCertPfxPath = "${baseCertPath}gateway.pfx"            # Full path to api.contoso.net .pfx file
+$portalCertPfxPath = "${baseCertPath}portal.pfx"              # Full path to portal.contoso.net .pfx file
+$managementCertPfxPath = "${baseCertPath}management.pfx"      # Full path to management.contoso.net .pfx file
+
+$gatewayCertPfxPassword = "certificatePassword123"            # Password for api.contoso.net pfx certificate
+$portalCertPfxPassword = "certificatePassword123"             # Password for portal.contoso.net pfx certificate
+$managementCertPfxPassword = "certificatePassword123"         # Password for management.contoso.net pfx certificate
+
+
+# These variables may be changed.
+$resGroupName = "apim-appGw-RG"                               # Resource group name that will hold all assets
+$location = "West US"                                         # Azure region that will hold all assets
+$apimOrganization = "Contoso"                                 # Organization name    
+$appgwName = "apim-app-gw"                                    # The name of the Application Gateway
+```
+
 ## Create a resource group for Resource Manager
 
 To create a resource group for Azure Resource Manager:
@@ -96,16 +130,13 @@ To create a resource group for Azure Resource Manager:
 
 1. Select the subscription you want.
     
-    ```powershell
-    $subscriptionId = "00000000-0000-0000-0000-000000000000" # GUID of your Azure subscription
+    ```powershell    
     Get-AzSubscription -Subscriptionid $subscriptionId | Select-AzSubscription
     ```
 
 1. Create a resource group. You can skip this step if you're using an existing resource group.
 
-    ```powershell
-    $resGroupName = "apim-appGw-RG" # resource group name
-    $location = "West US"           # Azure region
+    ```powershell    
     New-AzResourceGroup -Name $resGroupName -Location $location
     ```
 
@@ -183,7 +214,7 @@ The following example shows how to create an API Management instance in a virtua
 
     ```powershell
     $apimPublicIpAddressId = New-AzPublicIpAddress -ResourceGroupName $resGroupName -name "pip-apim" -location $location `
-        -AllocationMethod Static -Sku Standard -Force -DomainNameLabel "apim-contoso"
+        -AllocationMethod Static -Sku Standard -Force -DomainNameLabel $apimDomainNameLabel
     ```
 
 1. Create an API Management virtual network object by using the subnet `$apimSubnetData` you created.
@@ -195,11 +226,6 @@ The following example shows how to create an API Management instance in a virtua
 1. Create an API Management instance inside the virtual network. This example creates the service in the Developer service tier. Substitute a unique name for your API Management instance.
     
     ```powershell
-    $domain = "contoso.net"
-    $apimServiceName = "ContosoApi"       # API Management service instance name, must be globally unique
-    $apimOrganization = "Contoso"         # Organization name
-    $apimAdminEmail = "[email protected]" # Administrator's email address
-    
     $apimService = New-AzApiManagement -ResourceGroupName $resGroupName -Location $location -Name $apimServiceName -Organization $apimOrganization `
         -AdminEmail $apimAdminEmail -VirtualNetwork $apimVirtualNetwork -VpnType "Internal" -Sku "Developer" -PublicIpAddressId $apimPublicIpAddressId.Id
     ```
@@ -213,18 +239,6 @@ To set up custom domain names in API Management:
 1. Initialize the following variables with the details of the certificates with private keys for the domains and the trusted root certificate. In this example, we use `api.contoso.net`, `portal.contoso.net`, and `management.contoso.net`.  
 
     ```powershell
-    $gatewayHostname = "api.$domain"                                # API gateway host
-    $portalHostname = "portal.$domain"                              # API developer portal host
-    $managementHostname = "management.$domain"                      # API management endpoint host
-    $gatewayCertPfxPath = "C:\Users\Contoso\gateway.pfx"            # Full path to api.contoso.net .pfx file
-    $portalCertPfxPath = "C:\Users\Contoso\portal.pfx"              # Full path to portal.contoso.net .pfx file
-    $managementCertPfxPath = "C:\Users\Contoso\management.pfx"      # Full path to management.contoso.net .pfx file
-    $gatewayCertPfxPassword = "certificatePassword123"              # Password for api.contoso.net pfx certificate
-    $portalCertPfxPassword = "certificatePassword123"               # Password for portal.contoso.net pfx certificate
-    $managementCertPfxPassword = "certificatePassword123"           # Password for management.contoso.net pfx certificate
-    # Path to trusted root CER file used in Application Gateway HTTP settings
-    $trustedRootCertCerPath = "C:\Users\Contoso\trustedroot.cer"    # Full path to contoso.net trusted root .cer file
-    
     $certGatewayPwd = ConvertTo-SecureString -String $gatewayCertPfxPassword -AsPlainText -Force
     $certPortalPwd = ConvertTo-SecureString -String $portalCertPfxPassword -AsPlainText -Force
     $certManagementPwd = ConvertTo-SecureString -String $managementCertPfxPassword -AsPlainText -Force
@@ -435,8 +449,7 @@ To create an Application Gateway resource:
 
 1. Create an application gateway with all the configuration objects from the preceding steps.
 
-    ```powershell
-    $appgwName = "apim-app-gw"
+    ```powershell    
     $appgw = New-AzApplicationGateway -Name $appgwName -ResourceGroupName $resGroupName -Location $location `
       -BackendAddressPools $apimGatewayBackendPool,$apimPortalBackendPool,$apimManagementBackendPool `
       -BackendHttpSettingsCollection $apimPoolGatewaySetting, $apimPoolPortalSetting, $apimPoolManagementSetting `