Incorporating feedback from edit review

Author: eamonoreilly

articles/azure-functions/functions-hybrid-powershell.md

@@ -16,13 +16,13 @@ ms.author: eamono
 The Azure App Service Hybrid Connections enables access to resources in other networks. You can learn more about this capability on the [Hybrid Connections](../app-service/app-service-hybrid-connections.md) documentation. The following information describes how to use this capability to run PowerShell functions targeting an on-premises server. This server can then be used to manage all resources within the on-premises environment from an Azure PowerShell function.
 
 
-## Configure an on-premises server to be used for PowerShell remoting
+## Configure an on-premises server for PowerShell remoting
 
 The below script enables PowerShell remoting, creates a new firewall rule, and a WinRM https listener. For testing purposes, a self-signed cert is used. It is recommended to use a signed certificate for production.
 
 ```powershell
 # For configuration of WinRM, please see
-# https://docs.microsoft.com/en-us/windows/win32/winrm/installation-and-configuration-for-windows-remote-management
+# https://docs.microsoft.com/windows/win32/winrm/installation-and-configuration-for-windows-remote-management
 
 # Enable PowerShell remoting
 Enable-PSRemoting -Force
@@ -79,7 +79,7 @@ App Service Hybrid Connections are only available in Basic, Standard, and Isolat
 
 1. Select **Go to resource** to view your new function app. You can also select **Pin to dashboard**. Pinning makes it easier to return to this function app resource from your dashboard.
 
-## Create a hybrid connection for the PowerShell function app
+## Create a hybrid connection for the function app
 
 Hybrid connections are configured from the networking section of the function app.
 
@@ -92,21 +92,21 @@ Hybrid connections are configured from the networking section of the function ap
 1. Enter information about for the hybrid connection as shown below. The Endpoint Host can optionally match the hostname of the on-premises server to make it easier to remember the server later when running remote commands. The port matches the default Windows remote management service port defined on the server earlier.
 ![Add Hybrid Connection](./media/functions-hybrid-powershell/add-hybrid-connection.png)  
 
-**Hybrid connection name** ContosoHybridOnPremisesServer
+    **Hybrid connection name** ContosoHybridOnPremisesServer
+    
+    **Endpoint Host** finance1
+    
+    **Endpoint Port** 5986
+    
+    **Servicebus namespace** Create New
+    
+    **Location** Pick an available location
+    
+    **Name** contosopowershellhybrid
 
-**Endpoint Host** finance1
+5. Click OK to create the hybrid connection
 
-**Endpoint Port** 5986
-
-**Servicebus namespace** Create New
-
-**Location** Pick an available location
-
-**Name** contosopowershellhybrid
-
-Click OK to create the hybrid connection
-
-## Download and install the hybrid connection on the on-premises server
+## Download and install the hybrid connection
 
 1. Select the Download connection manager icon to save the .msi file locally on your computer.
 ![Download installer](./media/functions-hybrid-powershell/download-hybrid-connection-installer.png)  
@@ -124,7 +124,7 @@ Click OK to create the hybrid connection
 Restart-Service HybridConnectionManager
 ```
 
-## Create an app setting for the password of an account that is an administrator on the on-premises server
+## Create an app setting for the password of an administrator account
 
 1. Select the Platform tab from the function application
 1. Select the Configuration from the General Settings section
@@ -134,49 +134,49 @@ Restart-Service HybridConnectionManager
 1. Select OK and then Save to store the password in the function application
 ![Add app setting for password](./media/functions-hybrid-powershell/add-appsetting-password.png)  
 
-## Create a function http trigger to test out the hybrid connection
+## Create a function http trigger to test
 
 1. Create a new http trigger function from the function app
 ![Create new http trigger](./media/functions-hybrid-powershell/create-http-trigger-function.png)  
 1. Replace the PowerShell code from the template with the following code:
 
-```powershell
-# Input bindings are passed in via param block.
-param($Request, $TriggerMetadata)
-
-# Write to the Azure Functions log stream.
-Write-Output "PowerShell HTTP trigger function processed a request."
-
-# Note that ContosoUserPassword is a function app setting, so I can access it as $env:ContosoUserPassword
-$UserName = "ContosoUser"
-$securedPassword = ConvertTo-SecureString  $Env:ContosoUserPassword -AsPlainText -Force
-$Credential = [System.management.automation.pscredential]::new($UserName, $SecuredPassword)
-
-# This is the name of the hybrid connection Endpoint.
-$HybridEndpoint = "finance1"
-
-$Script = {
-    Param(
-        [Parameter(Mandatory=$True)]
-        [String] $Service
-    )
-    Get-Service $Service
-}
-
-Write-Output "Scenario 1: Running command via Invoke-Command"
-Invoke-Command -ComputerName $HybridEndpoint `
-               -Credential $Credential `
-               -Port 5986 `
-               -UseSSL `
-               -ScriptBlock $Script `
-               -ArgumentList "*" `
-               -SessionOption (New-PSSessionOption -SkipCACheck)
-```
-
-Click Save and run to test the function
+    ```powershell
+    # Input bindings are passed in via param block.
+    param($Request, $TriggerMetadata)
+    
+    # Write to the Azure Functions log stream.
+    Write-Output "PowerShell HTTP trigger function processed a request."
+    
+    # Note that ContosoUserPassword is a function app setting, so I can access it as $env:ContosoUserPassword
+    $UserName = "ContosoUser"
+    $securedPassword = ConvertTo-SecureString  $Env:ContosoUserPassword -AsPlainText -Force
+    $Credential = [System.management.automation.pscredential]::new($UserName, $SecuredPassword)
+    
+    # This is the name of the hybrid connection Endpoint.
+    $HybridEndpoint = "finance1"
+    
+    $Script = {
+        Param(
+            [Parameter(Mandatory=$True)]
+            [String] $Service
+        )
+        Get-Service $Service
+    }
+    
+    Write-Output "Scenario 1: Running command via Invoke-Command"
+    Invoke-Command -ComputerName $HybridEndpoint `
+                   -Credential $Credential `
+                   -Port 5986 `
+                   -UseSSL `
+                   -ScriptBlock $Script `
+                   -ArgumentList "*" `
+                   -SessionOption (New-PSSessionOption -SkipCACheck)
+    ```
+
+3. Click Save and run to test the function
 ![Test function app](./media/functions-hybrid-powershell/test-function-hybrid.png)  
 
-## Managing other systems on-premises from the hybrid connection server
+## Managing other systems on-premises
 
 You can use the connected on-premises server to connect to other servers and management systems in the local environment. This lets you manage your data center operations from Azure using your PowerShell functions. The following script registers a PowerShell configuration session that runs under the supplied credentials. These credentials need to be an administrator on the remote servers. You can then use this configuration to access other endpoints in the local server or data center.
 
@@ -253,7 +253,7 @@ The above two scenarios enable you to connect and manage your on-premises enviro
 
 You can also use Azure [virtual networks](./functions-create-vnet.md) to connect to your on-premises environment using Azure Functions.
 
-## Next Steps
+## Next steps
 
 > [!div class="nextstepaction"] 
 > [Learn more about working with PowerShell functions](functions-reference-powershell.md)