Skip to content

Commit 4e103d7

Browse files
authored
Merge pull request #222180 from RoseHJM/dtl-maint-claim-vm
Content freshness work - DTL
2 parents fc33410 + 4c76397 commit 4e103d7

13 files changed

+34
-26
lines changed

articles/devtest-labs/devtest-lab-add-claimable-vm.md

Lines changed: 34 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -4,33 +4,39 @@ description: Learn how to use the Azure portal to add a claimable virtual machin
44
ms.topic: how-to
55
ms.author: rosemalcolm
66
author: RoseHJM
7-
ms.date: 06/26/2020
7+
ms.date: 12/21/2022
88
---
99

1010
# Create and manage claimable VMs in Azure DevTest Labs
11-
You add a claimable VM to a lab in a similar manner to how you [add a standard VM](devtest-lab-add-vm.md) – from a *base* that is either a [custom image](devtest-lab-create-template.md), [formula](devtest-lab-manage-formulas.md), or [Marketplace image](devtest-lab-configure-marketplace-images.md). This tutorial walks you through using the Azure portal to add a claimable VM to a lab in DevTest Labs, and shows the processes a user follows to claim and unclaim the VM.
11+
You add a claimable VM to a lab in a similar manner to how you [add a standard VM](devtest-lab-add-claimable-vm.md) – from a *base* that is either a [custom image](devtest-lab-create-template.md), [formula](devtest-lab-manage-formulas.md), or [Marketplace image](devtest-lab-configure-marketplace-images.md). This tutorial walks you through using the Azure portal to add a claimable VM to a lab in DevTest Labs, and shows the processes a user follows to claim and unclaim the VM.
1212

