Lägga till artefakter till virtuella DevTest Labs-datorer

Den här artikeln beskriver hur du lägger till artefakter i virtuella Azure DevTest Labs-datorer (VM) med hjälp av Azure-portalen eller Azure PowerShell. Artefakter är verktyg, åtgärder eller programvara som du kan lägga till i labbdatorer. Artefakter kan till exempel köra Windows PowerShell-skript eller Bash-kommandon, installera verktyg eller program eller vidta andra åtgärder som att ansluta till en domän.

DevTest Labs-artefakter kan komma från den offentliga DevTest Labs Git-lagringsplatsen eller från privata Git-lagringsplatser. Labbanvändare kan skapa egna anpassade artefakter och lagra dem på en lagringsplats och använda parametrar för att anpassa befintliga artefakter efter sina egna behov.

En labbadministratör kan lägga till artefaktlagringsplatser i ett labb så att alla labbanvändare kan komma åt dem. Labbadministratörer kan också ange obligatoriska artefakter som ska installeras på alla virtuella labbdatorer när de skapas. Labbanvändare kan inte ändra eller ta bort obligatoriska artefakter när den virtuella datorn skapas, men de kan lägga till och konfigurera andra tillgängliga artefakter vid eller efter tiden då den virtuella datorn skapades.

Förutsättningar

Azure Portal

• Användaråtkomst till ett labb i DevTest Labs.

Azure PowerShell

• Användaråtkomst till ett labb i DevTest Labs.
• Azure PowerShell. Du kan antingen:
  • Använd Azure Cloud Shell. Se till att välja PowerShell-miljön .
  • Installera Azure PowerShell för användning på en fysisk eller virtuell dator. Om det behövs kör du Update-Module -Name Az för att uppdatera installationen.

Lägga till artefakter till virtuella datorer

Azure Portal

Du kan använda Azure-portalen för att lägga till artefakter när den virtuella datorn skapas eller för att lägga till artefakter i en befintlig virtuell labbdator.

Lägga till artefakter när den virtuella datorn skapas

1. På labbets startsida väljer du Lägg till.

2. På sidan Välj en bas väljer du den typ av virtuell dator som du vill använda.

3. På skärmen Skapa labbresurs fyller du i fliken Grundläggande inställningar enligt anvisningarna i Skapa virtuella labbdatorer i Azure DevTest Labs.

4. Längst ned på fliken Grundläggande inställningar väljer du Lägg till eller Ta bort artefakter.

5. På sidan Lägg till artefakter väljer du pilen bredvid varje artefakt som du vill lägga till i den virtuella datorn.

6. I varje fönstret Lägg till artefakt anger du obligatoriska och valfria parametervärden och väljer sedan OK. Artefakten visas under Valda artefakter på sidan Lägg till artefakter och antalet konfigurerade artefakter uppdateras.

   

7. Som standard installeras artefakter i den ordning du lägger till dem. Om du vill ordna om ordningen väljer du ellipsen ... bredvid artefakten i listan Markerade artefakter och väljer Flytta upp, Flytta nedåt, Flytta överst eller Flytta till nederkant.

   • Om du vill redigera en artefakts parametrar när du har lagt till den väljer du pennikonen eller väljer ... bredvid artefakten och väljer Redigera för att öppna artefaktfönstret igen.

   • Om du vill ta bort en artefakt från listan Markerade artefakter väljer du ... och sedan Ta bort.

8. När du är klar med att lägga till, ordna och konfigurera artefakter väljer du OK på sidan Lägg till artefakter .

9. Avsnittet Artefakter på resursskärmen Skapa labb visar antalet tillagda artefakter. Om du vill lägga till, redigera, ordna om eller ta bort artefakterna innan du skapar den virtuella datorn väljer du Lägg till eller Ta bort artefakter igen.

10. Du kan också konfigurera avancerade inställningar eller taggar och sedan välja Skapa och skapa igen längst ned på skärmen för att skapa den virtuella datorn med tillagda artefakter.

När du har skapat den virtuella datorn visas de installerade artefakterna på den virtuella datorns artefaktsida . Om du vill se information om varje artefakts installation väljer du artefaktnamnet.

Lägga till artefakter i en befintlig virtuell dator

1. På labbets startsida väljer du den virtuella datorn i listan Mina virtuella datorer .

2. På den virtuella datorn väljer du Artefakter i det översta menyfältet eller under Åtgärder i det vänstra navigeringsfältet.

3. På sidan Artefakter väljer du Tillämpa artefakter.

   

4. På sidan Lägg till artefakter väljer du och konfigurerar artefakter på samma sätt som för en ny virtuell dator.

5. När du är klar med att lägga till artefakter väljer du Installera. Artefakterna installeras omedelbart på den virtuella datorn.

Azure PowerShell

Om det behövs loggar du in på ditt Azure-konto med hjälp av cmdleten Connect-AzAccount . Om du har flera Azure-prenumerationer använder Set-AzContext -SubscriptionId "<SubscriptionId>" och anger du det prenumerations-ID som du vill använda.

Kör följande PowerShell-skript för att tillämpa en artefakt på en virtuell dator med hjälp av cmdleten Invoke-AzResourceAction . Ange den information som skriptet anropar när du uppmanas att göra det.

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 subscription
Set-AzContext -SubscriptionId $SubscriptionId | Out-Null
 
# Get the lab resource group name
$resourceGroupName = (Get-AzResource -ResourceType 'Microsoft.DevTestLab/labs' | Where-Object { $_.Name -eq $DevTestLabName}).ResourceGroupName
if ($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 1

if ($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 1

if ($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 artifact
if ($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"
}

Relaterat innehåll

• Ange obligatoriska artefakter
• Skapa anpassade artefakter
• Lägga till en artefaktlagringsplats i ett labb
• Diagnostisera artefaktfelen