Adicionar artefatos a VMs do DevTest Labs

• Acesso do usuário a um laboratório no DevTest Labs.

• Acesso do usuário a um laboratório no DevTest Labs.
• Azure PowerShell. Pode escolher entre:
  • Use Azure Cloud Shell. Certifique-se de selecionar o ambiente do PowerShell .
  • Instale o Azure PowerShell para usar em uma máquina física ou virtual. Se necessário, execute Update-Module -Name Az para atualizar a instalação.

Você pode usar o portal do Azure para adicionar artefatos durante a criação da VM ou para adicionar artefatos a uma VM de laboratório existente.

Adicionar artefatos durante a criação da VM

1. Na página inicial do laboratório, selecione Adicionar.

2. Na página Escolha uma base, selecione o tipo de VM desejado.

3. Na tela Criar recurso de laboratório , preencha a guia Configurações básicas de acordo com as instruções em Criar VMs de laboratório no Azure DevTest Labs.

4. Na parte inferior da guia Configurações básicas , selecione Adicionar ou remover artefatos.

5. Na página Adicionar artefatos, selecione a seta ao lado de cada artefato que você deseja adicionar à VM.

6. Em cada painel Adicionar artefato, insira quaisquer valores de parâmetro obrigatórios e opcionais e selecione OK. O artefato aparece em Artefatos selecionados na página Adicionar artefatos e o número de atualizações de artefatos configurados.

   

7. Por padrão, os artefatos são instalados na ordem em que são adicionados. Para reorganizar a ordem, selecione as reticências ... ao lado do artefato na lista Artefatos selecionados e selecione Mover para cima, Mover para baixo, Mover para o topo ou Mover para o fundo.

   • Para editar os parâmetros de um artefato depois de adicioná-lo, selecione o ícone de lápis ou selecione ... ao lado do artefato e selecione Editar para reabrir o painel de artefatos.

   • Para excluir um artefato da lista Artefatos selecionados , selecione ... e, em seguida, selecione Excluir.

8. Quando terminar de adicionar, organizar e configurar artefatos, selecione OK na página Adicionar artefatos .

9. A seção Artefatos da tela Criar recurso de laboratório mostra o número de artefatos adicionados. Para adicionar, editar, reorganizar ou excluir os artefatos antes de criar a VM, selecione Adicionar ou Remover Artefatos novamente.

10. Opcionalmente, configure quaisquer Configurações Avançadas ou Tags e selecione Criar e Criar novamente na parte inferior da tela para criar a VM com artefatos adicionados.

Depois de criar a VM, os artefatos instalados aparecem na página Artefatos da VM. Para ver detalhes sobre a instalação de cada artefato, selecione o nome do artefato.

Adicionar artefatos a uma VM existente

1. Na página inicial do laboratório, selecione a VM na lista Minhas máquinas virtuais .

2. Na página VM, selecione Artefatos na barra de menu superior ou em Operações na navegação à esquerda.

3. Na página Artefatos , selecione Aplicar artefatos.

   

4. Na página Adicionar artefatos , selecione e configure artefatos da mesma forma que para uma nova VM.

5. Quando terminar de adicionar artefatos, selecione Instalar. Os artefatos são instalados na VM imediatamente.

Se necessário, entre na sua conta do Azure usando o cmdlet Connect-AzAccount . Se tiver várias subscrições do Azure, utilize Set-AzContext -SubscriptionId "<SubscriptionId>" e forneça o ID de subscrição que pretende utilizar.

Execute o seguinte script do PowerShell para aplicar um artefato a uma VM usando o cmdlet Invoke-AzResourceAction . Forneça as informações que o script solicita quando solicitado.

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