Tutorial: Access a lab VM from Teams or Canvas

In this tutorial, you learn how to access a lab virtual machine by using the Azure Lab Services app in Teams or Canvas. After you start the lab VM, you can then remotely connect to the lab VM by using secure shell (SSH).

Diagram that shows the steps involved in registering and accessing a lab from the Azure Lab Services website.

  • Access the lab in Teams or Canvas
  • Start the lab VM
  • Connect to the lab VM


Access a lab

When you access a lab in Microsoft Teams, you're automatically registered for the lab, based on your team membership in Microsoft Teams.

To access your lab in Teams:

  1. Sign into Microsoft Teams with your organizational account.

  2. Select the team and channel that contain the lab.

  3. Select the Azure Lab Services tab to view your lab virtual machines.

    Screenshot of lab in Teams after it's published.

    You might see a message that the lab isn't available. This error can occur when the lab isn't published yet by the lab creator, or if the Teams membership information still needs to synchronize.

Start the lab VM

You can start a lab virtual machine from the My virtual machines page. If the lab creator configured a lab schedule, the lab VM is automatically started and stopped during the scheduled hours.

To start the lab VM:

  1. Go to the My virtual machines page in Teams or Canvas.

  2. Use the toggle control next to the lab VM status to start the lab VM.

    When the VM is in progress of starting, the control is inactive. Starting the lab VM might take some time to complete.

    Screenshot of My virtual machines page for Azure Lab Services, highlighting the status toggle and status label on the VM tile.

  3. After the operation finishes, confirm that the lab VM status is Running.

    Screenshot of My virtual machines page for Azure Lab Services, highlighting the status label on the VM tile.

Connect to the lab VM

When the lab virtual machine is running, you can remotely connect to the VM. Depending on the lab VM operating system configuration, you can connect by using remote desktop (RDP) or secure shell (SSH).

If there are no quota hours available, you're can't start the lab VM outside the scheduled lab hours and can't connect to the lab VM.

Learn more about how to connect to a lab VM.

Next steps