Merge pull request #41748 from spelluru/labspecific0521

Labspecific0521

Author: rjagiewich

.openpublishing.redirection.json

@@ -5900,6 +5900,36 @@
             "redirect_url": "https://docs.microsoft.com/azure/cosmos-db/create-mongodb-dotnet",
             "redirect_document_id": false
         },
+        {
+            "source_path": "articles/lab-services/how-to-manage-classroom-labs.md",
+            "redirect_url": "/azure/lab-services/classroom-labs/how-to-manage-classroom-labs",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "articles/lab-services/how-to-manage-lab-accounts.md",
+            "redirect_url": "/azure/lab-services/classroom-labs/how-to-manage-lab-accounts",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "articles/lab-services/how-to-use-classroom-lab.md",
+            "redirect_url": "/azure/lab-services/classroom-labs/how-to-use-classroom-lab",
+            "redirect_document_id": false
+        },                        
+        {
+            "source_path": "articles/lab-services/tutorial-connect-virtual-machine-classroom-lab.md",
+            "redirect_url": "/azure/lab-services/classroom-labs/tutorial-connect-virtual-machine-classroom-lab",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "articles/lab-services/tutorial-setup-classroom-lab.md",
+            "redirect_url": "/azure/lab-services/classroom-labs/tutorial-setup-classroom-lab",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "articles/lab-services/tutorial-setup-lab-account.md",
+            "redirect_url": "/azure/lab-services/classroom-labs/tutorial-setup-lab-account",
+            "redirect_document_id": false
+        },
         {
             "source_path": "articles/log-analytics/log-analytics-security.md",
             "redirect_url": "/azure/log-analytics/log-analytics-data-security",

articles/lab-services/TOC.yml

@@ -17,11 +17,11 @@
   - name: Classroom labs
     items: 
     - name: 1. Set up a lab account
-      href: tutorial-setup-lab-account.md
+      href: classroom-labs/tutorial-setup-lab-account.md
     - name: 2. Set up a classroom lab
-      href: tutorial-setup-classroom-lab.md 
+      href: classroom-labs/tutorial-setup-classroom-lab.md 
     - name: 3. Access a classroom lab
-      href: tutorial-connect-virtual-machine-classroom-lab.md      
+      href: classroom-labs/tutorial-connect-virtual-machine-classroom-lab.md      
 - name: Samples
   items:
   - name: DevTest Labs
@@ -50,11 +50,11 @@
   - name: Classroom labs
     items: 
     - name: Manage lab accounts
-      href: how-to-manage-lab-accounts.md
+      href: classroom-labs/how-to-manage-lab-accounts.md
     - name: Manage classroom labs
-      href: how-to-manage-classroom-labs.md
+      href: classroom-labs/how-to-manage-classroom-labs.md
     - name: Access classroom labs
-      href: how-to-use-classroom-lab.md
+      href: classroom-labs/how-to-use-classroom-lab.md
   - name: DevTest labs
     items:
     - name: Create a custom lab

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

@@ -0,0 +1,49 @@
+- name: Lab Services Documentation
+  href: /azure/lab-services
+- name: Overview
+  items:
+  - name: About classroom labs
+    href: classroom-labs-overview.md
+- name: Tutorials
+  items:
+  - name: 1. Set up a lab account
+    href: tutorial-setup-lab-account.md
+  - name: 2. Set up a classroom lab
+    href: tutorial-setup-classroom-lab.md 
+  - name: 3. Access a classroom lab
+    href: tutorial-connect-virtual-machine-classroom-lab.md      
+- name: How-to guides
+  items:
+  - name: Manage lab accounts
+    href: how-to-manage-lab-accounts.md
+  - name: Manage classroom labs
+    href: how-to-manage-classroom-labs.md
+  - name: Access classroom labs
+    href: how-to-use-classroom-lab.md
+- name: Reference
+  items:
+  - name: CLI 2.0
+    href: /cli/azure/lab
+  - name: PowerShell
+    href: /powershell/module/azurerm.devtestlabs/#devtest_labs
+  - name: REST API
+    href: https://docs.microsoft.com/rest/api/dtl/
+- name: Resources
+  items:
+  - name: Azure Roadmap
+    href: https://azure.microsoft.com/roadmap/?category=developer-tools
+  - name: Pricing calculator
+    href: https://azure.microsoft.com/pricing/calculator/
+  - name: Service Updates
+    href: https://azure.microsoft.com/updates/?product=devtest-lab
+  - name: MSDN Forum
+    href: https://social.msdn.microsoft.com/Forums/home?forum=AzureDevTestLabs
+  - name: Team Blog
+    href: https://blogs.msdn.microsoft.com/devtestlab/
+  - name: Stack Overflow
+    href: http://stackoverflow.com/questions/tagged/azure-devtest-labs
+  - name: Videos
+    href: https://azure.microsoft.com/documentation/videos/index/?services=devtest-lab
+  - name: Pricing
+    href: https://azure.microsoft.com/pricing/details/devtest-lab/
+  

articles/lab-services/classroom-labs/classroom-labs-overview.md

@@ -0,0 +1,62 @@
+---
+title: About Azure Lab Services | Microsoft Docs
+description: Learn how Lab Services can make it easy to create, manage, and secure labs with virtual machines that can be used by developers, testers, educators, students, and others. 
+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: overview
+ms.date: 05/21/2018
+ms.author: spelluru
+
+---
+# Introduction to classroom labs
+Azure Lab Services enables you to quickly set up a classroom lab environment in the cloud. An educator creates a classroom lab, provisions Windows, or Linux virtual machines, installs the necessary software and tools labs in the class, and makes them available to students. The students in the class connect to virtual machines (VMs) in the lab, and use them for their projects, assignments, classroom exercises. 
+
+The classroom labs are managed labs that are managed by Azure. The service itself handles all the infrastructure management for a managed lab, from spinning up virtual machines (VMs) to handling errors, and scaling the infrastructure. You specify what kind of infrastructure you need and install any tools or software that's required for the class. The managed labs are currently in preview.  
+
+## Scenarios
+Here is the main scenario that classroom labs of Azure Lab Services support: 
+
+### Set up a resizable computer lab in the cloud for your classroom  
+
+- Create a managed classroom lab. You just tell the service exactly what you need, and it creates and manages the infrastructure of the lab for you so that you can focus on teaching your class, not technical details of a lab. 
+- Provide students with a lab of virtual machines that are configured with exactly what’s needed for a class. Give each student a limited number of hours for using the VMs for class work.  
+- Move your school’s physical computer lab into the cloud. Automatically scale the number of VMs only to the maximum usage and cost threshold that you set on the lab. 
+- Delete the lab with a single click once you’re done. 
+
+## User profiles
+This article describes different user profiles in Azure Lab Services. 
+
+### Lab account owner
+Typically, and IT administrator of organization's cloud resources, who owns the Azure subscription acts as a lab account owner and does the following tasks:   
+
+- Sets up a lab account for your organization.
+- Manages and configures policies across all labs.
+- Gives permissions to people in the organization to create a lab under the lab account.
+
+### Educator
+Typically, users such as a teacher or an online trainer creates classroom labs under a lab account. An educator does the following tasks: 
+
+- Creates a classroom lab.
+- Creates virtual machines in the lab. 
+- Installs the appropriate software on virtual machines.
+- Specifies who can access the lab.
+- Provides registration link to the lab to students.
+
+### Student
+A student does the following tasks:
+
+- Uses the registration link that the lab user receives from a lab creator to register with the lab. 
+- Connects to a virtual machine in the lab and use it for doing class work, assignments, and projects. 
+
+## Next steps
+Get started with setting up a classroom lab using Azure Lab Services:
+
+- [Set up a classroom lab](tutorial-setup-classroom-lab.md)

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

@@ -29,18 +29,18 @@ This article describes how to create and configure a classroom lab, view all cla
     4. Specify the **default credentials** to use for logging into the virtual machines in the lab.
     7. Select **Save**.
 
-        ![Create a classroom lab](./media/how-to-manage-classroom-labs/new-lab-window.png)
+        ![Create a classroom lab](../media/how-to-manage-classroom-labs/new-lab-window.png)
 1. You see the **home page** for the lab. 
 
-    ![Classroom lab home page](./media/how-to-manage-classroom-labs/classroom-lab-home-page.png)
+    ![Classroom lab home page](../media/how-to-manage-classroom-labs/classroom-lab-home-page.png)
 
 ## Configure usage policy
 
 1. Select **Usage policy**. 
 2. In the **Usage policy**, settings, enter the **number of users** allowed to use the lab.
 3. Select **Save**. 
 
-    ![Usage policy](./media/how-to-manage-classroom-labs/usage-policy-settings.png)
+    ![Usage policy](../media/how-to-manage-classroom-labs/usage-policy-settings.png)
 
 ## Set up the template
 A template in a lab is a base virtual machine image from which all users’ virtual machines are created. Set up the template virtual machine so that it is configured with exactly what you want to provide to the lab users. You can provide a name and description of the template that the lab users see. Set the visibility of the template to public to make instances of the template VM available to your lab users.  
@@ -51,7 +51,7 @@ A template in a lab is a base virtual machine image from which all users’ virt
 3. Enter **description** for the template.
 4. Select **Save**.
 
-    ![Classroom lab description](./media/how-to-manage-classroom-labs/lab-description.png)
+    ![Classroom lab description](../media/how-to-manage-classroom-labs/lab-description.png)
 
 ### Make instances of the template public 
 Once you set the visibility of a template to **Public**, Azure Lab Services creates VMs in the lab by using the template. The number of VMs created in this process is same as the maximum number of users allowed into the lab, which you can set in the usage policy of the lab. All virtual machines have the same configuration as the template.  
@@ -63,36 +63,36 @@ Once you set the visibility of a template to **Public**, Azure Lab Services crea
     > Once a template is publicly available, its access can't be changed to private. 
 3. Select **Save**.
 
-    ![Availability](./media/how-to-manage-classroom-labs/public-access.png)
+    ![Availability](../media/how-to-manage-classroom-labs/public-access.png)
 
 ## Send registration link to students
 
 1. Select **User registration** tile.
 2. In the **User registration** dialog box, select the **Copy** button. The link is copied to the clipboard. Paste it in an email editor, and send an email to the student. 
 
-    ![Student registration link](./media/how-to-manage-classroom-labs/registration-link.png)
+    ![Student registration link](../media/how-to-manage-classroom-labs/registration-link.png)
 
 ## View all classroom labs
 1. Navigate to [Azure Lab Services portal](https://labs.azure.com).
 2. Confirm that you see all the labs in the selected lab account. 
 
-    ![All labs](./media/how-to-manage-classroom-labs/all-labs.png)
+    ![All labs](../media/how-to-manage-classroom-labs/all-labs.png)
 3. Use the drop-down list at the top to select a different lab account. You see labs in the selected lab account. 
 
 ## Delete a classroom lab
 1. On the tile for the lab, select three dots (...) in the corner. 
 
-    ![Select the lab](./media/how-to-manage-classroom-labs/select-three-dots.png)
+    ![Select the lab](../media/how-to-manage-classroom-labs/select-three-dots.png)
 2. Select **Delete**. 
 
-    ![Delete button](./media/how-to-manage-classroom-labs/delete-button.png)
+    ![Delete button](../media/how-to-manage-classroom-labs/delete-button.png)
 3. On the **Delete lab** dialog box, select **Delete**. 
 
-    ![Delete dialog box](./media/how-to-manage-classroom-labs/delete-lab-dialog-box.png)
+    ![Delete dialog box](../media/how-to-manage-classroom-labs/delete-lab-dialog-box.png)
 
 
 ## Next steps
 Get started with setting up a lab using Azure Lab Services:
 
 - [Set up a classroom lab](how-to-manage-classroom-labs.md)
-- [Set up a custom lab](tutorial-create-custom-lab.md)
+- [Set up a custom lab](../tutorial-create-custom-lab.md)

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

@@ -32,23 +32,23 @@ This article describes how to create a lab account, view all lab accounts, or de
     4. For **Location**, select a location/region in which you want the lab account to be created. 
     5. Select **Create**. 
 
-        ![Create a lab account window](./media/how-to-manage-lab-accounts/lab-account-settings.png)
+        ![Create a lab account window](../media/how-to-manage-lab-accounts/lab-account-settings.png)
 5. If you don't see the page for the lab account, select the **notifications** button, and then click **Go to resource** button in the notifications. 
 
-    ![Create a lab account window](./media/how-to-manage-lab-accounts/notification-go-to-resource.png)    
+    ![Create a lab account window](../media/how-to-manage-lab-accounts/notification-go-to-resource.png)    
 6. You see the following **lab account** page:
 
-    ![Lab account page](./media/how-to-manage-lab-accounts/lab-account-page.png)
+    ![Lab account page](../media/how-to-manage-lab-accounts/lab-account-page.png)
 
 ## Add a user to the Lab Creator role
 To provide educators the permission to create labs for their classes, add them to the Lab Creator role:
 
 1. On the **Lab Account** page, select **Access control (IAM)**, and click **+ Add** on the toolbar. 
 
-    ![Lab account page](./media/tutorial-setup-lab-account/access-control.png)
+    ![Lab account page](../media/tutorial-setup-lab-account/access-control.png)
 2. On the **Add permissions** page, select **Lab Creator** for **Role**, select the user you want to add to the Lab Creators role, and select **Save**. 
 
-    ![Add user to the Lab Creator role](./media/tutorial-setup-lab-account/add-user-to-lab-creator-role.png)
+    ![Add user to the Lab Creator role](../media/tutorial-setup-lab-account/add-user-to-lab-creator-role.png)
 
 
 ## View lab accounts
@@ -69,4 +69,4 @@ Follow instructions from the previous section that displays lab accounts in a li
 Get started with setting up a lab using Azure Lab Services:
 
 - [Set up a classroom lab](tutorial-setup-classroom-lab.md)
-- [Set up a custom lab](tutorial-create-custom-lab.md)
+- [Set up a custom lab](../tutorial-create-custom-lab.md)

articles/lab-services/how-to-use-classroom-lab.md renamed to articles/lab-services/classroom-labs/how-to-use-classroom-lab.md

@@ -26,19 +26,19 @@ This article describes how to access a classroom lab, connect to the VM in the l
 2. Sign in to the service using your school account to complete the registration. 
 3. Once registered, confirm that you see the virtual machines for the labs you have access to. 
 
-    ![View all labs](./media/how-to-use-classroom-lab/all-labs.png)
+    ![View all labs](../media/how-to-use-classroom-lab/all-labs.png)
 
 ## Connect to the virtual machine in a classroom lab
 
 1. Select **Connect** on the tile that represents the virtual machine of the lab that you want to access.
 
-    ![View all labs](./media/how-to-use-classroom-lab/connect-button.png)
+    ![View all labs](../media/how-to-use-classroom-lab/connect-button.png)
 2. It takes a few minutes for the virtual machine to be ready.
 
-    ![Getting the virtual machine to be ready](./media/how-to-use-classroom-lab/getting-virtual-machine-ready.png)
+    ![Getting the virtual machine to be ready](../media/how-to-use-classroom-lab/getting-virtual-machine-ready.png)
 3. Save the RDP file to the hard disk and open it. 
 
-    ![Save the RDP file](./media/how-to-use-classroom-lab/save-rdp-file.png)
+    ![Save the RDP file](../media/how-to-use-classroom-lab/save-rdp-file.png)
 4. Use the **user name** and **password** you get from your educator/professor for logging in to the machine. 
 
 ## Stop the virtual machine in a classroom lab
@@ -49,6 +49,6 @@ Select **Stop** on the tile that represents the classroom lab. When the VM is st
 Get started with setting up a lab using Azure Lab Services:
 
 - [Set up a classroom lab](how-to-manage-classroom-labs.md)
-- [Set up a custom lab](tutorial-create-custom-lab.md)
+- [Set up a custom lab](../tutorial-create-custom-lab.md)
 
 

articles/lab-services/tutorial-connect-virtual-machine-classroom-lab.md renamed to articles/lab-services/classroom-labs/tutorial-connect-virtual-machine-classroom-lab.md

@@ -30,7 +30,7 @@ In this tutorial, you do the following actions:
 
 1. Navigate to the registration URL that you received from the professor/educator. 
 
-    ![Create a classroom lab](./media/tutorial-connect-vm-in-classroom-lab/access-labs.png)
+    ![Create a classroom lab](../media/tutorial-connect-vm-in-classroom-lab/access-labs.png)
 2. Sign in to the service using your school account to complete the registration. 
 3. Once registered, confirm that you see the virtual machines for the labs you have access to. 
 

articles/lab-services/tutorial-setup-classroom-lab.md renamed to articles/lab-services/classroom-labs/tutorial-setup-classroom-lab.md

@@ -37,18 +37,18 @@ In this tutorial, you do the following actions:
     4. Specify **default credentials** for logging into virtual machines in the lab. 
     7. Select **Save**.
 
-        ![Create a classroom lab](./media/tutorial-setup-classroom-lab/new-lab-window.png)
+        ![Create a classroom lab](../media/tutorial-setup-classroom-lab/new-lab-window.png)
 1. You see the **home page** for the lab. 
 
-    ![Classroom lab home page](./media/tutorial-setup-classroom-lab/classroom-lab-home-page.png)
+    ![Classroom lab home page](../media/tutorial-setup-classroom-lab/classroom-lab-home-page.png)
 
 ## Configure usage policy
 
 1. Select **Usage policy**. 
 2. In the **Usage policy**, settings, enter the **number of users** allowed to use the lab.
 3. Select **Save**. 
 
-    ![Usage policy](./media/tutorial-setup-classroom-lab/usage-policy-settings.png)
+    ![Usage policy](../media/tutorial-setup-classroom-lab/usage-policy-settings.png)
 
 ## Set up the template 
 A template in a lab is a base virtual machine image from which all users’ virtual machines are created. Set up the template virtual machine so that it is configured with exactly what you want to provide to the lab users. You can provide a name and description of the template that the lab users see. Set the visibility of the template to public to make instances of the template VM available to your lab users. 
@@ -59,7 +59,7 @@ A template in a lab is a base virtual machine image from which all users’ virt
 3. Enter **description** for the template.
 4. Select **Save**.
 
-    ![Classroom lab description](./media/tutorial-setup-classroom-lab/lab-description.png)
+    ![Classroom lab description](../media/tutorial-setup-classroom-lab/lab-description.png)
 
 ### Make instances of the template public
 Once you set the visibility of a template to **public**, Azure Lab Services creates VMs in the lab by using the template. The number of VMs created in this process is same as the maximum number of users allowed into the lab, which you can set in the usage policy of the lab. All virtual machines have the same configuration as the template. 
@@ -71,14 +71,14 @@ Once you set the visibility of a template to **public**, Azure Lab Services crea
     > Once a template is publicly available, its access can't be changed to private. 
 3. Select **Save**.
 
-    ![Availability](./media/tutorial-setup-classroom-lab/public-access.png)
+    ![Availability](../media/tutorial-setup-classroom-lab/public-access.png)
 
 ## Send registration link to students
 
 1. Select **User registration** tile.
 2. In the **User registration** dialog box, select the **Copy** button. The link is copied to the clipboard. Paste it in an email editor, and send an email to the student. 
 
-    ![Student registration link](./media/tutorial-setup-classroom-lab/registration-link.png)
+    ![Student registration link](../media/tutorial-setup-classroom-lab/registration-link.png)
 
 ## Next steps
 In this tutorial, you created a classroom lab, and configured the lab. To learn how a student can access a VM in the lab using the registration link, advance to the next tutorial: