Erstellen eines Labs in Azure Lab Services mit PowerShell und dem Azure-Modul

In diesem Artikel erfahren Sie, wie Sie ein Lab mit PowerShell und den Azure-Modulen erstellen. Das Lab verwendet die Einstellungen aus einem zuvor erstellten Labplan. Eine ausführliche Übersicht über Azure Lab Services finden Sie unter Einführung in Azure Lab Services.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

• Ein Azure-Konto mit der Berechtigung, ein Lab zu verwalten, wie z. B. die Azure RBAC-Rolle Lab Creator, Besitzer, Mitwirkender oder Lab-Dienst-Mitwirkender. Erfahren Sie mehr über die integrierten Azure Lab Services-Rollen und Zuweisungsbereiche.

• Ein Azure-Labplan. Wenn Sie noch keinen Labplan haben, führen Sie die Schritte unter Schnellstart: Einrichten von Ressourcen zum Erstellen von Labs aus.

• Windows PowerShell.

• PowerShell-Modul „Azure Az“. Mindestens Version 7.2

  Install-Module 'Az'
  

• PowerShell-Modul „Az.LabServices“

  Install-Module 'Az.LabServices'
  

• Labplan. Informationen zum Erstellen eines Labplans finden Sie unter Erstellen eines Labplans mit PowerShell und den Azure-Modulen.

Führen Sie Connect-AzAccount aus, um sich bei Azure anzumelden und zu überprüfen, ob ein aktives Abonnement vorhanden ist.

Erstellen eines Labs

Bevor Sie ein Lab erstellen können, benötigen Sie die Labplanressource. Unter Erstellen eines Labplans mit PowerShell erfahren Sie, wie Sie einen Labplan namens ContosoLabPlan in einer Ressourcengruppe namens MyResourceGroup erstellen.

$plan = Get-AzLabServicesLabPlan `
    -Name "ContosoLabPlan" `
    -ResourceGroupName "MyResourceGroupName"

Außerdem müssen wir ein Basisimage für die Lab-VMs aus den verfügbaren Images für den Labplan auswählen. Sehen wir uns an, was verfügbar ist.

$plan | Get-AzLabServicesPlanImage | Where-Object { $_.EnabledState.ToString() -eq "enabled" }

Wir wählen das Windows 11-Image aus.

$image = $plan | Get-AzLabServicesPlanImage | Where-Object { $_.EnabledState.ToString() -eq "enabled" -and $_.DisplayName -eq "Windows 11 Pro (Gen2)" }

Wenn Sie ein Lab mithilfe von PowerShell erstellen, müssen Sie auch Informationen zur Ressourcen-SKU bereitstellen. Der folgende Befehl verwendet die REST-API, um die Liste der SKUs abzurufen, und wählt die SKU Classic_Fsv2_4_8GB_128_S_SSD aus:

$subscriptionId = (Get-AzContext).Subscription.ID
$skus = (Invoke-AzRestMethod -Uri https://management.azure.com/subscriptions/$subscriptionId/providers/Microsoft.LabServices/skus?api-version=2022-08-01 | Select-Object -Property "Content" -ExpandProperty Content | ConvertFrom-Json).value
$sku = $skus | Where-Object -Property "name" -eq "Classic_Fsv2_4_8GB_128_S_SSD" | select-object -First 1

Wir sind nun bereit, ein Lab basierend auf unserem Labplan mit dem Window 11 Pro-Image und der Ressourcen-SKU Classic_Fsv2_4_8GB_128_S_SSD zu erstellen. Der folgende Befehl erstellt ein Lab mithilfe des oben erstellten Labplans.

# $plan and $image are from the Create LabPlan QuickStart.
$password = "<custom password>"

$lab = New-AzLabServicesLab -Name "ContosoLab" `
    -ResourceGroupName "MyResourceGroup" `
    -Location "westus" `
    -LabPlanId $plan.Id `
    -AdminUserPassword (ConvertTo-SecureString $password -AsPlainText -Force) `
    -AdminUserUsername "adminUser" `
    `
    -AutoShutdownProfileShutdownOnDisconnect Enabled `
    -AutoShutdownProfileDisconnectDelay $(New-Timespan) `
    -AutoShutdownProfileShutdownOnIdle "LowUsage" `
    -AutoShutdownProfileIdleDelay $(New-TimeSpan -Minutes 15) `
    -AutoShutdownProfileShutdownWhenNotConnected Disabled `
    -AutoShutdownProfileNoConnectDelay $(New-TimeSpan -Minutes 15) `
    `
    -ConnectionProfileClientRdpAccess Public `
    -ConnectionProfileClientSshAccess None `
    -ConnectionProfileWebRdpAccess None `
    -ConnectionProfileWebSshAccess None `
    -SecurityProfileOpenAccess Disabled `
    `
    -ImageReferenceOffer $image.Offer `
    -ImageReferencePublisher $image.Publisher `
    -ImageReferenceSku $image.Sku `
    -ImageReferenceVersion $image.Version `
    -SkuCapacity 1 `
    -SkuName $sku.size `
    `
    -Title "Contoso Lab" `
    -Description "The Contoso lab" `
    -AdditionalCapabilityInstallGpuDriver Disabled `
    -VirtualMachineProfileCreateOption "TemplateVM" `
    -VirtualMachineProfileUseSharedPassword Enabled

Bereinigen von Ressourcen

Falls Sie diese Anwendung nicht mehr benötigen, löschen Sie den Plan und das Lab wie folgt:

$lab | Remove-AzLabServicesLab

Weitere Informationen

Als Administrator können Sie sich ausführlicher über das Azure PowerShell-Modul und Az.LabServices-Cmdlets informieren.