README.md

Create DevTest Labs from a storage of custom images

The main script takes as input a csv file for creating multiple DevTest Labs from an Azure Blob storage containing VHDs and json descriptors. The script creates the labs, add the VHDs as custom images and creates one claimable VM for each custom image.

Additionally you can set owners and users for such labs together with additional data like shutdown time, region and such. The users added to the lab have no permissions to create new VMs, so that the content of the lab is fixed.

The script creates the labs in paralllel with a new powershell job.

The script runs slowlly on my machines (~2.30hr). It is recommended to execute it from inside an Azure VM to minimize network delays. If the DevTest Labs team implements creating custom images from a storage location without copying them to the lab storage account first, then the script can be made substantially faster.

The main scripts (in order of logical exectution)

• New-CustomRole.ps1 adds a custom role to the subcription which doesn't have permissions to create new VMs.
• New-EmptyLabs.ps1, reads a csv file (exemple here) and creates empty DTL Labs ready to be filled with VMs later on.
• Set-VmFromVhds.ps1, this is the main way to fill a lab with VMs. You can pass a series of patterns that match image names to create and specify what to do in case there are already existing VMs in the lab with the same name. It performs:
  • Gets the json descriptors for the VMs and select the ones matching the patterns
  • Copy VHDs from blob storage to DTL lab storage
  • Creates Custom Images from the VHDs
  • Creates one VM for each custom image
  • Creates the network topology described in the json descriptors
  • Deletes the custom images from the lab
• RemoveVmsInLab.ps1, removes all VMs in each lab matching certain patterns in the Notes field (shouldn't it be name?)

Ancillary scripts

The repo also contains scripts which might have value on their own to build slightly different solutions. Most of them perform a single operation, instead of a chain of operations (often in parallel). Refer to the code for full description.

Utility scripts

• Login-AzSub.ps1 log into Azure with a specific subId.
• Get-NAgoCommandTime.ps1 gives the execution time for the command executed N commands ago (default last command).
• Remove-Labs.ps1 removes all the labs described in the configuration csv file.
• Remove-Lab.ps1 removes one specific lab.
• Remove-Deployments.ps1 removes all deployments in a resource group starting N days ago.