Updated language for VS Code interaction, removed Device Workbench content.

KennedyDMSFT · KennedyDMSFT · commit 13c39eb9bd1b · 2023-04-21T11:29:15.000-07:00
diff --git a/articles/iot-hub/iot-hub-create-use-iot-toolkit.md b/articles/iot-hub/iot-hub-create-use-iot-toolkit.md
@@ -23,11 +23,13 @@ This article shows you how to use the [Azure IoT Hub extension for Visual Studio
 
 - [Azure IoT Hub extension](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) installed for Visual Studio Code
 
+- An Azure subscription: [create a free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+
 - An Azure resource group: [create a resource group](../azure-resource-manager/management/manage-resource-groups-portal.md#create-resource-groups) in the Azure portal
 
-## Create an IoT hub without an IoT Project
+## Create an IoT hub
 
-The following steps show how to create an IoT Hub without an IoT Project in Visual Studio Code (VS Code).
+The following steps show how to create an IoT hub in Visual Studio Code (VS Code).
 
 1. In VS Code, open the **Explorer** view.
 
@@ -39,7 +41,7 @@ The following steps show how to create an IoT Hub without an IoT Project in Visu
 
    :::image type="content" source="./media/iot-hub-create-use-iot-toolkit/create-iot-hub.png" alt-text="A screenshot that shows the location of the Create IoT Hub list item in Visual Studio Code." lightbox="./media/iot-hub-create-use-iot-toolkit/create-iot-hub.png":::
 
-4. A pop-up shows in the bottom-right corner to let you sign in to Azure for the first time, if you're not signed in already.
+4. If you're not signed into Azure, a pop-up notification is shown in the bottom right corner to let you sign in to Azure. Select **Sign In** and follow the instructions to sign into Azure.
 
 5. From the command palette at the top of VS Code, select your Azure subscription.
 
@@ -49,55 +51,12 @@ The following steps show how to create an IoT Hub without an IoT Project in Visu
 
 8. Select a pricing tier.
 
-9. Enter a globally unique name for your IoT hub, then press **Enter**.
-
-10. Wait a few minutes until the IoT hub is created. You'll see a confirmation in the output console.
-
-## Create an IoT hub and device in an existing IoT project
-
-The following steps show how to create an IoT hub and register a device to the hub within an existing IoT project in Visual Studio (VS) Code.
-
-This method allows you to provision in Visual Studio Code without leaving your development environment.
-
-1. In the new opened project window, press `F1` to open the command palette, type and select **Azure IoT Device Workbench: Provision Azure Services...**.
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/provision.png" alt-text="A screenshot that shows how to open the command palette in VS Code." lightbox="media/iot-hub-create-use-iot-toolkit/provision.png":::
-
-    > [!NOTE]
-    > If you have not signed into Azure, follow the pop-up notification for signing in.
-
-1. Select the subscription you want to use.
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-subscription.png" alt-text="A screenshot that shows how to choose your Azure subscription in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-subscription.png":::
-
-1. Select an existing resource group or create a new [resource group](../azure-resource-manager/management/overview.md#terminology).
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-resource-group.png" alt-text="A screenshot that shows how to choose a resource group or create a new one in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-resource-group.png":::
-
-1. In the resource group you specified, follow the prompts to select an existing IoT hub or create a new Azure IoT hub.
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png" alt-text="A screenshot that shows the first prompt in choosing an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provision.png":::
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png" alt-text="A screenshot that shows the second prompt in choosing an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-hub.png":::
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png" alt-text="A screenshot that shows the third prompt in choosing an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-selected.png":::
-
-1. In the output window, you see the Azure IoT hub provisioned.
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-hub-provisioned.png" alt-text="A screenshot that shows the output window in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-hub-provisioned.png":::
-
-1. Select or create a new IoT device in the Azure IoT hub you provisioned.
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png" alt-text="A screenshot that shows the fourth prompt in choosing an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/iot-device-provision.png":::
-
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/select-iot-device.png" alt-text="A screenshot that shows an example of an existing IoT hub in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/select-iot-device.png":::
-
-1. Now you have an Azure IoT hub provisioned and a device created in it. The device connection string is saved in VS Code.
+9. Enter a globally unique name for your IoT hub, and then select the Enter key.
 
-   :::image type="content" source="media/iot-hub-create-use-iot-toolkit/provision-done.png" alt-text="A screenshot that shows IoT hub details in the output window in Visual Studio Code." lightbox="media/iot-hub-create-use-iot-toolkit/provision-done.png":::
+10. Wait a few minutes until the IoT hub is created. You'll see a confirmation in the **Output** panel.
 
 > [!TIP]
-> To delete a device from your IoT hub, use the `Azure IoT Hub: Delete Device` option from the Command Palette. There is no option to delete your IoT hub in Visual Studio Code, however you can [delete your hub in the Azure portal](iot-hub-create-through-portal.md#delete-an-iot-hub).
+> There is no option to delete your IoT hub in Visual Studio Code, however you can [delete your hub in the Azure portal](iot-hub-create-through-portal.md#delete-an-iot-hub).
 
 ## Next steps
 
diff --git a/articles/iot-hub/iot-hub-device-management-iot-toolkit.md b/articles/iot-hub/iot-hub-device-management-iot-toolkit.md
@@ -13,7 +13,7 @@ ms.date: 01/04/2019
 
 ![End-to-end diagram](media/iot-hub-get-started-e2e-diagram/2.png)
 
-In this article, you learn how to use the [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) with various management options on your development machine. The IoT Hub extension is a useful Visual Studio Code extension that makes IoT Hub management and IoT application development easier. It comes with management options that you can use to perform various tasks.
+In this article, you learn how to use the [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) with various management options on your development machine. The IoT Hub extension is a useful Visual Studio (VS) Code extension that makes IoT Hub management and IoT application development easier. It comes with management options that you can use to perform various tasks.
 
 [!INCLUDE [iot-hub-basic](../../includes/iot-hub-basic-whole.md)]
 
@@ -39,50 +39,66 @@ Device twins are JSON documents that store device state information (metadata, c
 
 ## Sign in to access your IoT hub
 
-1. In **Explorer** view of VS Code, expand **Azure IoT Hub Devices** section in the bottom left corner.
+Follow these steps to sign into Azure and access your IoT hub from your Azure subscription:
 
-2. Click **Select IoT Hub** in context menu.
+1. In the **Explorer** view of VS Code, expand the **Azure IoT Hub** section in the side bar.
 
-3. A pop-up will show in the bottom right corner to let you sign in to Azure for the first time.
+1. Select the ellipsis (…) button of the **Azure IoT Hub** section to display the action menu, and then select **Select IoT Hub** from the action menu.
 
-4. After you sign in, your Azure Subscription list will be shown, then select Azure Subscription and IoT Hub.
+1. If you're not signed into Azure, a pop-up notification is shown in the bottom right corner to let you sign in to Azure. Select **Sign In** and follow the instructions to sign into Azure.
 
-5. The device list will be shown in **Azure IoT Hub Devices** tab in a few seconds.
+1. From the command palette at the top of VS Code, select your Azure subscription from the **Select Subscription** dropdown list.
+
+1. Select your IoT hub from the **Select IoT Hub** dropdown list.
+
+1. The devices for your IoT hub are retrieved from IoT Hub and shown under the **Devices** node in the **Azure IoT Hub** section of the side bar.
 
    > [!NOTE]
-   > You can also complete the set up by choosing **Set IoT Hub Connection String**. Enter the **iothubowner** policy connection string for the IoT hub that your IoT device connects to in the pop-up window.
+   > You can also use a connection string to access your IoT hub, by selecting **Set IoT Hub Connection String** from the action menu and entering the **iothubowner** policy connection string for your IoT hub in the **IoT Hub Connection String** input box. 
 
 ## Direct methods
 
-1. Right-click your device and select **Invoke Direct Method**. 
+To invoke a direct method from your IoT device, follow these steps:
+
+1. In the side bar, expand the **Devices** node under the **Azure IoT Hub** section.
+
+1. Right-click your IoT device and select **Invoke Device Direct Method**. 
 
-2. Enter the method name and payload in input box.
+1. Enter the method name in the input box, and then select the Enter key.
 
-3. Results will be shown in **OUTPUT** > **Azure IoT Hub** view.
+1. Enter the payload in the input box, and then select the Enter key.
+
+1. The results are shown in the **Output** panel.
 
 ## Read device twin
 
-1. Right-click your device and select **Edit Device Twin**. 
+To display the JSON document for the device twin of your IoT device, follow these steps:
+
+1. In the side bar, expand the **Devices** node under the **Azure IoT Hub** section.
+ 
+1. Right-click your IoT device and select **Edit Device Twin**. 
 
-2. An **azure-iot-device-twin.json** file will be opened with the content of device twin.
+1. The JSON document for the device twin, named **azure-iot-device-twin.json**, is shown in the editor.
 
 ## Update device twin
 
-1. Make some edits of **tags** or **properties.desired** field.
+After [reading the device twin](#read-device-twin), follow these steps to update the device twin for your IoT device:
 
-2. Right-click on the **azure-iot-device-twin.json** file.
+1. Make changes to arrays or values in the JSON document for the device twin. For example, add tags in the **tags** array, or change the values of desired properties in the **properties.desired** array.
 
-3. Select **Update Device Twin** to update the device twin.
+1. Right-click the content area of the **azure-iot-device-twin.json** file and select **Update Device Twin**.
 
 ## Send cloud-to-device messages
 
 To send a message from your IoT hub to your device, follow these steps:
  
-1. Right-click your device and select **Send C2D Message to Device**. 
+1. In the side bar, expand the **Devices** node under the **Azure IoT Hub** section.
+
+1. Right-click your IoT device and select **Send C2D Message to Device**. 
 
-2. Enter the message in input box.
+1. Enter the message in the input box, and then select the Enter key.
 
-3. Results will be shown in **OUTPUT** > **Azure IoT Hub** view.
+1. The results are shown in the **Output** panel.
 
 ## Next steps
 
diff --git a/articles/iot-hub/iot-hub-mqtt-support.md b/articles/iot-hub/iot-hub-mqtt-support.md
@@ -121,14 +121,14 @@ If a device can't use the device SDKs, it can still connect to the public device
   You can also use the cross-platform [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit) or the CLI extension command [az iot hub generate-sas-token](/cli/azure/iot/hub#az-iot-hub-generate-sas-token) to quickly generate a SAS token. You can then copy and paste the SAS token into your own code for testing purposes.
 
 ### Using the Azure IoT Hub extension for Visual Studio Code
-
-1. Expand the **AZURE IOT HUB DEVICES** tab in the bottom left corner of Visual Studio Code.
   
-2. Right-click your device and select **Generate SAS Token for Device**.
+1. In the side bar, expand the **Devices** node under the **Azure IoT Hub** section.
+
+1. Right-click your IoT device and select **Generate SAS Token for Device** from the context menu. 
   
-3. Set **expiration time** and press 'Enter'.
+1. Enter the expiration time, in hours, for the SAS token in the input box, and then select the Enter key.
   
-4. The SAS token is created and copied to clipboard.
+1. The SAS token is created and copied to clipboard.
 
    The SAS token that's generated has the following structure:
 
diff --git a/articles/iot-hub/iot-hub-vscode-iot-toolkit-cloud-device-messaging.md b/articles/iot-hub/iot-hub-vscode-iot-toolkit-cloud-device-messaging.md
@@ -32,38 +32,46 @@ The [Azure IoT Hub extension for Visual Studio Code](https://marketplace.visuals
 
 ## Sign in to access your IoT hub
 
-1. In **Explorer** view of VS Code, expand **Azure IoT Hub Devices** section in the bottom left corner.
+Follow these steps to sign into Azure and access your IoT hub from your Azure subscription:
 
-2. Click **Select IoT Hub** in context menu.
+1. In the **Explorer** view of VS Code, expand the **Azure IoT Hub** section in the side bar.
 
-3. A pop-up will show in the bottom right corner to let you sign in to Azure for the first time.
+1. Select the ellipsis (…) button of the **Azure IoT Hub** section to display the action menu, and then select **Select IoT Hub** from the action menu.
 
-4. After you sign in, your Azure Subscription list will be shown, then select Azure Subscription and IoT Hub.
+1. If you're not signed into Azure, a pop-up notification is shown in the bottom right corner to let you sign in to Azure. Select **Sign In** and follow the instructions to sign into Azure.
 
-5. The device list will be shown in **Azure IoT Hub Devices** tab in a few seconds.
+1. Select your Azure subscription from the **Select Subscription** dropdown list.
+
+1. Select your IoT hub from the **Select IoT Hub** dropdown list.
+
+1. The devices for your IoT hub are retrieved from IoT Hub and shown under the **Devices** node in the **Azure IoT Hub** section of the side bar.
 
    > [!NOTE]
-   > You can also complete the set up by choosing **Set IoT Hub Connection String**. Enter the **iothubowner** policy connection string for the IoT hub that your IoT device connects to in the pop-up window.
+   > You can also use a connection string to access your IoT hub, by selecting **Set IoT Hub Connection String** from the action menu and entering the **iothubowner** policy connection string for your IoT hub in the **IoT Hub Connection String** input box. 
 
 ## Monitor device-to-cloud messages
 
 To monitor messages that are sent from your device to your IoT hub, follow these steps:
 
-1. Right-click your device and select **Start Monitoring Built-in Event Endpoint**.
+1. In the side bar, expand the **Devices** node under the **Azure IoT Hub** section.
+
+1. Right-click your IoT device and select **Start Monitoring Built-in Event Endpoint**. 
 
-2. The monitored messages will be shown in **OUTPUT** > **Azure IoT Hub** view.
+1. The monitored messages are shown in the **Output** panel.
 
-3. To stop monitoring, right-click the **OUTPUT** view and select **Stop Monitoring Built-in Event Endpoint**.
+1. To stop monitoring messages, right-click the **Output** panel and select **Stop Monitoring Built-in Event Endpoint**.
 
 ## Send cloud-to-device messages
 
 To send a message from your IoT hub to your device, follow these steps:
+ 
+1. In the side bar, expand the **Devices** node under the **Azure IoT Hub** section.
 
-1. Right-click your device and select **Send C2D Message to Device**.
+1. Right-click your IoT device and select **Send C2D Message to Device** from the context menu. 
 
-2. Enter the message in input box.
+1. Enter the message in the input box, and then select the Enter key.
 
-3. Results will be shown in **OUTPUT** > **Azure IoT Hub** view.
+1. The results are shown in the **Output** panel.
 
 ## Next steps
 
