Skip to content

Commit b7136aa

Browse files
author
craigcaseyMSFT
committed
new file with screenshots and updated TOC
1 parent d59b755 commit b7136aa

9 files changed

+114
-1
lines changed

articles/devtest-lab/TOC.md

+1
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,7 @@
3636
### [Create custom image from a VM](devtest-lab-create-custom-image-from-vm-using-portal.md)
3737
### [Create custom image from a VHD using the Azure portal](devtest-lab-create-template.md)
3838
### [Create custom image from a VHD using PowerShell](devtest-lab-create-custom-image-from-vhd-using-powershell.md)
39+
### [Create custom image from a licensed image](devtest-lab-create-custom-image-from-licensed-image.md)
3940
### [Upload VHD file using AzCopy](devtest-lab-upload-vhd-using-azcopy.md)
4041
### [Upload VHD file using PowerShell](devtest-lab-upload-vhd-using-powershell.md)
4142
### [Upload VHD file using Storage Explorer](devtest-lab-upload-vhd-using-storage-explorer.md)

articles/devtest-lab/devtest-lab-add-tag.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,6 @@ The following limitations apply to tags:
6060

6161
[!INCLUDE [devtest-lab-try-it-out](../../includes/devtest-lab-try-it-out.md)]
6262

63-
### Next steps
63+
## Next steps
6464
* You can apply restrictions and conventions across your subscription by using customized policies. A policy that you define might require that all resources have a value for a particular tag. For more information, see [Set policies and schedules](devtest-lab-set-lab-policy.md).
6565
* Explore the [DevTest Labs Azure Resource Manager QuickStart template gallery](https://github.com/Azure/azure-devtestlab/tree/master/Samples).
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
title: Create an Azure DevTest Labs custom image from a licensed image | Microsoft Docs
3+
description: Learn how to create a custom image in Azure DevTest Labs from a licensed image using the Azure portal
4+
services: devtest-lab,virtual-machines
5+
documentationcenter: na
6+
author: tomarcher
7+
manager: douge
8+
editor: ''
9+
10+
ms.assetid: 221390d2-8d3b-4e1f-b454-43d33f8072b7
11+
ms.service: devtest-lab
12+
ms.workload: na
13+
ms.tgt_pltfrm: na
14+
ms.devlang: na
15+
ms.topic: article
16+
ms.date: 09/22/2017
17+
ms.author: tarcher
18+
19+
---
20+
21+
# Create a custom image from a licensed image
22+
23+
[!INCLUDE [devtest-lab-custom-image-definition](../../includes/devtest-lab-custom-image-definition.md)]
24+
25+
A licensed image is one that includes terms and conditions – typically from a third-party – that must be accepted before the image is accessible to users in the lab. The following sections describe how to work with licensed images so that they are available to use for creating virtual machines.
26+
27+
## Determining whether a licensed image is available to users
28+
The first step to allowing users to create custom images from a licensed image is to make sure that the terms and conditions have been accepted for the licensed image. The following steps show how you can view the offer status of a licensed image and, if necessary, accept its terms and conditions.
29+
30+
1. Sign in to the [Azure portal](http://go.microsoft.com/fwlink/p/?LinkID=525040).
31+
32+
1. Select **More services**, and then select **DevTest Labs** from the list.
33+
34+
1. From the list of labs, select the desired lab.
35+
36+
1. In the left panel under **SETTINGS**, select **Configuration and policies**.
37+
38+
1. In the left panel under **VIRTUAL MACHINE BASES**, select **Marketplace images**.
39+
40+
![Marketplace images menu item](./media/devtest-lab-create-custom-image-from-licensed-image/devtest-lab-marketplace-images.png)
41+
42+
A list of all available marketplace images is shown, including the **OFFER STATUS** for each image.
43+
44+
![List of marketplace images showing offer status for each image](./media/devtest-lab-create-custom-image-from-licensed-image/devtest-lab-offer-status.png)
45+
46+
A licensed image shows an offer status of
47+
48+
- **Terms accepted:** the licensed image is available to users to create VMs.
49+
- **Terms review needed:** the licensed image is not currently available to users. The terms and conditions of the license must be accepted before lab users can use it to create VMs.
50+
51+
## Making a licensed image available to lab users
52+
To make sure a licensed image is available to lab users, you must first accept the terms and conditions for that licensed image. Enabling programmatic deployment for the subscription associated with a licensed image automatically accepts the legal terms and privacy statements for that image. [Working with Marketplace Images on Azure Resource Manager](https://azure.microsoft.com/blog/working-with-marketplace-images-on-azure-resource-manager/) provides additional information about programmatic deployment of marketplace images.
53+
54+
You can enable programmatic deployment for a licensed image by following these steps:
55+
56+
1. In the [Azure portal](http://go.microsoft.com/fwlink/p/?LinkID=525040) on the list of **Marketplace images**, identify a licensed image for which you want users to have access but whose terms have not been accepted.
57+
58+
1. In the **OFFER STATUS** column for that image, select **Terms review needed**.
59+
60+
1. In the Configure Programmatic Deployment window, select **Enable**.
61+
62+
![Configure Programmatic Deployment window](./media/devtest-lab-create-custom-image-from-licensed-image/devtest-lab-enable-programmatic-deployment.png)
63+
64+
1. Select **Save**. In the list of marketplace images, that image now shows **Terms accepted** and is available for users to create virtual machines.
65+
66+
## Creating a custom image
67+
68+
Users can create a custom image from a VM built from a licensed image and afterwards use that custom image to create identical VMs by following these steps:
69+
70+
1. Sign in to the [Azure portal](http://go.microsoft.com/fwlink/p/?LinkID=525040).
71+
72+
1. Select **More services**, and then select **DevTest Labs** from the list.
73+
74+
1. From the list of labs, select the desired lab.
75+
76+
1. On the left, select **My virtual machines**.
77+
78+
1. Under **My virtual machines**, select a VM that was created from a licensed image and from which you want to create a custom image. If the VM has not yet been created, you must first [create the VM](devtest-lab-add-vm.md) from the licensed image.
79+
80+
1. Select **Create custom image (VHD)**.
81+
82+
![Create custom image menu item](./media/devtest-lab-create-custom-image-from-licensed-image/devtest-lab-create-custom-image.png)
83+
84+
1. In the **Create custom image** window, enter a name and description for your custom image. This information is displayed in the list of bases when you create a VM.
85+
86+
![Create custom image window](./media/devtest-lab-create-custom-image-from-licensed-image/devtest-lab-create-custom-image-window.png)
87+
88+
1. Select whether deprovision was run on the VM. If the deprovision was not run on the VM, specify whether you want deprovision run when a VM is created from this custom image.
89+
90+
1. Select **OK** when finished to create the custom image.
91+
92+
1. Close the VM's menu window.
93+
94+
1. Select **Configuration and policies****Custom images** and select the custom image you just created.
95+
96+
In the Custom Image Details window, you can see the plan information – name, offer, and publisher – associated with the terms and conditions for this custom image. You can also see that the terms are accepted for this custom image.
97+
98+
![Custom Image Details window showing plan information](./media/devtest-lab-create-custom-image-from-licensed-image/devtest-lab-plan-info.png)
99+
100+
This plan information indicating **Terms accepted** will be passed on to any subsequent VMs created from this custom image.
101+
102+
103+
[!INCLUDE [devtest-lab-try-it-out](../../includes/devtest-lab-try-it-out.md)]
104+
105+
## Related blog posts
106+
107+
- [Custom images or formulas?](https://blogs.msdn.microsoft.com/devtestlab/2016/04/06/custom-images-or-formulas/)
108+
- [Copying Custom Images between Azure DevTest Labs](http://www.visualstudiogeeks.com/blog/DevOps/How-To-Move-CustomImages-VHD-Between-AzureDevTestLabs#copying-custom-images-between-azure-devtest-labs)
109+
110+
## Next steps
111+
112+
- [Add a VM to your lab](./devtest-lab-add-vm-with-artifacts.md)

0 commit comments

Comments
 (0)