Reconstruction of PowerShell template article

Author: w-azure

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

@@ -26,14 +26,14 @@ You can use Azure Resource Manager to create and manage Azure IoT hubs programma
 To complete this tutorial, you need the following:
 
 * Visual Studio
-* An [Azure Storage account][lnk-storage-account] where you can store your Azure Resource Manager template files
-* [Azure PowerShell module][lnk-powershell-install]
+* An [Azure Storage account][lnk-storage-account] for your Azure Resource Manager template files
+* [Azure PowerShell module][lnk-powershell-install] or [Azure Cloud Shell](/azure/cloud-shell/overview)
 
 [!INCLUDE [iot-hub-prepare-resource-manager](../../includes/iot-hub-prepare-resource-manager.md)]
 
 ## Prepare your Visual Studio project
 
-1. In Visual Studio, create a Visual C# Windows Classic Desktop project using the **Console App (.NET Framework)** project template. Name the project **CreateIoTHub**.
+1. In Visual Studio, create a C# Windows Desktop project using the **Console App (.NET Framework)** project template. Name the project **CreateIoTHub**.
 
 2. In Solution Explorer, right-click on your project and then click **Manage NuGet Packages**.
 
@@ -71,41 +71,32 @@ To complete this tutorial, you need the following:
 
 Use a JSON template and parameter file to create an IoT hub in your resource group. You can also use an Azure Resource Manager template to make changes to an existing IoT hub.
 
-1. In Solution Explorer, right-click on your project, click **Add**, and then click **New Item**. Add a JSON file called **template.json** to your project.
+1. In Solution Explorer, right-click on your project, click **Add**, and then click **New Item**. Add a text file to your project and rename it **template.json**.
 
-2. To add a standard IoT hub to the **East US** region, replace the contents of **template.json** with the following resource definition. For the current list of regions that support IoT Hub see [Azure Status][lnk-status]:
+2. To add a standard IoT hub to the **East US** region, replace the contents of **template.json** with the following resource definition. For the current list of regions that support IoT Hub see [Azure Status][lnk-status]. Replace the `<myHubName>` value with a unique name for your new IoT hub.
 
     ```json
     {
-      "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
+      "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {
         "hubName": {
           "type": "string"
         }
       },
       "resources": [
-      {
-        "apiVersion": "2016-02-03",
-        "type": "Microsoft.Devices/IotHubs",
-        "name": "[parameters('hubName')]",
-        "location": "East US",
-        "sku": {
-          "name": "S1",
-          "tier": "Standard",
-          "capacity": 1
-        },
-        "properties": {
-          "location": "East US"
-        }
-      }
-      ],
-      "outputs": {
-        "hubKeys": {
-          "value": "[listKeys(resourceId('Microsoft.Devices/IotHubs', parameters('hubName')), '2016-02-03')]",
-          "type": "object"
-        }
-      }
+           {
+               "type": "Microsoft.Devices/IotHubs",
+               "apiVersion": "2022-04-30-preview",
+               "name": "[parameters('<myHubName>')]",
+               "location": "eastus",
+               "sku": {
+                  "name": "S1",
+                  "tier": "Standard",
+                  "capacity": 1
+               },
+           }
+      ]
     }
     ```
 

includes/iot-hub-prepare-resource-manager.md

@@ -12,7 +12,7 @@ Install the [Azure PowerShell cmdlets][lnk-powershell-install] before you contin
 
 The following steps show how to set up password authentication for an AD application using PowerShell. You can run these commands in a standard PowerShell session.
 
-1. Sign in to your Azure subscription using the following command:
+1. Sign in to your Azure subscription using the following command. If you're using PowerShell in Azure Cloud Shell you're already signed in, so you can skip this step.
 
     ```powershell
     Connect-AzAccount
@@ -26,10 +26,10 @@ The following steps show how to set up password authentication for an AD applica
    Get-AzSubscription
    ```
 
-   Select the subscription you want to use. You can use either the subscription name or ID from the output of the previous command.
+   Select the subscription you want to use. You can use either the `Name` or `Id` from the output of the previous command.
 
    ```powershell
-   Select-AzSubscription -SubscriptionName "{your subscription name}"
+   Select-AzSubscription -SubscriptionName "{your subscription Name or Id}"
    ```
 
 1. Save your **Id** and **TenantId** for later.