Merge pull request #209274 from w-azure/winona-hub-powershell

cleaned up wording

Author: JamesJBarnett

articles/iot-hub/iot-hub-rm-template-powershell.md

@@ -17,19 +17,15 @@ ms.custom: devx-track-azurepowershell
 
 Learn how to use an Azure Resource Manager template to create an IoT Hub and a consumer group. Resource Manager templates are JSON files that define the resources you need to deploy for your solution. For more information about developing Resource Manager templates, see [Azure Resource Manager documentation](../azure-resource-manager/index.yml).
 
-If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
-
 ## Create an IoT hub
 
-The Resource Manager template used in this quickstart is from [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/iothub-with-consumergroup-create/). Here is a copy of the template:
+The following [Resource Manager JSON template](https://azure.microsoft.com/resources/templates/iothub-with-consumergroup-create/) used in this article is one of many templates from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/). This template creates an Azure Iot hub with three endpoints (eventhub, cloud-to-device, and messaging) and a consumer group. For more information on the Iot Hub template schema, see [Microsoft.Devices (IoT Hub) resource types](/azure/templates/microsoft.devices/iothub-allversions).
 
 [!code-json[iothub-creation](~/quickstart-templates/quickstarts/microsoft.devices/iothub-with-consumergroup-create/azuredeploy.json)]
 
-The template creates an Azure Iot hub with three endpoints (eventhub, cloud-to-device, and messaging), and a consumer group. For more template samples, see [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/?resourceType=Microsoft.Devices&pageNumber=1&sort=Popular). The Iot Hub template schema can be found  [here](/azure/templates/microsoft.devices/iothub-allversions).
-
-There are several methods for deploying a template.  You use Azure PowerShell in this tutorial.
+There are several methods for deploying a template.  You use Azure PowerShell in this article.
 
-To run the PowerShell script, Select **Try it** to open the Azure Cloud shell. To paste the script, right-click the shell, and then select Paste:
+To run the following PowerShell script, select **Try it** to open the Azure Cloud Shell. Copy the script, paste it into the shell, and answer the prompts to create a new resource, choose a region, and create a new IoT hub.
 
 ```azurepowershell-interactive
 $resourceGroupName = Read-Host -Prompt "Enter the Resource Group name"
@@ -43,22 +39,23 @@ New-AzResourceGroupDeployment `
     -iotHubName $iotHubName
 ```
 
-As you can see from the PowerShell script, the template used is from Azure Quickstart templates. To use your own, you need to first upload the template file to the Cloud shell, and then use the `-TemplateFile` switch to specify the file name.  For an example, see [Deploy the template](../azure-resource-manager/templates/quickstart-create-templates-use-visual-studio-code.md?tabs=PowerShell#deploy-the-template).
+> [!NOTE]
+> To use your own template, upload your template file to the Cloud Shell, and then use the `-TemplateFile` switch to specify the file name.  For example, see [Deploy the template](../azure-resource-manager/templates/quickstart-create-templates-use-visual-studio-code.md?tabs=PowerShell#deploy-the-template).
 
 ## Next steps
 
-Now you have deployed an IoT hub by using an Azure Resource Manager template, you may want to explore further:
+Since you've deployed an IoT hub, using an Azure Resource Manager template, you may want to explore:
 
-* Read about the capabilities of the [IoT Hub resource provider REST API][lnk-rest-api].
-* Read [Azure Resource Manager overview][lnk-azure-rm-overview] to learn more about the capabilities of Azure Resource Manager.
-* For the JSON syntax and properties to use in templates, see [Microsoft.Devices resource types](/azure/templates/microsoft.devices/iothub-allversions).
+* Capabilities of the [IoT Hub resource provider REST API][lnk-rest-api]
+* Capabilities of the [Azure Resource Manager][lnk-azure-rm-overview]
+* JSON syntax and properties to use in templates: [Microsoft.Devices resource types](/azure/templates/microsoft.devices/iothub-allversions)
 
-To learn more about developing for IoT Hub, see the following articles:
+To learn more about developing for IoT Hub, see:
 
 * [Introduction to C SDK][lnk-c-sdk]
 * [Azure IoT SDKs][lnk-sdks]
 
-To further explore the capabilities of IoT Hub, see:
+To explore more capabilities of IoT Hub, see:
 
 * [Deploying AI to edge devices with Azure IoT Edge][lnk-iotedge]