Merge pull request #209086 from w-azure/winona-hub-rest

Cleaned up text / wordiness

Author: BCS2022

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

@@ -19,13 +19,11 @@ You can use the [IoT Hub resource provider REST API](/rest/api/iothub/iothubreso
 
 [!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
 
-To complete this tutorial, you need the following:
+## Prerequisites
 
 * Visual Studio.
 
-* An active Azure account. If you don't have an account, you can create a [free account](https://azure.microsoft.com/pricing/free-trial/) in just a couple of minutes.
-
-* [Azure PowerShell 1.0](/powershell/azure/install-Az-ps) or later.
+* [Azure Az PowerShell module](/powershell/azure/install-Az-ps).
 
 [!INCLUDE [iot-hub-prepare-resource-manager](../../includes/iot-hub-prepare-resource-manager.md)]
 
@@ -39,7 +37,7 @@ To complete this tutorial, you need the following:
 
 4. In NuGet Package Manager, search for **Microsoft.IdentityModel.Clients.ActiveDirectory**.  Click **Install**, in **Review Changes** click **OK**, then click **I Accept** to accept the license.
     > [!IMPORTANT]
-    > The [Microsoft.IdentityModel.Clients.ActiveDirectory](https://www.nuget.org/packages/Microsoft.IdentityModel.Clients.ActiveDirectory) NuGet package and Azure AD Authentication Library (ADAL) have been deprecated. No new features have been added since June 30, 2020.   We strongly encourage you to upgrade, see the [migration guide](../active-directory/develop/msal-migration.md) for more details.
+    > The [Microsoft.IdentityModel.Clients.ActiveDirectory](https://www.nuget.org/packages/Microsoft.IdentityModel.Clients.ActiveDirectory) NuGet package and Azure AD Authentication Library (ADAL) have been deprecated. No new features have been added since June 30, 2020.   We strongly encourage you to upgrade. For more information see the [migration guide](../active-directory/develop/msal-migration.md).
 
 5. In Program.cs, replace the existing **using** statements with the following code:
 
@@ -170,7 +168,7 @@ You can now complete the application by calling the **CreateIoTHub** method befo
 
 ## Next steps
 
-Now you have deployed an IoT hub using the resource provider REST API, you may want to explore further:
+Since you've deployed an IoT hub using the resource provider REST API, you may want to explore further:
 
 * Read about the capabilities of the [IoT Hub resource provider REST API](/rest/api/iothub/iothubresource).
 

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

@@ -6,7 +6,7 @@ ms.topic: include
 ms.date: 10/26/2018
 ---
 ## Prepare to authenticate Azure Resource Manager requests
-You must authenticate all the operations that you perform on resources using the [Azure Resource Manager][lnk-authenticate-arm] with Azure Active Directory (AD). The easiest way to configure this is to use PowerShell or Azure CLI.
+You must authenticate all the operations that you perform on resources using the [Azure Resource Manager][lnk-authenticate-arm] with Azure Active Directory (AD). The easiest way to configure Azure AD is to use PowerShell or Azure CLI.
 
 Install the [Azure PowerShell cmdlets][lnk-powershell-install] before you continue.
 
@@ -18,44 +18,50 @@ The following steps show how to set up password authentication for an AD applica
     Connect-AzAccount
     ```
 
-1. If you have multiple Azure subscriptions, signing in to Azure grants you access to all the Azure subscriptions associated with your credentials. Use the following command to list the Azure subscriptions available for you to use:
+1. If you have multiple Azure subscriptions, signing in to Azure grants you access to all the Azure subscriptions associated with your credentials. 
 
-    ```powershell
-    Get-AzSubscription
-    ```
+   List the Azure subscriptions available for you to use:
 
-    Use the following command to select subscription that you want to use to run the commands to manage your IoT hub. You can use either the subscription name or ID from the output of the previous command:
+   ```powershell
+   Get-AzSubscription
+   ```
 
-    ```powershell
-    Select-AzSubscription `
-        -SubscriptionName "{your subscription name}"
-    ```
+   Select the subscription you want to use. You can use either the subscription name or ID from the output of the previous command.
+
+   ```powershell
+   Select-AzSubscription -SubscriptionName "{your subscription name}"
+   ```
 
-2. Make a note of your **TenantId** and **SubscriptionId**. You need them later.
-3. Create a new Azure Active Directory application using the following command, replacing the place holders:
+1. Save your **TenantId** and **SubscriptionId** for later.
+
+1. Create a new Azure Active Directory application using the following command, replacing the placeholders:
 
    * **{Display name}:** a display name for your application such as **MySampleApp**
-   * **{Home page URL}:** the URL of the home page of your app such as **http:\//mysampleapp/home**. This URL does not need to point to a real application.
-   * **{Application identifier}:** A unique identifier such as **http:\//mysampleapp**. This URL does not need to point to a real application.
+   * **{Home page URL}:** the URL of the home page of your app such as **http:\//mysampleapp/home**. This URL doesn't need to point to a real application.
+   * **{Application identifier}:** A unique identifier such as **http:\//mysampleapp**. This URL doesn't need to point to a real application.
    * **{Password}:** A password that you use to authenticate with your app.
 
      ```powershell
-     $SecurePassword=ConvertTo-SecureString {password} –asplaintext –force
+     $SecurePassword=ConvertTo-SecureString {password} -asplaintext -force
      New-AzADApplication -DisplayName {Display name} -HomePage {Home page URL} -IdentifierUris {Application identifier} -Password $SecurePassword
      ```
-4. Make a note of the **ApplicationId** of the application you created. You need this later.
-5. Create a new service principal using the following command, replacing **{MyApplicationId}** with the **ApplicationId** from the previous step:
+1. Save the **ApplicationId** of the application you created for later.
+
+1. Create a new service principal using the following command, replacing **{MyApplicationId}** with the **ApplicationId** from the previous step:
    
     ```powershell
     New-AzADServicePrincipal -ApplicationId {MyApplicationId}
     ```
-6. Set up a role assignment using the following command, replacing **{MyApplicationId}** with your **ApplicationId**.
+
+1. Set up a role assignment using the following command, replacing **{MyApplicationId}** with your **ApplicationId**.
    
     ```powershell
     New-AzRoleAssignment -RoleDefinitionName Owner -ServicePrincipalName {MyApplicationId}
     ```
 
-You have now finished creating the Azure AD application that enables you to authenticate from your custom C# application. You need the following values later in this tutorial:
+With your new Azure AD application, you can now authenticate from your custom C# application. 
+
+You need the following values later in this tutorial:
 
 * TenantId
 * SubscriptionId