Merge pull request MicrosoftDocs#94243 from spelluru/labps1031

Az.LabServices module

Author: megvanhuygen

articles/lab-services/classroom-labs/TOC.yml

@@ -82,6 +82,8 @@
   items:
   - name: REST API
     href: https://docs.microsoft.com/rest/api/labservices/
+  - name: Az.LabServices PowerShell module (preview)
+    href: reference-powershell-module.md
 - name: Resources
   items:
   - name: Azure updates

articles/lab-services/classroom-labs/how-to-manage-classroom-labs.md

@@ -24,7 +24,7 @@ To set up a classroom lab in a lab account, you must be a member of the **Lab Cr
 
 ## Create a classroom lab
 
-1. Navigate to [Azure Lab Services website](https://labs.azure.com). Note that Internet Explorer 11 is not supported yet. 
+1. Navigate to [Azure Lab Services website](https://labs.azure.com). Internet Explorer 11 is not supported yet. 
 2. Select **Sign in** and enter your credentials. Select or enter a **user ID** that is a member of the **Lab Creator** role in the lab account, and enter password. Azure Lab Services supports organizational accounts and Microsoft accounts. 
 3. Select **New lab**. 
 
@@ -119,8 +119,10 @@ To switch to another classroom lab from the current, select the drop-down list o
 
 You can also create a new lab using the **New lab** in this drop-down list. 
 
-To switch to a different lab account, select the drop-down next to the lab account and select the other lab account. 
+> [!NOTE]
+> You can also use the Az.LabServices PowerShell module (preview) to manage labs. For more information, see the [Az.LabServices home page on GitHub](https://github.com/Azure/azure-devtestlab/tree/master/samples/ClassroomLabs/Modules/Library).
 
+To switch to a different lab account, select the drop-down next to the lab account and select the other lab account. 
 
 ## Next steps
 See the following articles:

articles/lab-services/classroom-labs/how-to-manage-lab-accounts.md

@@ -12,7 +12,7 @@ ms.workload: na
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 05/07/2019
+ms.date: 10/31/2019
 ms.author: spelluru
 
 ---
@@ -23,7 +23,7 @@ In Azure Lab Services, a lab account is a container for managed lab types such a
 The following steps illustrate how to use the Azure portal to create a lab account with Azure Lab Services. 
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-2. Select **All Services** on the left menu. Select **Lab Accounts** in the **DEVOPS** section. If you select star (`*`) next to **Lab Accounts**, it's added to the **FAVORITES** section on the left menu. From the next time onwards, you select **Lab Accounts** under **FAVORITES**.
+2. Select **All Services** on the left menu. Select **Lab Accounts** in the **DevOps** section. If you select star (`*`) next to **Lab Accounts**, it's added to the **FAVORITES** section on the left menu. From the next time onwards, you select **Lab Accounts** under **FAVORITES**.
 
     ![All Services -> Lab Accounts](../media/tutorial-setup-lab-account/select-lab-accounts-service.png)
 3. On the **Lab Accounts** page, select **Add** on the toolbar. 
@@ -92,6 +92,8 @@ Follow instructions from the previous section that displays lab accounts in a li
 
     ![Delete lab account - confirmation](../media/how-to-manage-lab-accounts/delete-lab-account-confirmation.png)
 
+> [!NOTE]
+> You can also use the Az.LabServices PowerShell module (preview) to manage lab accounts. For more information, see the [Az.LabServices home page on GitHub](https://github.com/Azure/azure-devtestlab/tree/master/samples/ClassroomLabs/Modules/Library).
 
 ## Next steps
 See the following article: [How to configure lab accounts](how-to-configure-lab-accounts.md).

articles/lab-services/classroom-labs/reference-powershell-module.md

@@ -0,0 +1,47 @@
+---
+title: PowerShell module for Azure Lab Services | Microsoft Docs
+description: This article provides information about a PowerShell module that helps with managing artifacts in Azure Lab Services. 
+services: lab-services
+documentationcenter: na
+author: spelluru
+manager: 
+editor: ''
+
+ms.service: lab-services
+ms.workload: na
+ms.tgt_pltfrm: na
+ms.devlang: na
+ms.topic: article
+ms.date: 11/01/2019
+ms.author: spelluru
+
+---
+# Az.LabServices PowerShell module (preview)
+Az.LabServices is a PowerShell module that simplifies the management of Azure Lab services. It provides composable functions to create, query, update and delete lab accounts, labs, VMs, and Images. For more information about this module, see the [Az.LabServices home page on GitHub](https://github.com/Azure/azure-devtestlab/tree/master/samples/ClassroomLabs/Modules/Library).
+
+> [!NOTE]
+> This module is in **preview**. 
+
+## Example command
+Here is an example of using a PowerShell command to stop all the running VMs in all labs.
+
+```powershell
+Get-AzLabAccount | Get-AzLab | Get-AzLabVm -Status Running | Stop-AzLabVm
+```
+
+## Get started
+1. Install [Azure PowerShell](https://docs.microsoft.com/powershell/azure/overview) if it doesn't exist on your machine. 
+2. Download [Az.LabServices.psm1](https://github.com/Azure/azure-devtestlab/blob/master/samples/ClassroomLabs/Modules/Library/Az.LabServices.psm1) to your machine.
+3. Import the module:
+
+    ```powershell
+    Import-Module .\Az.LabServices.psm1
+    ```
+4. Run the following command to list all the labs in your subscription.
+
+    ```powershell
+    Get-AzLabAccount | Get-AzLab
+    ```
+
+## Next steps
+See the [Az.LabServices home page on GitHub](https://github.com/Azure/azure-devtestlab/tree/master/samples/ClassroomLabs/Modules/Library).