• User access to a lab in DevTest Labs.

• User access to a lab in DevTest Labs.
• Azure PowerShell. You can either:
  • Use Azure Cloud Shell. Be sure to select thePowerShell environment.
  • Install Azure PowerShell to use on a physical or virtual machine. If necessary, runUpdate-Module -Name Az to update your installation.

You can use the Azure portal to add artifacts during VM creation or to add artifacts to an existing lab VM.

Add artifacts during VM creation

1. On the lab's home page, selectAdd.

2. On theChoose a base page, select the type of VM you want.

3. On theCreate lab resource screen, fill out theBasic Settings tab according to the instructions atCreate lab VMs in Azure DevTest Labs.

4. At the bottom of theBasic Settings tab, selectAdd or Remove Artifacts.

5. On theAdd artifacts page, select the arrow next to each artifact you want to add to the VM.

6. On eachAdd artifact pane, enter any required and optional parameter values, and then selectOK. The artifact appears underSelected artifacts on theAdd artifacts page, and the number of configured artifacts updates.

   

7. By default, artifacts install in the order you add them. To rearrange the order, select the ellipsis... next to the artifact in theSelected artifacts list, and selectMove up,Move down,Move to top, orMove to bottom.

   • To edit an artifact's parameters after you add it, select the pencil icon or select... next to the artifact and selectEdit to reopen the artifact pane.

   • To delete an artifact from theSelected artifacts list, select... and then selectDelete.

8. When you're done adding, arranging, and configuring artifacts, selectOK on theAdd artifacts page.

9. TheArtifacts section of theCreate lab resource screen shows the number of artifacts added. To add, edit, rearrange, or delete the artifacts before you create the VM, selectAdd or Remove Artifacts again.

10. Optionally configure anyAdvanced Settings orTags, and then selectCreate andCreate again at the bottom of the screen to create the VM with added artifacts.

After you create the VM, the installed artifacts appear on the VM'sArtifacts page. To see details about each artifact's installation, select the artifact name.

Add artifacts to an existing VM

1. From the lab's home page, select the VM from theMy virtual machines list.

2. On the VM page, selectArtifacts in the top menu bar or underOperations in the left navigation.

3. On theArtifacts page, selectApply artifacts.

   

4. On theAdd artifacts page, select and configure artifacts the same way as for a new VM.

5. When you're done adding artifacts, selectInstall. The artifacts install on the VM immediately.

If necessary, sign in to your Azure account by using theConnect-AzAccount cmdlet. If you have multiple Azure subscriptions, useSet-AzContext -SubscriptionId "<SubscriptionId>" and provide the subscription ID you want to use.

Run the following PowerShell script to apply an artifact to a VM by using theInvoke-AzResourceAction cmdlet. Provide the information the script calls for when prompted.

param ([Parameter(Mandatory=$true, HelpMessage="The ID of the subscription that contains the lab")]   [string] $SubscriptionId,[Parameter(Mandatory=$true, HelpMessage="The name of the lab that has the VM")]   [string] $DevTestLabName,[Parameter(Mandatory=$true, HelpMessage="The name of the VM")]   [string] $VirtualMachineName,[Parameter(Mandatory=$true, HelpMessage="The repository where the artifact is stored")]   [string] $RepositoryName,[Parameter(Mandatory=$true, HelpMessage="The artifact to apply to the VM")]   [string] $ArtifactName,[Parameter(ValueFromRemainingArguments=$true)]   $Params)# Set the appropriate subscriptionSet-AzContext -SubscriptionId $SubscriptionId | Out-Null # Get the lab resource group name$resourceGroupName = (Get-AzResource -ResourceType 'Microsoft.DevTestLab/labs' | Where-Object { $_.Name -eq $DevTestLabName}).ResourceGroupNameif ($resourceGroupName -eq $null) { throw "Unable to find lab $DevTestLabName in subscription $SubscriptionId." }# Get the internal repository name$repository = Get-AzResource -ResourceGroupName $resourceGroupName `                    -ResourceType 'Microsoft.DevTestLab/labs/artifactsources' `                    -ResourceName $DevTestLabName `                    -ApiVersion 2016-05-15 `                    | Where-Object { $RepositoryName -in ($_.Name, $_.Properties.displayName) } `                    | Select-Object -First 1if ($repository -eq $null) { "Unable to find repository $RepositoryName in lab $DevTestLabName." }# Get the internal artifact name$template = Get-AzResource -ResourceGroupName $resourceGroupName `                -ResourceType "Microsoft.DevTestLab/labs/artifactSources/artifacts" `                -ResourceName "$DevTestLabName/$($repository.Name)" `                -ApiVersion 2016-05-15 `                | Where-Object { $ArtifactName -in ($_.Name, $_.Properties.title) } `                | Select-Object -First 1if ($template -eq $null) { throw "Unable to find template $ArtifactName in lab $DevTestLabName." }# Find the VM in Azure$FullVMId = "/subscriptions/$SubscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DevTestLab/labs/$DevTestLabName/virtualmachines/$virtualMachineName"$virtualMachine = Get-AzResource -ResourceId $FullVMId# Generate the artifact id$FullArtifactId = "/subscriptions/$SubscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DevTestLab/labs/$DevTestLabName/artifactSources/$($repository.Name)/artifacts/$($template.Name)"# Handle the input parameters to pass through$artifactParameters = @()# Fill the artifact parameter with the additional -param_ data and strip off the -param_$Params | ForEach-Object {   if ($_ -match '^-param_(.*)') {      $name = $_ -replace '^-param_'   } elseif ( $name ) {      $artifactParameters += @{ "name" = "$name"; "value" = "$_" }      $name = $null #reset name variable   }}# Create a structure to pass the artifact data to the action$prop = @{artifacts = @(    @{        artifactId = $FullArtifactId        parameters = $artifactParameters    }    )}# Apply the artifactif ($virtualMachine -ne $null) {   # Apply the artifact by name to the virtual machine   $status = Invoke-AzResourceAction -Parameters $prop -ResourceId $virtualMachine.ResourceId -Action "applyArtifacts" -ApiVersion 2016-05-15 -Force   if ($status.Status -eq 'Succeeded') {      Write-Output "##[section] Successfully applied artifact: $ArtifactName to $VirtualMachineName"   } else {      Write-Error "##[error]Failed to apply artifact: $ArtifactName to $VirtualMachineName"   }} else {   Write-Error "##[error]$VirtualMachine was not found in the DevTest Lab, unable to apply the artifact"}