1313
## Steps to add a claimable VM to a lab in Azure DevTest Labs
1414
1. Sign in to the [Azure portal](https://go.microsoft.com/fwlink/p/?LinkID=525040).
15-
1. Select **All Services**, and then select **DevTest Labs** in the **DEVOPS** section. If you select * (star) next to **DevTest Labs** in the **DEVOPS** section. This action adds **DevTest Labs** to the left navigational menu so that you can access it easily the next time. Then, you can select **DevTest Labs** on the left navigational menu.
15+
1. Select **All Services** and then in the **DEVOPS** section, select **DevTest Labs**. If you select * (star) next to **DevTest Labs** in the **DEVOPS** section. This action adds **DevTest Labs** to the left navigational menu so that you can access it easily the next time. Then, you can select **DevTest Labs** on the left navigational menu.
16+
17+
:::image type="content" source="media/devtest-lab-add-claimable-vm/all-services-select.png" alt-text="Screenshot showing All services - select DevTest Labs.":::
1618

17-
![Screenshot that shows All services - select DevTest Labs.](./media/devtest-lab-create-lab/all-services-select.png)
1819
1. From the list of labs, select the lab in which you want to create the VM.
19-
2. On the lab's **Overview** page, select **+ Add**.
20+
1. On the lab's **Overview** page, select **+ Add**.
21+
22+
:::image type="content" source="media/devtest-lab-add-claimable-vm/devtestlab-home-blade-add-vm.png" alt-text="Screenshot showing the Add VM button.":::
2023

21-
![Screenshot that shows the Add VM button.](./media/devtest-lab-add-vm/devtestlab-home-blade-add-vm.png)
2224
1. On the **Choose a base** page, select a marketplace image for the VM.
2325
1. On the **Basic Settings** tab of the **Virtual machine** page, do the following actions:
2426
1. Enter a name for the VM in the **Virtual machine name** text box. The text box is pre-filled for you with a unique autogenerated name. The name corresponds to the user name within your email address followed by a unique three-digit number. This feature saves you the time to think of a machine name and type it every time you create a machine. You can override this autofilled field with a name of your choice if you wish to. To override the autofilled name for the VM, enter a name in the **Virtual machine name** text box.
2527
2. Enter a **User Name** that is granted administrator privileges on the virtual machine. The **user name** for the machine is pre-filled with a unique autogenerated name. The name corresponds to the user name within your email address. This feature saves you the time to decide on a username every time you create a new machine. Again, you can override this autofilled field with a username of your choice if you wish to. To override the autofilled value for user name, enter a value in the **User Name** text box. This user is granted **administrator** privileges on the virtual machine.
26-
3. If you are creating first VM in the lab, enter a **password** for the user. To save this password as a default password in the Azure key vault associated with the lab, select **Save as default password**. The default password is saved in the key vault with the name: **VmPassword**. When you try to create subsequent VMs in the lab, **VmPassword** is automatically selected for the **password**. To override the value, clear the **Use a saved secret** check box, and enter a password.
28+
3. If you're creating first VM in the lab, enter a **password** for the user. To save this password as a default password in the Azure key vault associated with the lab, select **Save as default password**. The default password is saved in the key vault with the name: **VmPassword**. When you try to create subsequent VMs in the lab, **VmPassword** is automatically selected for the **password**. To override the value, clear the **Use a saved secret** check box, and enter a password.
2729

2830
You can also save secrets in the key vault first and then use it while creating a VM in the lab. For more information, see [Store secrets in a key vault](devtest-lab-store-secrets-in-key-vault.md). To use the password stored in the key vault, select **Use a saved secret**, and specify a key value that corresponds to your secret (password).
2931
4. In the **More options** section, select **Change size**. Select one of the predefined items that specify the processor cores, RAM size, and the hard drive size of the VM to create.
30-
5. Select **Add or Remove Artifacts**. Select and configure the artifacts that you want to add to the base image.
32+
1. Select the **OS disk type**.
33+
- Premium SSD disks offer high-performance, low-latency disk support for I/O-intensive applications and production workloads.
34+
- Standard SSD Disks are a cost effective storage option optimized for workloads that need consistent performance at lower IOPS levels.
35+
- Use Standard HDD disks for Dev/Test scenarios and less critical workloads at lowest cost.
36+
1. Select **Add or Remove Artifacts**. Select and configure the artifacts that you want to add to the base image.
3137

3238
>[!NOTE]
33-
>If you're new to DevTest Labs or configuring artifacts, refer to the [Add artifacts after installation](./devtest-lab-add-vm.md#add-artifacts-after-installation) section, and then return here when finished.
39+
>If you're new to DevTest Labs or configuring artifacts, refer to [Add artifacts to DevTest Labs VMs](./add-artifact-vm.md), and then return here when finished.
3440
2. Switch to the **Advanced Settings** tab at the top, and do the following actions:
3541
1. To change the virtual network that the VM is in, select **Change VNet**.
3642
2. To change the subnet, select **Change subnet**.
@@ -48,43 +54,45 @@ You add a claimable VM to a lab in a similar manner to how you [add a standard V
4854

4955
## Use a claimable VM
5056

51-
A user can claim any VM from the list of **"**Claimable virtual machines** by doing one of these steps:
52-
53-
* From the list of **Claimable virtual machines** at the bottom of the lab's **Overview** pane, right-click on one of the VMs in the list and choose **Claim machine**.
57+
A user can claim any VM from the list of **Claimable virtual machines** by using one of these options:
5458

55-
![Screenshot that shows requesting a specific claimable VM.](./media/devtest-lab-add-vm/devtestlab-claim-VM.png)
59+
### Claim a specific VM
60+
1. On the lab's **Overview** page, on the left menu, select **Claimable virtual machines**.
61+
1. Right-click the VM you want to claim, and then select **Claim machine**.
5662

63+
:::image type="content" source="media/devtest-lab-add-claimable-vm/devtestlab-claim-virtual-machine.png" alt-text="Screenshot showing requesting a specific claimable VM.":::
5764

58-
* At the top of the **Overview** pane, choose **Claim any**. A random virtual machine is assigned from the list of claimable VMs.
65+
### Claim any available VM
66+
On the lab's **Overview** page, select **Claim any**. A random virtual machine is assigned from the list of claimable VMs.
5967

60-
![Screenshot that shows requesting any claimable VM.](./media/devtest-lab-add-vm/devtestlab-claim-any.png)
68+
:::image type="content" source="media/devtest-lab-add-claimable-vm/devtestlab-claim-any.png" alt-text="Screenshot showing requesting any claimable VM.":::
6169

62-
63-
After a user claims a VM, DevTest Labs will start the machine and move it up into lab user's list of **My virtual machines**. This means the lab user will now have owner privileges on this machine. The time required for this step may vary depending on startup times and any other custom actions being performed during the claim event. Once claimed, the machine is no longer available in the claimable pool.
70+
After a user claims a VM, DevTest Labs will start the machine and move it up into lab user's list of **My virtual machines**. The lab user will now have owner privileges on this machine. The time required for this step may vary depending on startup times and any other custom actions being performed during the claim event. Once claimed, the machine is no longer available in the claimable pool.
6471

6572
## Unclaim a VM
6673

67-
When a user is finished using a claimed VM and wants to make it available to someone else, they can return the claimed VM to the list of claimable virtual machines by doing one of these steps:
74+
When a user is finished using a claimed VM and wants to make it available for someone else, they can return the claimed VM to the list of claimable virtual machines by using one of these options:
6875

69-
- From the list of **My virtual machines**, right-click on one of the VMs in the list, or select its ellipsis **...**, and choose **Unclaim**.
76+
### Unclaim a VM from a list of VMs
77+
From the list of **My virtual machines**, right-click on one of the VMs in the list, or select its ellipsis **...**, and choose **Unclaim**.
7078

71-
![Screenshot that shows unclaiming a VM on the list.](./media/devtest-lab-add-vm/devtestlab-unclaim-VM2.png)
79+
:::image type="content" source="media/devtest-lab-add-claimable-vm/devtestlab-unclaim-virtual-machine-2.png" alt-text="Screenshot showing unclaiming a VM on the list.":::
7280

73-
- In the list of **My virtual machines**, select a VM to open its management pane, then select **Unclaim** from the top menu bar.
81+
### Unclaim a VM from its management pane
82+
In the list of **My virtual machines**, select a VM to open its management pane, then select **Unclaim** from the top menu bar.
7483

75-
![Screenshot that shows unclaiming a VM on the VM's management pane.](./media/devtest-lab-add-vm/devtestlab-unclaim-VM.png)
84+
:::image type="content" source="media/devtest-lab-add-claimable-vm/devtestlab-unclaim-virtual-machine.png" alt-text="Screenshot showing unclaiming a VM on the VM's management pane.":::
7685

77-
When a user unclaims a VM, they no longer have owner permissions for that specific lab VM and it is available to be claimed by any other lab user in the state that it was returned to the pool.
86+
When a user unclaims a VM, they no longer have owner permissions for that specific lab VM, and it's available to be claimed by any other lab user in the state that it was returned to the pool.
7887

7988
### Transfer the data disk
8089
If a claimable VM has a data disk attached to it and a user unclaims it, the data disk stays with the VM. When another user then claims that VM, that new user claims the data disk and the VM.
8190

8291
This action is called transferring the data disk. The data disk then becomes available in the new user's list of **My data disks** for them to manage.
8392

84-
![Screenshot that shows unclaiming data disks.](./media/devtest-lab-add-vm/devtestlab-unclaim-datadisks.png)
85-
93+
:::image type="content" source="media/devtest-lab-add-claimable-vm/devtestlab-unclaim-datadisks.png" alt-text="Screenshot showing unclaiming data disks.":::
8694

8795

8896
## Next steps
89-
* Once it is created, you can connect to the VM by selecting **Connect** on its management pane.
97+
* Once it's created, you can connect to the VM by selecting **Connect** on its management pane.
9098
* Explore the [DevTest Labs Azure Resource Manager quickStart template gallery](https://github.com/Azure/azure-devtestlab/tree/master/samples/DevTestLabs/QuickStartTemplates).
119 KB
Loading
68.9 KB
Loading
60.4 KB
Loading
21.9 KB
Loading
27.5 KB
Loading
73.4 KB
Loading
Binary file not shown.
Binary file not shown.

0 commit comments

Comments
 (0)