Artefacten toevoegen aan DevTest Labs-VM's

• Gebruikerstoegang tot een lab in DevTest Labs.

• Gebruikerstoegang tot een lab in DevTest Labs.
• Azure PowerShell. U kunt het volgende doen:
  • Gebruik Azure Cloud Shell. Zorg ervoor dat u de PowerShell-omgeving selecteert.
  • Installeer Azure PowerShell voor gebruik op een fysieke of virtuele machine. Indien nodig Update-Module -Name Az uitvoeren om je installatie bij te werken.

U kunt Azure Portal gebruiken om artefacten toe te voegen tijdens het maken van een VIRTUELE machine of om artefacten toe te voegen aan een bestaande lab-VM.

Artefacten toevoegen tijdens het maken van de VIRTUELE machine

1. Selecteer Toevoegen op de startpagina van het lab.

2. Kies op de Kies een basis pagina het type virtuele-machine dat je wilt.

3. Vul in het scherm Labresource maken het tabblad Basisinstellingen in volgens de instructies in Het maken van lab-VM's in Azure DevTest Labs.

4. Selecteer onder aan het tabblad Basisinstellingen de optie Artefacten toevoegen of verwijderen.

5. Selecteer op de pagina Artefacten toevoegen de pijl naast elk artefact dat u wilt toevoegen aan de virtuele machine.

6. Voer in elk deelvenster Artefact toevoegen alle vereiste en optionele parameterwaarden in en selecteer OK. Het artefact wordt weergegeven onder Geselecteerde artefacten op de pagina Artefacten toevoegen en het aantal geconfigureerde artefacten wordt bijgewerkt.

   

7. Artefacten worden standaard geïnstalleerd in de volgorde waarin u ze toevoegt. Als u de volgorde wilt wijzigen, selecteert u het beletselteken ... naast het artefact in de lijst Geselecteerde artefacten en selecteert u Omhoog, Omlaag,Naar boven gaan of Naar beneden verplaatsen.

   • Als u de parameters van een artefact wilt bewerken nadat u het hebt toegevoegd, selecteert u het potloodpictogram of selecteert u ... naast het artefact en selecteert u Bewerken om het artefactvenster opnieuw te openen.

   • Als u een artefact uit de lijst met geselecteerde artefacten wilt verwijderen, selecteert u ... en selecteert u Vervolgens Verwijderen.

8. Wanneer u klaar bent met het toevoegen, rangschikken en configureren van artefacten, selecteert u OK op de pagina Artefacten toevoegen .

9. In de sectie Artefacten van het scherm Labresource maken ziet u het aantal toegevoegde artefacten. Als u de artefacten wilt toevoegen, bewerken, opnieuw rangschikken of verwijderen voordat u de virtuele machine maakt, selecteert u Artefacten toevoegen of verwijderen .

10. Configureer eventueel geavanceerde instellingen of tags en selecteer vervolgens Maken en opnieuw maken onder aan het scherm om de virtuele machine te maken met toegevoegde artefacten.

Nadat u de VIRTUELE machine hebt gemaakt, worden de geïnstalleerde artefacten weergegeven op de pagina Artefacten van de VIRTUELE machine. Als u details over de installatie van elk artefact wilt bekijken, selecteert u de naam van het artefact.

Artefacten toevoegen aan een bestaande VM

1. Selecteer op de startpagina van het lab de virtuele machine in de lijst Mijn virtuele machines .

2. Selecteer op de vm-pagina Artefacten in de bovenste menubalk of onder Bewerkingen in het linkernavigatievenster.

3. Selecteer Artefacten toepassen op de pagina Artefacten.

   

4. Selecteer en configureer artefacten op de pagina Artefacten toevoegen op dezelfde manier als voor een nieuwe VIRTUELE machine.

5. Wanneer u klaar bent met het toevoegen van artefacten, selecteert u Installeren. De artefacten worden onmiddellijk op de VIRTUELE machine geïnstalleerd.

Meld u indien nodig aan bij uw Azure-account met behulp van de cmdlet Connect-AzAccount . Als u meerdere Azure-abonnementen hebt, gebruik Set-AzContext -SubscriptionId "<SubscriptionId>" en geef de abonnements-id op die u wilt gebruiken.

Voer het volgende PowerShell-script uit om een artefact toe te passen op een virtuele machine met behulp van de cmdlet Invoke-AzResourceAction . Geef de informatie op waarvoor het script wordt aanroepen wanneer hierom wordt gevraagd.

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"
}