Ajouter des artefacts aux machines virtuelles DevTest Labs

• Accès utilisateur à un laboratoire dans DevTest Labs.

• Accès utilisateur à un laboratoire dans DevTest Labs.
• Azure PowerShell. Vous pouvez :
  • Utiliser Azure Cloud Shell. Veillez à sélectionner l’environnement PowerShell .
  • Installez Azure PowerShell pour l’utiliser sur une machine physique ou virtuelle. Si nécessaire, exécutez Update-Module -Name Az pour mettre à jour votre installation.

Vous pouvez utiliser le portail Azure pour ajouter des artefacts lors de la création de la machine virtuelle ou pour ajouter des artefacts à une machine virtuelle lab existante.

Ajouter des artefacts lors de la création d’une machine virtuelle

1. Dans la page d’accueil du labo, sélectionnez Ajouter.

2. Sur la page Choisir une base, sélectionnez le type de machine virtuelle souhaité.

3. Dans l’écran Créer une ressource de laboratoire , renseignez l’onglet Paramètres de base en fonction des instructions fournies dans Créer des machines virtuelles de laboratoire dans Azure DevTest Labs.

4. En bas de l’onglet Paramètres de base , sélectionnez Ajouter ou supprimer des artefacts.

5. Dans la page Ajouter des artefacts, sélectionnez la flèche en regard de chaque artefact à ajouter à la machine virtuelle.

6. Dans chaque volet Ajouter un artefact, entrez les valeurs de paramètre obligatoires et facultatives, puis sélectionnez OK. L’artefact apparaît sous Artefacts sélectionnés sur la page Ajouter des artefacts et le nombre de mises à jour des artefacts configurés.

   

7. Par défaut, les artefacts s’installent dans l’ordre dans lequel vous les ajoutez. Pour réorganiser l'ordre des éléments, sélectionnez les points de suspension ... à côté de l'artefact dans la liste Artefacts sélectionnés, puis sélectionnez Déplacer en haut, Déplacer en bas, Déplacer tout en haut, ou Déplacer tout en bas.

   • Pour modifier les paramètres d’un artefact après l’avoir ajouté, sélectionnez l’icône de crayon ou sélectionnez ... en regard de l’artefact, puis sélectionnez Modifier pour rouvrir le volet d’artefacts.

   • Pour supprimer un artefact de la liste des artefacts sélectionnés , sélectionnez ... puis sélectionnez Supprimer.

8. Lorsque vous avez terminé d’ajouter, d’organiser et de configurer des artefacts, sélectionnez OK dans la page Ajouter des artefacts .

9. La section Artefacts de l’écran Créer une ressource lab affiche le nombre d’artefacts ajoutés. Pour ajouter, modifier, réorganiser ou supprimer les artefacts avant de créer la machine virtuelle, sélectionnez à nouveau Ajouter ou supprimer des artefacts .

10. Configurez éventuellement tous les paramètres avancés ou balises, puis sélectionnez Créer et recréer en bas de l’écran pour créer la machine virtuelle avec des artefacts ajoutés.

Après avoir créé la machine virtuelle, les artefacts installés apparaissent sur la page Artefacts de la machine virtuelle. Pour plus d’informations sur l’installation de chaque artefact, sélectionnez le nom de l’artefact.

Ajouter des artefacts à une machine virtuelle existante

1. Dans la page d’accueil du labo, sélectionnez la machine virtuelle dans la liste Mes machines virtuelles .

2. Dans la page de la machine virtuelle, sélectionnez Artefacts dans la barre de menus supérieure ou sous Opérations dans le volet de navigation gauche.

3. Dans la page Artefacts , sélectionnez Appliquer des artefacts.

   

4. Dans la page Ajouter des artefacts , sélectionnez et configurez les artefacts de la même façon que pour une nouvelle machine virtuelle.

5. Lorsque vous avez terminé d’ajouter des artefacts, sélectionnez Installer. Les artefacts s’installent immédiatement sur la machine virtuelle.

Si nécessaire, connectez-vous à votre compte Azure à l’aide de l’applet de commande Connect-AzAccount . Si vous avez plusieurs abonnements Azure, utilisez Set-AzContext -SubscriptionId "<SubscriptionId>" et fournissez l’ID d’abonnement que vous souhaitez utiliser.

Exécutez le script PowerShell suivant pour appliquer un artefact à une machine virtuelle à l’aide de l’applet de commande Invoke-AzResourceAction . Fournissez les informations demandées par le script lorsque vous y êtes invité.

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