Добавление артефактов в виртуальные машины DevTest Labs

• Доступ пользователей к лаборатории в DevTest Labs.

• Доступ пользователей к лаборатории в DevTest Labs.
• Azure PowerShell. Вы можете либо:
  • использовать Azure Cloud Shell. Обязательно выберите среду PowerShell .
  • Установите Azure PowerShell для использования на физической или виртуальной машине. При необходимости запустите Update-Module -Name Az, чтобы обновить установку.

Портал Azure можно использовать для добавления артефактов во время создания виртуальной машины или добавления артефактов в существующую виртуальную машину лаборатории.

Добавление артефактов во время создания виртуальной машины

1. На домашней странице лаборатории нажмите кнопку "Добавить".

2. На странице Выбор базы данных выберите тип виртуальной машины.

3. На экране "Создание лаборатории" заполните вкладку "Основные параметры " в соответствии с инструкциями по созданию виртуальных машин лаборатории в Azure DevTest Labs.

4. В нижней части вкладки "Основные параметры" выберите "Добавить" или "Удалить артефакты".

5. На странице Добавление артефактов щелкните стрелку рядом с каждым артефактом, который необходимо добавить в виртуальную машину.

6. На каждой панели Добавить артефакт введите необходимые и дополнительные значения параметров, а затем нажмите кнопку OK. Артефакт отображается в разделе "Выбранные артефакты " на странице "Добавление артефактов " и количество настроенных обновлений артефактов.

   

7. По умолчанию артефакты устанавливаются в порядке их добавления. Чтобы изменить порядок, выберите многоточие ... рядом с артефактом в списке выбранных артефактов и выберите "Переместить вверх", "Переместить вниз", "Переместить в начало" или "Переместить в конец".

   • Чтобы изменить параметры артефакта после его добавления, щелкните значок карандаша или выберите ... рядом с артефактом и нажмите кнопку "Изменить ", чтобы открыть область артефакта.

   • Чтобы удалить артефакт из списка выбранных артефактов , выберите ... , а затем нажмите кнопку "Удалить".

8. После добавления, упорядочения и настройки артефактов нажмите кнопку "ОК " на странице "Добавление артефактов ".

9. В разделе "Артефакты" на экране "Создание лаборатории " отображается количество добавленных артефактов. Чтобы добавить, изменить порядок, отредактировать или удалить артефакты перед созданием виртуальной машины, выберите пункт Добавить или удалить артефакты снова.

10. При необходимости настройте дополнительные параметры или теги, а затем нажмите кнопку "Создать и создать " в нижней части экрана, чтобы создать виртуальную машину с добавленными артефактами.

После создания виртуальной машины установленные артефакты отображаются на странице артефактов виртуальной машины. Чтобы просмотреть сведения о установке каждого артефакта, выберите имя артефакта.

Добавление артефактов в существующую виртуальную машину

1. На домашней странице лаборатории выберите виртуальную машину из списка "Мои виртуальные машины ".

2. На странице виртуальной машины выберите артефакты в верхней строке меню или в разделе "Операции " в области навигации слева.

3. На странице "Артефакты" выберите "Применить артефакты".

   

4. На странице "Добавление артефактов" выберите и настройте артефакты так же, как и для новой виртуальной машины.

5. После добавления артефактов нажмите кнопку "Установить". Немедленно устанавливаются объекты на виртуальной машине.

При необходимости войдите в учетную запись Azure с помощью командлета Connect-AzAccount . Если у вас несколько подписок Azure, используйте Set-AzContext -SubscriptionId "<SubscriptionId>" и укажите идентификатор подписки, который вы хотите использовать.

Выполните следующий скрипт PowerShell, чтобы применить артефакт к виртуальной машине с помощью командлета Invoke-AzResourceAction . Предоставьте информацию, требуемую скриптом, когда будет показан соответствующий запрос.

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